Metadata-Version: 2.4
Name: SpotiFLAC
Version: 0.1.5
Summary: Get Spotify tracks in true FLAC from Tidal, Qobuz & Amazon Music — no account required.
Author: ShuKurenais
License-Expression: MIT
Project-URL: Repository, https://github.com/ShuShuzinhuu/SpotiFLAC-Module-Version
Keywords: spotify,downloader,python,async,library,api
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests~=2.32.3
Requires-Dist: mutagen~=1.47.0
Requires-Dist: pyotp~=2.9.0
Dynamic: license-file

<h1>SpotiFLAC-Command-Line-Interface</h1>
<p>Command Line Interface version of SpotiFLAC.<br>
    Also available as a python module.</p>
<h2>Arguments</h2>
<i>service {tidal,qobuz,deezer,amazon}</i><br>
Specify the music service to use for downloading FLAC files. Specify multiple services separated by spaces to try them in order. Default is 'tidal'.<br><br>
<i>filename-format {title_artist,artist_title,title_only}</i><br>
Specify the format for naming downloaded files. Default is 'title_artist'.<br><br>
<i>use-track-numbers</i><br>
Include track numbers in the filenames.<br><br>
<i>use-artist-subfolders</i><br>
Organize downloaded files into subfolders by artist.<br><br>
<i>use-album-subfolders</i><br>
Organize downloaded files into subfolders by album.<br><br>
<i>loop minutes</i><br>
Specify the duration in minutes to keep retrying downloads in case of failures. Default is 0 (no retries).<br>

<h2>CLI usage</h2>

<h4>Windows:</h4>

```bash
./SpotiFLAC-Windows.exe [url]
                        [output_dir]
                        [--service tidal qobuz deezer amazon]
                        [--filename-format {title_artist,artist_title,title_only}]
                        [--use-track-numbers] [--use-artist-subfolders]
                        [--use-album-subfolders]
                        [--loop minutes]
```

<h4>Linux / Mac:</h4>

```bash
chmod +x SpotiFLAC-Linux
./SpotiFLAC-Linux [url]
                  [output_dir]
                  [--filename-format {title_artist,artist_title,title_only}]
                  [--use-track-numbers] [--use-artist-subfolders]
                  [--use-album-subfolders]
                  [--loop minutes]
```

<h2>Python Module Usage</h2>

```bash
from SpotiFLAC import SpotiFLAC

SpotiFLAC(
    url,
    output_dir,
    services=["tidal", "deezer", "qobuz", "amazon"],
    filename_format="title_artist",
    use_track_numbers=False,
    use_artist_subfolders=False,
    use_album_subfolders=False,
    loop=None
)
```

<h3>Example</h3>

```bash
from SpotiFLAC import SpotiFLAC

SpotiFLAC(
    url="https://open.spotify.com/album/xyz",
    output_dir="/path/to/output_dir",
    services=["tidal", "deezer"],
    filename_format="artist_title",
    use_track_numbers=True,
    use_artist_subfolders=True,
    use_album_subfolders=True,
    loop=120
)

```
