You may download a monolithic version of ZOMG here.

You may view the revision log at git.debian.org.

Source for zomghelper and zomghelper-xspf can be retrieved from the same repository.


Get yourself an account (username and password) at either Last.fm or Libre.fm or both. The first time you run zomg, it will prompt you for them. If you screw this up or need to change them, edit ~/.zomg/conf or remove it and start over.

Simply run the script with the filenames of the .ogg (Vorbis), .opus (Opus), .mp3, or .flac files you wish to play. If you want them to be shuffled, use the -z option. If you specify directories they will be recursed.

ZOMG will submit each track to your configured services until it fails to receive an OK response, after which it will cache the Audioscrobbler data. On the next invocation of zomg, it will attempt to flush the cache.


Since 0.5.12, you need wget for everything.

For Ogg Vorbis, you need vorbis-tools (ogg123 and, if you don't have zomghelper, ogginfo).

For Ogg Opus, you need mpv or cvlc and, if you don't have zomghelper, opusinfo.

For MP3, you need mpg123 and python-mutagen or eyeD3.

For librefm:// URLs, you need wget and mplayer or ogg123.

For lastfm:// URLs, you need wget and mplayer or mpg123.

OS-specific installation instructions