https://github.com/dbeley/playlist-versioning
My playlists under version control.
https://github.com/dbeley/playlist-versioning
playlist playlists
Last synced: about 1 year ago
JSON representation
My playlists under version control.
- Host: GitHub
- URL: https://github.com/dbeley/playlist-versioning
- Owner: dbeley
- Created: 2021-02-26T18:11:49.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-11-04T19:01:46.000Z (over 1 year ago)
- Last Synced: 2024-11-04T20:18:07.288Z (over 1 year ago)
- Topics: playlist, playlists
- Language: Python
- Homepage:
- Size: 1.57 MB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# playlists
My playlists under version control.
## Requirements
- mpd (with your library imported)
- mpc
- python
- bash
- a list of your favorite tracks
- a list of artists linked to a playlist (see below)
Limitations:
- all the tracks of an artist are grouped and will be added to the same playlists
- mpc query language is quite limited and only support exact matches
## MPD matching
Create a text file (for example `files/00_favorites-tracks.txt`) containing your favorite tracks (one by line, with the format `ARTIST - TRACK`):
```
ARTIST1 - FAVORITE_TRACK1
ARTIST1 - FAVORITE_TRACK2
ARTIST2 - FAVORITE_TRACK3
ARTIST3 - FAVORITE_TRACK4
...
```
I personnaly export all my favorite tracks on last.fm with [this script](https://github.com/dbeley/lastfm-scraper/blob/master/lastfm-all_favorite_tracks.py).
Run the `mplaylist.sh` script:
```
./mplaylist.sh files/00_favorites-tracks.txt
```
Output:
- `files/04_result-mplaylist.csv`: tracks matched with mpc
- `files/05_result-mplaylist-missing.csv`: tracks not matched with mpc
## Playlist creation
You will need three files:
- `files/01_playlists.csv` (fields: `playlist_id;playlist_name`):
```
1;Rock
2;Pop
```
- `files/02_artists.csv` (fields: `playlist_id;artist_name`):
```
1;ARTIST1
1;ARTIST3
2;ARTIST2
2;ARTIST1
```
Those two files says "ARTIST1 and ARTIST3 songs will be added to the playlist Rock, and ARTIST1 and ARTIST2 songs to the Pop playlist".
Adding artists in multiple playlists is supported, just duplicate the entries with a different playlist id.
- `files/06_fix-missing-tracks.csv`: manually add paths for the missing tracks in `05_result-mplaylist-missing.csv` (fields: `missing_track;path`):
```
ARTIST1 - MISSING_TRACK1;PATH_TO_TRACK1
ARTIST2 - MISSING_TRACK2;PATH_TO_TRACK2
ARTIST2 - MISSING_TRACK3;PATH_TO_TRACK3
ARTIST3 - MISSING_TRACK4;PATH_TO_TRACK4
```
Run the `create_playlists.py` script (change the **LOCAL_BASEPATH** and **BASEPATH** global variable to your own):
```
python create_playlists.py
```
**BASEPATH** indicates what the mpd matched tracks will be prefixed with. It's used to complete the paths as mpd uses internal paths and not full paths.
**LOCAL_BASEPATH** indicates the base path to delete after checking the validity of the manually inserted paths in `06_fix-missing-tracks.csv`. The **BASEPATH** will then be used as a prefix.
By setting **BASEPATH** to `/music/` and **LOCAL_BASEPATH** to `/home/user/nfs/Musique/`, the script will delete `/home/user/nfs/Musique/` from the paths found in `06_fix-missing-tracks.csv` and will create playlists using `/music/` as base path.
If you want to use your playlists on the same filesystem configuration, you can set **LOCAL_BASEPATH** and **BASEPATH** to the same value.
Output:
- `files/03_artists_NOT-FOUND.csv`: artists not found in `02_artists.csv`
- `files/07_fix-missing-tracks_NOT-FOUND.csv`: missing tracks not found in `06_fix-missing-tracks.csv`
If those files are empty you're good, otherwise just add entries in `02_artists.csv` or `06_fix-missing-tracks.csv` and restart the script `create_playlists.py`.
Exported playlists will be in the `playlists` folder.
## Import
I automatically import those playlists into airsonic (airsonic can watch and import playlists from a folder).
My music folder is mounted under the `/music/` folder in my airsonic container (hence the `/music/` prefix in `create_playlists.py`).