Metadata-Version: 2.1
Name: spotdl
Version: 3.3.0
Summary: Download your Spotify playlists and songs along with album art and metadata
Home-page: https://github.com/spotDL/spotify-downloader
Author: spotDL Team
Author-email: spotdladmins@googlegroups.com
License: MIT
Download-URL: https://pypi.org/project/spotdl/
Description: ![logo](static/logo.png)
        
        # spotDL
        
        > **The fastest, easiest, and most accurate command-line music downloader**
        
        [![MIT License](https://img.shields.io/apm/l/atomic-design-ui.svg?)](https://github.com/spotDL/spotify-downloader/blob/master/LICENSE)
        ![Contributors](https://img.shields.io/github/contributors/spotDL/spotify-downloader)
        ![downloads](https://img.shields.io/github/downloads/spotDL/spotify-downloader/latest/total)
        [![BCH compliance](https://bettercodehub.com/edge/badge/spotDL/spotify-downloader?branch=master)](https://bettercodehub.com/)
        [![pypi version](https://img.shields.io/pypi/pyversions/spotDL)](https://pypi.org/project/spotdl/)
        [![pypi version](https://img.shields.io/pypi/v/spotDL)](https://pypi.org/project/spotdl/)
        [![pypi downloads](https://img.shields.io/pypi/dw/spotDL?label=downloads@pypi)](https://pypi.org/project/spotdl/)
        [![Discord](https://img.shields.io/discord/771628785447337985.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/xCa23pwJWY)
        ![GitHub commits since latest release (by date)](https://img.shields.io/github/commits-since/spotDL/spotify-downloader/latest)
        
        
        What spotDL does:
        
        1. Downloads music from YouTube as an MP3 file
        2. Applies basic metadata gathered from Spotify such as:
           - Track Name
           - Track Number
           - Album
           - Album Cover
           - Genre
           - and more!
        
        ### Announcing spotDL v3
        
        We rebuilt spotDL from scratch to be faster, simpler, and better than spotDL v2. Documentation is still a work in progress.
        
        ⚠ We have dropped the active development of spotDL v2 due to support and maintainability. No focused efforts will be made to resolve v2 specific issues.
        
        ### Join the [spotDL Discord!](https://discord.gg/xCa23pwJWY)!
        
        
        ## Installation
        
        You need to download FFmpeg to use this tool. Download and installation instructions can be found at [FFmpeg.org](https://ffmpeg.org/)
        
        ### Installing spotDL
        
        - Recommended Stable Version:
        
          ```
          $ pip install spotdl
          ```
        
        - Install directly from master: (Use if experiencing issues)
        
          ```
          $ pip install https://codeload.github.com/spotDL/spotify-downloader/zip/master
          ```
        
        - Dev Version: __(NOT STABLE)__
        
          ```
          $ pip install https://codeload.github.com/spotDL/spotify-downloader/zip/dev
          ```
        
        ___YouTube Music must be available in your country for spotDL to work. This is because we use YouTube Music to filter search results. You can check if YouTube Music is available in your country, by visiting [YouTube Music](https://music.youtube.com).___
        
        ## Usage (Instructions for v3)
        
        - To download a song, run:
        
          ```
          $ spotdl [trackUrl]
          ```
        
          ex. `spotdl https://open.spotify.com/track/0VjIjW4GlUZAMYd2vXMi3b?si=1stnMF5GSdClnIEARnJiiQ`
        
        
        - To download an album, run:
        
          ```
          $ spotdl [albumUrl]
          ```
        
          ex. `spotdl https://open.spotify.com/album/4yP0hdKOZPNshxUOjY0cZj?si=AssgQQrVTJqptFe7X92jNg`
        
        
        - To download a playlist, run:
        
          ```
          $ spotdl [playlistUrl]
          ```
        
          ex. `spotdl https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID?si=oGd5ctlyQ0qblj_bL6WWow`
        
        
        - To search for and download a song, run, __with quotation marks__:  
          _Note: This is not accurate and often causes errors._
        
          ```
          $ spotdl '[songQuery]'
          ```
        
          ex. `spotdl 'The Weeknd - Blinding Lights'`
        
        
        - To resume a failed/incomplete download, run:
        
          ```
          $ spotdl [pathToTrackingFile]
          ```
        
          ex. `spotdl 'The Weeknd - Blinding Lights.spotdlTrackingFile'`
        
          _`.spotdlTrackingFile`s are automatically created when a download starts and deleted on completion_
        
        
        You can queue up multiple download tasks by separating the arguments with spaces:
        
        ```
        $ spotdl [songQuery1] [albumUrl] [songQuery2] ... (order does not matter)
        ```
        
        ex. `spotdl 'The Weeknd - Blinding Lights' https://open.spotify.com/playlist/37i9dQZF1E8UXBoz02kGID?si=oGd5ctlyQ0qblj_bL6WWow ...`
        
        
        
        _spotDL downloads up to 4 songs in parallel, so for a faster experience, download albums and playlist, rather than tracks._
        
        ## `pipx` Isolated Environment Alternative
        
        For users who are not familiar with `pipx`, it can be used to run scripts __without__ installing the spotDL package and all the dependencies globally with pip. (Effectively skipping over the [Installation](https://github.com/spotDL/spotify-downloader#Installation) step)
        
        First, you will need to install `pipx` by running:
        
        ```
        python3 -m pip install --user pipx
        python3 -m pipx ensurepath
        ```
        
        Next, you can jump directly to running spotDL with:
        
        ```
        pipx run spotdl ...
        ```
        
        ## For Developers and Contributors
        
        1. Clone this repository
           ```
           $ git clone https://github.com/spotDL/spotify-downloader.git
           $ cd spotify-downloader
           ```
        2. Setup venv (Optional)
           - Windows
             ```
             $ py -3 -m venv env
             $ .\.venv\Scripts\activate
             ```
           - Linux/macOS
             ```
             $ python3 -m venv .venv
             $ source .venv/bin/activate
             ```
        3. Install requirements
           ```
           $ pip install -e .
           ```
        
        - Use as command (no need to re-install after file changes)
          ```
          $ spotdl [ARGUMENTS]
          ```
        
        ## Thank Yous
        
        1. [@ritiek](https://github.com/ritiek) for creating and maintaining spotDL for 4 years
        2. [@rocketinventor](https://github.com/rocketinventor) for figuring out YouTube Music querying
        3. [@Mikhail-Zex](https://github.com/Mikhail-Zex) for, never mind...
        
Keywords: spotify downloader download music youtube mp3 album metadata
Platform: UNKNOWN
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Multimedia
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: dev
