NAME
lastfmsubmitd, lastfmsubmit - Last.fm submission daemon and helper
SYNOPSIS
lastfmsubmitd [--debug] [--no-daemon] [--no-network] [--help]
lastfmsubmit [--encoding ENC] [--artist ARTIST] [--title TITLE]
[--length LEN] [--time STAMP] [--album ALBUM] [--mbid TRACKID]
[--stdout] [--debug] [--quiet] [--help]
DESCRIPTION
lastfmsubmitd uses the Last.fm protocol to send information about
played songs to a submission server. If network connectivity is lost or
lastfmsubmitd is shut down, any unsubmitted songs will be saved to
disk.
Song information is collected from one or more music players via a
spool directory. All songs are submitted with the account information
provided in the configuration file.
lastfmsubmit is a helper program meant to be invoked by music players.
It handles setting the timestamp, encoding data as UTF-8, serializing
it to send to lastfmsubmitd, and locking.
OPTIONS
-d, --debug
Log debugging information.
-n, --no-daemon
Do not fork into the background.
-n, --no-network
Do not attempt to connect to a server, but process submissions
anyway.
-e, --encoding
Use a different encoding than the locale’s default to read song
information.
-q, --quiet
Silence any logging information that would normally be printed
to stderr.
-a, --artist
Specify the song’s artist name. Artist, title, and length are
required for lastfmsubmitd to actually submit the song.
-t, --title
Specify the song’s title.
-l, --length
Specify the song’s length.
-i, --time
Specify the time at which the song was played, formatted in UTC
as ’%Y-%m-%d %H:%M:%S’ (see strptime(3)). If not given, defaults
to the current time.
-b, --album
Specify the song’s album name.
-m, --mbid
Specify the song’s MusicBrainz track ID.
-o, --stdout
Write the serialized song information to standard output instead
of the spool.
FILES
/var/spool/lastfm
The directory where music players should write song information
to be submitted by lastfmsubmitd.
/etc/lastfmsubmitd.conf
The configuration file.
AUTHOR
Decklin Foster <decklin@red-bean.com>.
lastfm(1)