last.fm offline scrobbler

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.

Installation

cargo install offline-scrobbler

Usage

1. Create Last.fm application account

1. Navigate to Last.fm Create API account page
2. Fill out the fields "Contact e-mail" and "Application name" to whatever you like. Other fields should be empty". Click "Submit".
3. Grab "API Key" and "Shared secret" from the resulting page. You need them to set up the scrobbler once.

2. Setup offline scrobbler

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_SECRET

The 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

3. Scrobble

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=Eden

The 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.

Development

cargo build --release

Publishing is done by GitHub actions for Linux musl, macOS on Intel and Apple Silicon.

Portability

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

License

BSD 3-Clause