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