Skip to content

flazepe/osu-scrobbler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

202 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

osu-scrobbler

An osu! Last.fm and ListenBrainz scrobbler. This scrobbler only works for gameplay!

Setup

  1. Download the latest release binary for your operating system here.

  2. Create a folder called osu-scrobbler (or anything really) in your system and move the downloaded binary file there.

  3. In the same folder, create a file called config.toml with this as the content.

Tip

The config.toml file can also be placed anywhere and its path can be supplied through the OSU_SCROBBLER_CONFIG_PATH environment variable while executing the binary.

  1. Get your Last.fm API credentials here (or here if you already have one).

    • For ListenBrainz users, head here to get your user token.
  2. Edit the configuration values accordingly.

    • Most notably, your osu! user ID and scrobbler credentials.
  3. Execute the binary in the terminal and the scrobbler should start.

Tip

If you're on Windows or macOS, you can also double click the binary file to launch the scrobbler.

Configuration

Refer here for more details about the configuration properties.

Autostart

You can configure the scrobbler to automatically start on startup. Refer here for the necessary steps.