beatsaber-ntfy/README.md
2024-12-13 13:58:47 +01:00

23 lines
1.1 KiB
Markdown

# beatsaber-ntfy
A bash script to post ScoreSaber/BeatLeader statistics changes to a ntfy.sh server.
## How to use
- You need `jq`, `curl`, and `bc` installed.
- Set the `SCORESABER_DIR` and `BEATLEADER_DIR` variables at the top of `beatsaber-ntfy.sh` to a persistent directory (or `mkdir ./{scoresaber,beatleader}-players`)
- Create a file for each profile you want to track, named as the ID of the player
- Run the script
## Example player file
The following file located at `./scoresaber-players/2169974796454690`:
```
NTFY_URL=https://ntfy.sh/my-beatsaber-profile
COUNTRY_THRESHOLD=1
RANK_THRESHOLD=1
PP_THRESHOLD=0.01
```
Will configure the script to post updates about ScoreSaber user `2169974796454690` to `https://ntfy.sh/my-beatsaber-profile`.
The `COUNTRY_THRESHOLD`, `RANK_THRESHOLD`, and `PP_THRESHOLD` variables indicate by how much these values need to change before sending a notification.
The IDs that each platform is able to use differs, you can find them in the URL of your profile.
For example, `https://scoresaber.com/u/2169974796454690` or `https://beatleader.xyz/u/bytesy` both lead to Bytesy's profile, but only BeatLeader accepts the vanity ID.