offline-scrobbler is a utility to scrobble music to Last.fm without playing it online. If you have played a favourite album on your stereo system or a very secure media player without scrobbling capabilities, offline-scrobbler allows you to scrobble it later.
cargo install offline-scrobbler
- Navigate to Last.fm Create API account page
- Fill out the fields "Contact e-mail" and "Application name" to whatever you like. Other fields should be empty". Click "Submit".
- Grab "API Key" and "Shared secret" from the resulting page. You need them to set up the scrobbler once.
Set up the scrobbler with the following command, replacing API_KEY with the API key from the previous step and SHARED_SECRET with the shared secret. You only need to do it once.
offline-scrobbler auth --api-key API_KEY --secret-key SHARED_SECRETThe session key is now stored in a configuration file, and the scrobbler is ready to work. To reset authentication, remove the config file from the standard path "/Library/Application Support/ru.omniverse.offline-scrobbler/config.toml" on macOS or "/.config/ru.omniverse.offline-scrobbler" on Linux
There are different modes of scrobbler:
- scrobble a track
- scrobble whole album
- scrobble album given Last.fm album URL
To scrobble an album, call
offline-scrobbler scrobble --artist=Hooverphonic --album="A New Stereophonic Sound Spectacular"To scrobble using a URL with the specific Last.fm album, call
offline-scrobbler scrobble-url --url "https://www.last.fm/music/Hooverphonic/Blue+Wonder+Power+Milk"If URL is in the clipboard, just call
offline-scrobbler scrobble-url --url -To scrobble a single track of artist (no album), call
offline-scrobbler scrobble --artist=Hooverphonic --track=EdenThe valuable feature of scrobble is the ability to scrobble to the past.
For example, you have listened to a track one hour ago. Then you can specify additional argument --start=1h or --start=60m or even --start="1h 15min"! Formats are described here. It is a scrobbler.
For simplicity, when you invoke scrobbling of an album, the scrobbler analyses all tracks' duration in the album and scrobbles them sequentially until the current moment. Therefore, when you launch the scrobbler, the album will be scrobbled as if you just finished listening to it for an hour.
cargo build --release
Publishing is done by GitHub actions for Linux musl, macOS on Intel and Apple Silicon.
Works on Linux and macOS.
To build a Linux static binary with minimal dependencies, use a static CRT linkage:
cargo build --release --target x86_64-unknown-linux-musl
BSD 3-Clause