https://github.com/abhishekmj303/ytm2spt
Transfer Playlists from YouTube Music to Spotify
https://github.com/abhishekmj303/ytm2spt
hacktoberfest playlist-converter playlists spotify spotipy thefuzz transfer-playlists youtube-music ytmusicapi
Last synced: 2 months ago
JSON representation
Transfer Playlists from YouTube Music to Spotify
- Host: GitHub
- URL: https://github.com/abhishekmj303/ytm2spt
- Owner: abhishekmj303
- License: gpl-3.0
- Created: 2023-07-22T13:46:32.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-05-08T20:11:50.000Z (about 1 year ago)
- Last Synced: 2025-11-29T05:32:19.346Z (7 months ago)
- Topics: hacktoberfest, playlist-converter, playlists, spotify, spotipy, thefuzz, transfer-playlists, youtube-music, ytmusicapi
- Language: Python
- Homepage: https://pypi.org/project/ytm2spt
- Size: 387 KB
- Stars: 369
- Watchers: 2
- Forks: 21
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
YouTube Music To Spotify
An open-source app for effortlessly transferring playlists from YouTube Music to Spotify.
## Features
- [x] No limit on size of playlist
- [x] Support public playlists
- [x] Support private playlists
- [x] Auto create or update playlist if it already exists
- [x] Use fuzzy search to find the best match
- [x] Copy playlist thumbnail from youtube to spotify
- [ ] Copy playlist description from youtube to spotify
- [x] Limit number of songs to be imported in the playlist
- [x] Dry run mode to test without adding to spotify
## Setup
### Spotify Developer Account
**Why?**
By setting up a Developer account and creating your own credentials (like keys), you are ensuring that the app connects to your account in a safe way without sharing your login details with anyone. It gives you full control over what the app can access and helps keep your Spotify account secure.
1. Create a new app: https://developer.spotify.com/dashboard
2. Set "Redirect URI" to `http://127.0.0.1:8888/callback`
3. Copy the "Client ID" and "Client Secret" to use later
4. Copy the "User ID" from your Spotify account: https://www.spotify.com/in-en/account/profile/
## Installation
Download the latest version from the following links:
> [!NOTE]
> **Windows**: Windows Defender may interrupt the app from running. Click on more info and allow the program to run.
>
> **Linux**: You need to run the app from terminal, if you want the to know the progress of the transfer.
**Using pip or [pipx](https://github.com/pypa/pipx#install-pipx):**
[](https://pypi.org/project/ytm2spt/)
[](https://pypi.org/p/ytm2spt/)
If you have Python installed, you can install the app using [pipx](https://pipx.pypa.io/) (recommended) or pip.
```sh
pipx install ytm2spt
```
or
```sh
pip install ytm2spt
```
After installation, you can run the app using the command `ytm2spt`.
> [!CAUTION]
> While syncing into an existing spotify playlist, first all the songs from Stopify playlist will be deleted and then the all the songs from YouTube Music playlist will be copied.
### Spotify Settings
When you run the executable, you will be prompted to enter your Spotify credentials.
### Youtube Settings
If you click on "Private Playlist", you will be prompted to enter get your Youtube OAuth credentials if not already set.
> [!TIP]
> If you find this project useful or interesting, please consider giving it a 🌟star! It helps others discover it too!
---
## GUI
Python3 is required to run the app. You can download it from [python.org](https://www.python.org/downloads/) for Windows.
### Install Dependencies
```sh
pip install .
```
### Run the App
```sh
python ytm2spt.py
```
## CLI
### Setting Environment Variables Linux and Mac
1. Rename the file `.env.sample` to `.env`
2. Edit the file by adding your credentials
3. Run the following command to set your environment variable: `source .env`
### Setting Environment Variables (Windows)
1. Edit `env.bat` file by adding your credentials in these lines
```bat
set SPOTIFY_USER_ID=
set SPOTIFY_CLIENT_ID=
set SPOTIFY_CLIENT_SECRET=
```
2. Run the batch file to set your environment variable:
```bat
env.bat
```
>[!NOTE]
> If the environment variables are not set, you may need to restart your terminal or IDE.
### Install Dependencies
```sh
pip install -r requirements.txt
```
### Youtube OAuth (Only for private playlists)
Run the following command to login to your Youtube account and save the credentials to `ytmusicapi-oauth.json`
```sh
ytmusicapi-oauth
```
## Usage
```sh
$ source .env
$ ytm2spt -h
usage: ytm2spt [-h] -yt YOUTUBE_URL_OR_ID
[-sp SPOTIFY_URL_OR_ID | -spname SPOTIFY_PLAYLIST_NAME]
[-ytauth YOUTUBE_OAUTH_JSON]
[-n | -d] [-l LIMIT]
options:
-h, --help show this help message and exit
-yt YOUTUBE_URL_OR_ID, --youtube-url-or-id YOUTUBE_URL_OR_ID
Youtube Playlist URL or ID
-sp SPOTIFY_URL_OR_ID, --spotify-url-or-id SPOTIFY_URL_OR_ID
Spotify Playlist URL or ID
-spname SPOTIFY_PLAYLIST_NAME, --spotify-playlist-name SPOTIFY_PLAYLIST_NAME
Spotify Playlist Name (Default: Youtube Playlist Name)
-ytauth YOUTUBE_OAUTH_JSON, --youtube-oauth-json YOUTUBE_OAUTH_JSON
Youtube OAuth JSON filepath (run 'ytmusicapi-oauth')
-n, --create-new Force create a new playlist
-d, --dryrun Do not add to Spotify
-l LIMIT, --limit LIMIT
Limit the number of songs to fetch
```
```sh
$ ytmusicapi-oauth -h
usage: ytmusicapi-oauth [-h] [-b] [file]
positional arguments:
file file path to store the json (Default: ytmusic-oauth.json)
options:
-h, --help show this help message and exit
-b, --open-browser open browser for OAuth login (Default: True)
```
### Examples
Sample Playlist: Pop Certified ([YouTube Music](https://music.youtube.com/playlist?list=RDCLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU) to [Spotify](https://open.spotify.com/playlist/6DyIxXHMwuEMbsfPTIr9C8))
```sh
# Pass any link containing a youtube playlist ID
# Sets same name as youtube playlist
$ python ytm2spt.py -yt "https://music.youtube.com/playlist?list=RDCLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU"
# Pass just the youtube playlist ID
# Set a custom name for the playlist
$ python ytm2spt.py -yt "CLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU" -spname "Pop Certified"
# Pass link of a private youtube playlist
# Provide the path to the oauth.json file
$ python ytm2spt.py -yt "https://music.youtube.com/playlist?list=PLz96m0PSfi9p8ABcEcUlSMVmz7sN-IEFu" -ytauth "oauth.json"
# Pass an existing spotify playlist URL or ID
# Limit the number of songs to fetch
# Dry run mode
$ python ytm2spt.py -yt "CLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU" -sp "https://open.spotify.com/playlist/6DyIxXHMwuEMbsfPTIr9C8" -l 10 -d
# Pass even the URL of video playing from playlist
# Force create a new playlist
$ python ytm2spt.py -yt "https://www.youtube.com/watch?v=RlPNh_PBZb4&list=RDCLAK5uy_lBNUteBRencHzKelu5iDHwLF6mYqjL-JU" -n
```
## Build an Executable
**Note:** This is only required if you want to build the executable yourself. This is not necessary if you just need to run the app directly using Python.
**Requirements:**
- C Compiler (gcc, clang)
- `patchelf` (Linux only)
- `python3-devel` or similar package in your OS
```sh
pip install -r requirements-dev.txt
nuitka ytm2spt.py
```
> [!NOTE]
> Forked from @edgarh22's [Youtube-to-Spotify-Archiver](https://github.com/edgarh92/Youtube-to-Spotify-Archiver).