https://github.com/burritosoftware/icecast-scrobbler
An Icecast internet radio scrobbler for Last.fm, primarily designed for Friday Night Tracks
https://github.com/burritosoftware/icecast-scrobbler
icecast lastfm scrobbler
Last synced: 12 months ago
JSON representation
An Icecast internet radio scrobbler for Last.fm, primarily designed for Friday Night Tracks
- Host: GitHub
- URL: https://github.com/burritosoftware/icecast-scrobbler
- Owner: burritosoftware
- License: mit
- Archived: true
- Created: 2023-12-23T01:19:19.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-08-02T04:17:05.000Z (12 months ago)
- Last Synced: 2025-08-02T06:54:25.181Z (12 months ago)
- Topics: icecast, lastfm, scrobbler
- Language: Python
- Homepage:
- Size: 35.2 KB
- Stars: 4
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WARNING: Now deprecated!
I created a more robust scrobbler specifically for Friday Night Tracks that uses a direct API for better reliability. If you currently use this project to scrobble Friday Night Tracks, please switch to [FNT-Scrobbler](https://github.com/burritosoftware/FNT-Scrobbler)! If you use this for other Icecast streams, I don't really have motivation to continue maintaining this, so I will be archiving it, sorry :( Consider spinning up a fork to keep it alive if you want!
---
# Icecast Scrobbler
[](https://wakatime.com/badge/github/burritosoftware/Icecast-Scrobbler) [](https://github.com/burritosoftware/Icecast-Scrobbler/commits/master)
An Icecast internet radio scrobbler for Last.fm, primarily designed around [Friday Night Tracks](https://fridaynighttracks.com), that includes many quality-of-life features for the monthly live radio show.
> [!WARNING]
> This is not pretty and I would like to make it a bit more convenient than running a Python script. As a constant work-in-progress, expect bugs!
## Get It Running
1. Make sure you have Python installed.
2. Install/upgrade dependencies:
```
pip install -U -r requirements.txt
```
3. Duplicate `.env-example` to `.env`, and add a Last.fm API key and secret from https://www.last.fm/api/account/create.
> [!NOTE]
> The configuration is, by default, set to work best with xbn.fm/Friday Night Tracks and requires no further configuration. However, if you are using an Icecast stream that only outputs one source, set `ICECAST_MULTI_SOURCE` to `False`. Additionally, if you don't want any tag removal, set the `TAG_REGEX` to `(?!x)x` to disable it.
```
cp .env-example .env
nano .env
```
4. Start the scrobbler. On first run, it'll ask you to authorize in a web browser. Then it'll start sending what's currently playing and scrobble songs once they end.
```
python3 scrobble.py
```
## Contributing
All contributions welcome! I am primarily using this for Friday Night Tracks, so while I can assist you with using this for other Icecast streams, I'm primarily making sure bugs are ironed out for FNT. However, if you're having issues either way, please open an issue and I'll try to do my best!