uploading scores - christopher-dG/unnoticed GitHub Wiki

Before uploading your scores, you will need to download a small program which can be found on the release page. When you run this program, your scores are uploaded immediately, and then it begins to monitor your scores database for changes. When new changes are detected, your scores are uploaded again, and it returns to the waiting state. To exit, you can press Ctrl-C at any time.

In case you're wondering which version to download: darwin means MacOS/OSX, 386 means 32-bit, and amd64 means 64-bit.
Regardless of the version you have, you can run it by simply executing the file (double clicking on Windows).

Your osu! database files (osu!.db and scores.db) are expected to be in the following locations:

• Windows: C:\Program Files (x86)\osu!\, C:\Users\YourUsername\AppData\Local\osu!\, or C:\osu!\
• MacOS: /Applications/osu!.app/Contents/Resources/drive_c/Program Files/osu!/
• Linux: ./ (whichever directory you ran the program from)

If this is not the case, then you will be prompted to enter the install location when you run the program. If that's too much hassle, you can set a system variable called OSU_ROOT containing the location. For more information about that, see Setting Environment Variables.

All of the program's output is saved in a log file. It can be found here:

• Windows: C:\Users\YourUsername\AppData\Local\Temp\unnoticed.log
• MacOS: $TMPDIR/unnoticed.log (type echo $TMPDIR in Terminal to get the actual location)
• Linux: /tmp/unnoticed.log

If you see a lot of weird messages such as scores.db score 123 on map 456: ABC, a good first step is to refresh your map database from osu! by pressing F5 in the beatmap selection menu(note that this might take some time if you have a lot of beatmaps, and you won't be able to play while it's in progress) and then try again. If that still doesn't work, feel free to ask for help in a new issue or on Discord. However if you're on MacOS, do read MacOS/OSX first.

It would appear that on MacOS, osu!.db follows a slightly different format and as such needs to be parsed with a different method. This is accounted for, but if you are having problems, it could be that your database file actually follows the normal format. To use the default parsing method on MacOS, set the UNNOTICED_FORCE_DEFAULT_PARSING environment variable to any value (see Setting Environment Variables if necessary) and then try again.

When osu! is running, your score database (scores.db) is not updated after each play, it's only modified when you exit osu!. This means that there's no use trying to upload your scores after each play, unless you want to restart osu! every time.

You might be asking "Why should I run this random program you're giving me?", and I don't blame you. Any antivirus software you're running (including Windows Defender) will probably try to stop you from running the program, because it comes from an unknown source.
If you're worried about this (I would be), I encourage you to audit my code. However, this isn't enough. How do you know that the program you downloaded was actually compiled from that code? To verify this, you can go to the Travis CI build for the latest release here, where the MD5 checksum of each executable can be seen. Then, compute the checksum on your local version, and compare (this site lets you upload a file to get the checksum). If they match, then you know that the program you've downloaded was built from the code in this repository.
Alternatively, you can compile the code yourself. Obviously this is inconvenient, but it seems that code signing certificates are expensive (see issue #2).