https://github.com/platers/unitunes

A GUI and library to transfer, sync, and backup playlists on music streaming services
https://github.com/platers/unitunes

gui music-library musicbrainz playlist-manager python spotify ytmusic

Last synced: 1 day ago
JSON representation

A GUI and library to transfer, sync, and backup playlists on music streaming services

• Host: GitHub
• URL: https://github.com/platers/unitunes
• Owner: platers
• License: gpl-3.0
• Created: 2022-05-12T17:01:35.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-08-20T02:18:56.000Z (over 1 year ago)
• Last Synced: 2025-01-03T10:08:54.274Z (8 days ago)
• Topics: gui, music-library, musicbrainz, playlist-manager, python, spotify, ytmusic
• Language: Python
• Homepage:
• Size: 1.83 MB
• Stars: 140
• Watchers: 5
• Forks: 12
• Open Issues: 17
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

• jimsghstars - platers/unitunes - A GUI and library to transfer, sync, and backup playlists on music streaming services (Python)

README

        
# unitunes [![PyPI version](https://badge.fury.io/py/unitunes.svg)](https://badge.fury.io/py/unitunes) ![example workflow](https://github.com/platers/unitunes/actions/workflows/github-actions.yml/badge.svg)

![unituneslogo](assets/unitunes.png)

A python GUI and library to sync playlists across music streaming services.

![playlist_tab](assets/playlist_tab.png)

## Introduction

unitunes manages playlists across streaming services. unitunes can transfer songs between services and keep playlists in sync.

unitunes stores your playlists in plain text, allowing you to version control your music. Playlists can be pushed and pulled from streaming services. Tracks from one service can be searched on another.

### Current Supported Streaming Services

| Name          | Pullable | Pushable | Searchable |

| ------------- | :------: | :------: | :--------: |

| MusicBrainz   |          |          |     ✅     |

| Spotify       |    ✅    |    ✅    |     ✅     |

| Youtube Music |    ✅    |    ✅    |     ✅     |

| Beatsaber     |    ✅    |    ✅    |     ✅     |

Want to add support for another service? See [contributing](#contributing).

## Usage

```bash

pip install unitunes

unitunes

```

In settings, set the directory to store your playlists. You can version control this directory with git.

Connect services in the service tab. Enter a service name, and click the button to add the corresponding service. Each service type requires some configuration, Spotify requires a client id and secret, and Youtube Music requires request headers.

![service_tab](assets/service_tab.png)

Playlists can then be added to the playlist tab.

After adding playlists, you can sync them. You likely just want to press the `Sync All` button, which will pull, search, and push all playlists.

## Contributing

unitunes is rapidly evolving. Take a look at the [contributing guide](CONTRIBUTING.md).