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 <[email protected]>.