{"id":28215,"library":"spotify-youtube-migrator","title":"Spotify-YouTube Migrator","description":"A Python package to migrate playlists between Spotify and YouTube Music. Version 2.0.0 supports OAuth authentication and bidirectional migration. Release cadence is irregular; last updated November 2024.","status":"active","version":"2.0.0","language":"python","source_language":"en","source_url":"https://github.com/manojk0303/spotify-youtube-migrator","tags":["spotify","youtube-music","playlist-migration","music","transfer"],"install":[{"cmd":"pip install spotify-youtube-migrator","lang":"bash","label":"Standard install"}],"dependencies":[{"reason":"Required for Spotify API interaction","package":"spotipy","optional":false},{"reason":"Required for YouTube Music API interaction","package":"ytmusicapi","optional":false}],"imports":[{"note":"Direct import from package root is correct since v2.0.0. Submodule import may fail.","wrong":"from spotify_youtube_migrator.migrator import Migrator","symbol":"Migrator","correct":"from spotify_youtube_migrator import Migrator"}],"quickstart":{"code":"from spotify_youtube_migrator import Migrator\n\nmigrator = Migrator()\n# This will prompt for Spotify and YouTube Music credentials interactively\nmigrator.migrate_spotify_to_youtube()","lang":"python","description":"Basic interactive migration from Spotify to YouTube Music. Requires user authentication via OAuth flows."},"warnings":[{"fix":"Update imports to use `from spotify_youtube_migrator import Migrator` and use the new methods (`migrate_spotify_to_youtube`, `migrate_youtube_to_spotify`).","message":"v2.0.0 introduced a completely new API. The old v1 `PlaylistMigrator` class is removed. Code written for v1 will not work.","severity":"breaking","affected_versions":"<2.0.0"},{"fix":"Set `SPOTIPY_CLIENT_ID`, `SPOTIPY_CLIENT_SECRET`, `SPOTIPY_REDIRECT_URI` and `YT_OAUTH_*` variables, or subclass Migrator to provide tokens.","message":"Non-interactive (scripted) usage is not directly supported. The constructor `Migrator()` triggers interactive OAuth unless you manually handle environment variables or modify the source.","severity":"gotcha","affected_versions":"2.0.0"},{"fix":"Use environment variables instead of editing config.py. See README for required variables.","message":"The `config.py` module is deprecated; environment variables are now the preferred configuration method.","severity":"deprecated","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install spotify-youtube-migrator` in the correct Python environment.","cause":"Package not installed or installed in a different environment.","error":"ModuleNotFoundError: No module named 'spotify_youtube_migrator'"},{"fix":"Upgrade to v2.0.0: `pip install --upgrade spotify-youtube-migrator`. Then use `from spotify_youtube_migrator import Migrator`.","cause":"You are using v1.x where the class was named 'PlaylistMigrator' or you have an old version installed.","error":"AttributeError: module 'spotify_youtube_migrator' has no attribute 'Migrator'"},{"fix":"Set environment variables `SPOTIPY_CLIENT_ID`, `SPOTIPY_CLIENT_SECRET`, and `SPOTIPY_REDIRECT_URI`.","cause":"Spotify API credentials are missing or incorrect.","error":"spotipy.oauth2.SpotifyOauthError: Invalid client id"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}