Mass scrobble editor with commandline interface.
Find a file
Grzesiek11 13ddcd0a97
Replace chrono with jiff
chrono is now deprecated, with the maintainer pointing to jiff as a good
replacement.
2026-04-21 16:32:34 +02:00
docs/man Add examples to the manual 2026-03-15 18:12:50 +01:00
src Replace chrono with jiff 2026-04-21 16:32:34 +02:00
.gitignore Initial commit 2026-02-23 17:57:49 +01:00
Cargo.lock Replace chrono with jiff 2026-04-21 16:32:34 +02:00
Cargo.toml Replace chrono with jiff 2026-04-21 16:32:34 +02:00
LICENSE Initial commit 2026-02-23 17:57:49 +01:00
README.md Update README 2026-03-15 17:29:04 +01:00

scrbbl

Mass scrobble editor with commandline interface.

Online manual

scrbbl is a mass scrobble editor. It can create, list, edit and delete scrobbles, with editing actions that can act on many scrobbles at once, according to the specified filter. The Last.fm service is supported.

Current state

Keep in mind scrbbl is a work in progress. It might eat your scrobbles, there are no safety mechanisms if you enter a wrong command.

Here's some guidelines on how to use it safely:

  • The manual page for each command might describe unsafe situations to avoid. So RTFM (Read The Friendly Manual)!
  • The most up to date version of the manual is the online manual or the docs/man directory from git master.
  • Running delete or edit without any arguments is almost always a bad idea (specifically delete with no arguments is a good idea if your goal is to wipe your account clean).
  • list is a safe way to play around with the filters, so start with that.
  • If you do accidentally run a bad command, don't panic, press Ctrl+C to cancel it. Deleting scrobbles takes time, so it's actually pretty hard to wipe your account by accident, even though this isn't an intended safety mechanism.
  • delete and edit print out each edited scrobble with it's timestamp, so it's possible to readd the scrobbles with new afterwards.
  • Use a separate Last.fm account for testing if you're worried about your primary one.
  • There are no good error messages, if something is wrong, the program will simply crash.

Copyright © 2026 Grzesiek11

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.