TuneLog is a self-hosted music recommendation system for Navidrome. It learns from listening behavior such as skips, partial plays, full plays, and repeats to generate personalized playlists and improve search results.
- AI were used in some
sql Query - Some part in debuggin and some assistance in building frontend like
socketio - Assistance in some of the
researchlike which python module to use and stuff PlaylistPage was re written using claude ai
Important
Migrated from Mono Repo to Multi Repo Please Re download the ghcr-docker-compose.yaml file
Note
If this project may look abandoned, That may not be the case, I have shifted from mono-repo to poly-repo.
please check tunelog-backend, tunelog-frontend for more updates
This feature lets user sync there local starred song from navidrome to listenbrainz. Read here Push Heart
- A new Skipped Songs section has been added to the Library dashboard, making it easier to review songs that are frequently skipped.
- TuneLog can now generate collaborative recommendations using listening data from the most similar users on ListenBrainz.
- TuneLog now supports ListenBrainz Collaborative Filtering (CF) recommendations.
This feature uses ListenBrainz recommendation data and matches it against songs already available in your library to automatically generate personalized playlists.
For setup instructions and details, see the ListenBrainz Collaborative Filtering documentation.
- Navidrome instance with API access
- Docker and Docker Compose, or Python 3.10+
- Node.js for the frontend if running manually
mkdir tunelog && cd tunelog
curl -o .env https://raw.githubusercontent.com/adiiverma40/tunelog/main/.env.example
curl -o ghcr-compose.yaml https://raw.githubusercontent.com/adiiverma40/tunelog/main/ghcr-compose.yaml
docker compose -f ghcr-compose.yaml up -dUpdate:
docker compose -f ghcr-compose.yaml pullEdit .env before starting the stack.
Note
You will have to manually Added or change the docker compose files for volume mounts
mkdir -p tunelog && cd tunelog
git clone https://github.com/adiiverma40/tunelog-backend
git clone https://github.com/adiiverma40/tunelog-frontend
curl -o .env https://raw.githubusercontent.com/adiiverma40/tunelog/main/.env.exampleBackend
cd tunelog-backend
docker compose up --buildFrontend
cd tunelog-frontend
docker compose up --buildNote
Note for Windows Users : PowerShell's default curl command may throw an SSL/Revocation error. If the curl commands below fail, simply download the .env.example file manually from the repository, place it in the respective folders, and rename it to .env. Or create .env file and paste the below config in both folders
Backend:
git clone https://github.com/adiiverma40/tunelog-backend
cd tunelog-backend
curl -o .env https://raw.githubusercontent.com/adiiverma40/tunelog/main/.env.example
cp .env.example .env
pip install -r requirements.txt
python3 error.pyFrontend:
git clone https://github.com/adiiverma40/tunelog-frontend
cd tunelog-frontend
curl -o .env https://raw.githubusercontent.com/adiiverma40/tunelog/main/.env.example
npm install
npm run devUpdate .env with your Navidrome details and the addresses you want to allow.
# ================================================
# NAVIDROME CONFIG
# ================================================
BASE_URL=http://navidrome-navidrome-1:4533 # Base URL for Navidrome Server
ADMIN_USERNAME=adii # Admin Username for Navidrome Server
ADMIN_PASSWORD=1234 # Admin password for Navidrome Server
# ===============================================
# DASHBOARD CONFIG
# ==============================================
VITE_URL=http://192.168.29.118:5173 # URL for Dashboard.
VITE_SERVER_PORT=8000 # PORT on which Uvicorn(fastapi) server will be of Dashboard
# Add additional origins separated by commas, or use * to allow all.
ALLOWED_ORIGINS=http://localhost:5173,http://192.168.29.118:5173,*
# VITE_API_URL=http://192.168.29.118:8000 # NO NEED FOR THIS
# VITE_NAVIDROME_URL=http://192.168.29.118:4533 # NO NEED FOR THIS
MY_DOMAIN=192.168.29.118
# ================================================
# LOGGING
# ================================================
LOG_DIR=/app/logs
LOG_MAX_SIZE=10 MB
LOG_RETENTION_DAYS=7 days
LOG_LEVEL=DEBUG
# =================================================
# PROXY
# =================================================
PROXY_PORT=4534
- Playlist : guide on playlist generation and tweaks
- ListenBrainz Integration : guide on Listenbrainz integration in tunelog and dev info
Note: Navidrome/subsonic client like
symfoniumscrobble data to navidrome and navidrome reports that tolistenbrainz, So Do not add those apps inpano appscrobble list or it will create two list of same song
ItunesFuzzy: Songs that are new or that is not in either
itunesormusicbrainz, such as ofsmall creatorswill be markedunmatchedas api will returnnone
- If there is any error, try copy pasting the config.json from github to your local file
- If Fast Library sync is taking too long, that will likely due to lyrics plugins, try turning off Lyrics Plugin in navidrome and runing the sync again Or change the lyrics priorty to emmbedded or .lrc
- Personalized playlist generation from listening history
- Navidrome library sync
- Optional proxy layer for improved search and ranking
- Lyrics-aware search
- Fuzzy metadata matching
- CSV playlist import
- Logging and error handling
- Web dashboard and API backend
- Navidrome jam
- No need to Mannually Add Listenbrainz token, Go to playlist > Listenbrainz cf > Add the token and save it
In the dashboard there is a jam section, if you wish to use jam go to jam and now playing section in the dashboard
features
- sync play , pause , skip
- Queue reorder
- Transfer host
- Chats for joined user - chats are not end to end encripted, do not share personal/private info
- Queue can be added from library or playlist
- In
configyou can toggle some features for jam likeonly host reorder queue,only host clear queueand more
Requirements
- Navidrome Running
VITE_NAVIDROME_URLin .env for search and album arts- All users in same server/dashboard
Setup
- Start the navidrome server
- start tunelog server and frontend
- go to dashboard
- do a library sync if havent
- Add or create users in users
- go to jam/nowplaying
- start jam
- users that have logged in the dashboard will see join jam option in nowplaying page,
- join it and enjoy
user profile
- User profile can be changed by
userssection
For better artist mapping, you can add this to navidrome.toml:
Tags.Artist.Aliases = ["artist", "artists"]Then run a full library scan in Navidrome.
The proxy layer is optional. When enabled, client search requests are routed through TuneLog before falling back to Navidrome.
To use it:
- Set
PROXY_PORTin.envif needed - Point your client to the proxy port instead of Navidrome directly
- Keep the proxy and Navidrome on the same machine when possible
TuneLog uses implicit feedback from Navidrome activity to score tracks:
- Skipped tracks are penalized
- Partially played tracks get a small positive score
- Fully played tracks get a higher score
- Replayed tracks get the highest score
The playlist engine combines those scores with recency and discovery logic to keep playlists balanced.
TuneLog/
├── backend/
│ ├── main.py
│ ├── playlist.py
│ ├── library.py
│ ├── db.py
│ └── Data/
├── frontend/
└── compose.yaml
- If you switch between Docker and manual runs, fix permissions on
data/if needed. - Some features depend on Navidrome scanning and event support.
- Search quality depends on the metadata in your library.
- Speeding up or slowing down playback can affect listening detection.
- Navidrome
- FastAPI
- RapidFuzz
- TailAdmin