Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nozwock/spotdl_gui
Simple GUI wrapper over spotDL, a Spotify downloader
https://github.com/nozwock/spotdl_gui
application music python song spotdl spotify
Last synced: 2 months ago
JSON representation
Simple GUI wrapper over spotDL, a Spotify downloader
- Host: GitHub
- URL: https://github.com/nozwock/spotdl_gui
- Owner: nozwock
- License: gpl-3.0
- Created: 2023-07-26T12:16:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-18T10:38:33.000Z (over 1 year ago)
- Last Synced: 2023-08-18T11:59:36.800Z (over 1 year ago)
- Topics: application, music, python, song, spotdl, spotify
- Language: Python
- Homepage:
- Size: 560 KB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# spotDL GUI
Simple GUI wrapper over [**spotDL**](https://github.com/spotDL/spotify-downloader), a Spotify downloader.
## Installation
> **Note**\
> Download the executable from the [GitHub release page](https://github.com/nozwock/spotdl_gui/releases) or install using `pipx`.
1. Install `pipx`.
```sh
python -m pip install --user pipx
python -m pipx ensurepath
```
2. Open a new terminal or re-login.
3. Install `spotdl_gui`
```sh
pipx install git+https://github.com/nozwock/spotdl_gui.git
```
- Run with `spotdl-gui`
### Prerequisites
**FFmpeg** is required for the GUI and spotDL to work.
On Windows, Install with:
```console
winget install -e --id Gyan.FFmpeg
```
## Usage
### Searches
You can search for multiple items at a time by separating them with a comma `','`. \
For example: `Aurora, Coolio, Full Confession`.
To use a comma as part of your search term without it acting as a separator, you can escape it with the backslash character `'\'`. \
For example: `This here\, will be escaped` will be treated as a literal string `This here, will be escaped`.
#### Reserved search terms
| Term | Description |
| -------------------- | ------------------------------- |
| `user:saved-tracks` | Spotify user's favourite tracks |
| `user:all-playlists` | Spotify user's all playlists |
#### Search prefixes
| Prefix | Description |
| ----------- | ------------------ |
| `album:` | Search by album |
| `playlist:` | Search by playlist |
| `artist:` | Search by artist |
### Downloads
Upon pressing the Download button, the selected tracks will be downloaded. You can choose all tracks at once with `Ctrl+A`, or individually by holding `Ctrl` and clicking on the desired tracks.
## Building
```sh
git clone https://github.com/nozwock/spotdl_gui.git
cd spotdl_gui
poetry install
poetry run spotdl-gui
```
### Building frozen app
```sh
poetry run python release/build.py
```
# Credits
## Assets
- https://boxicons.com
- https://www.svgrepo.com