Metadata-Version: 2.2
Name: spotify_to_ytmusic
Version: 0.6.1
Summary: Transfer Spotify playlists to YouTube Music
Author-email: sigma67 <sigma67.github@gmail.com>
License: MIT License
        
        Copyright (c) 2022 sigma67
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: homepage, https://github.com/sigma67/spotify_to_ytmusic
Project-URL: repository, https://github.com/sigma67/spotify_to_ytmusic
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: ytmusicapi>=1.9.1
Requires-Dist: spotipy>=2.23.0
Requires-Dist: platformdirs>=3.2

spotify_to_ytmusic
####################

.. |pypi-downloads| image:: https://img.shields.io/pypi/dm/spotify_to_ytmusic?style=flat-square
    :alt: PyPI Downloads
    :target: https://pypi.org/project/spotify_to_ytmusic/

.. |discuss| image:: https://img.shields.io/github/discussions/sigma67/spotify_to_ytmusic?style=flat-square
   :alt: Ask questions at Discussions
   :target: https://github.com/sigma67/spotify_to_ytmusic/discussions

.. |code-coverage| image:: https://img.shields.io/codecov/c/github/sigma67/spotify_to_ytmusic?style=flat-square
    :alt: Code coverage
    :target: https://codecov.io/gh/sigma67/spotify_to_ytmusic

.. |latest-release| image:: https://img.shields.io/github/v/release/sigma67/spotify_to_ytmusic?style=flat-square
    :alt: Latest release
    :target: https://github.com/sigma67/spotify_to_ytmusic/releases/latest

.. |commits-since-latest| image:: https://img.shields.io/github/commits-since/sigma67/spotify_to_ytmusic/latest?style=flat-square
    :alt: Commits since latest release
    :target: https://github.com/sigma67/spotify_to_ytmusic/commits


|pypi-downloads| |discuss| |code-coverage| |latest-release| |commits-since-latest|

A simple command line script to clone a Spotify playlist to YouTube Music.

- Transfer a single Spotify playlist
- Like all the songs in a Spotify playlist
- Update a transferred playlist on YouTube Music
- Transfer all playlists for a Spotify user
- Like all songs from all playlists for a Spotify user
- Remove playlists from YouTube Music


Install
-------

- Python 3 - https://www.python.org
- pipx - https://pipx.pypa.io

.. code-block::

    pipx ensurepath

- Open a new shell. Install:

.. code-block::

    pipx install spotify_to_ytmusic


Setup
-------

1. Generate a new app at https://developer.spotify.com/dashboard
2. Generate a new app by following instructions at https://ytmusicapi.readthedocs.io/en/stable/setup/oauth.html
3. Run

.. code-block::

    spotify_to_ytmusic setup

For backwards compatibility you can also create your own file and pass it using ``--file settings.ini``.

If you want to transfer private playlists from Spotify (i.e. liked songs), choose "yes" for oAuth authentication, otherwise choose "no".
For oAuth authentication you should set ``http://localhost`` as redirect URI for your app in Spotify's developer dashboard.

Usage
------

After you've completed setup, you can simply run the script from the command line using:

.. code-block::

    spotify_to_ytmusic create <spotifylink>

where ``<spotifylink>`` is a link like https://open.spotify.com/playlist/0S0cuX8pnvmF7gA47Eu63M

The script will log its progress and output songs that were not found in YouTube Music to **noresults_youtube.txt**.

Transfer all playlists of a Spotify user
----------------------------------------

For migration purposes, it is possible to transfer all public playlists of a user by using the Spotify user's ID (unique username).

.. code-block::

    spotify_to_ytmusic all <spotifyuserid>

Transfer liked tracks of the Spotify user
-----------------------------------------

**You must use oAuth authentication for transferring liked songs.**

.. code-block::

   spotify_to_ytmusic liked

This command will open browser where you should give access to your account (if you haven't done that before).
After authorization you will be redirected to localhost, copy link you were redirected to (looks like localhost/?code=...) and paste to command line.

Command line options
---------------------

There are some additional command line options for setting the playlist name and determining whether it's public or not. To view them, run

.. code::

    spotify_to_ytmusic -h


To view subcommand help, run i.e.

.. code-block::

    spotify_to_ytmusic setup -h


Available subcommands:

.. code-block::

    positional arguments:
      {setup,create,update,remove,all}
                            Provide a subcommand
        setup               Set up credentials
        create              Create a new playlist on YouTube Music.
        update              Delete all entries in the provided Google Play Music playlist and update the playlist with entries from the Spotify playlist.
        remove              Remove playlists with specified regex pattern.
        all                 Transfer all public playlists of the specified user (Spotify User ID).

    options:
      -h, --help            show this help message and exit
