spinback
spinback is a local web app to prepare tracks for mixing. It downloads from YouTube, YouTube Music, SoundCloud, Bandcamp and Mixcloud in the best format DJ software reads without re-encoding, with tags and cover art. It imports a Spotify or Deezer playlist from a screen recording (read by OCR) and finds it on YouTube. It previews, cuts and cleans a track (gain, loudness normalisation, equaliser, limiter) and exports FLAC. It browses your music folders: Traktor's when Traktor is installed, otherwise your Music folder. Traktor is an optional integration.
Quick start
Windows: paste this line in PowerShell. It installs uv and ffmpeg if they are missing, then starts spinback.
irm https://gitlab.com/leogermond/spinback/-/raw/main/install.ps1 | iex
macOS and Linux:
curl -LsSf https://gitlab.com/leogermond/spinback/-/raw/main/install.sh | sh
On macOS and Linux, install ffmpeg yourself if the script reports it missing
(brew install ffmpeg, sudo apt install ffmpeg).
Already have uv and ffmpeg? Run:
uvx --python 3.14 spinback
To install the command permanently:
pipx install spinback
# or
uv tool install spinback
The distribution, the command and the Python package are all named spinback.
Features
- Download from YouTube, YouTube Music, SoundCloud, Bandcamp and Mixcloud, untouched audio (no re-encoding) with tags and cover art.
- Import a Spotify or Deezer playlist by OCR and search each track on YouTube (details).
- Preview, cut and clean a track: gain, loudness normalisation, equaliser, limiter, FLAC export.
- Browse your music folders, from Traktor's collection when it is installed, else from the Music folder.
Usage
spinback serves the web GUI on http://127.0.0.1:8765 (the port of the
config, ~/.config/spinback/config.toml, else 8765) and opens it in the
browser, the Windows one under WSL. spinback --no-browser only serves it;
spinback gui --port … --music-dir … --traktor-dir … sets its options.
spinback --help lists the command-line steps (video-songs, yt-resolve,
yt-playlist, yt-download, playlists, songs).
Importing a Spotify or Deezer playlist (OCR)
Spotify and Deezer protect their sites with DRM and offer spinback no API: there is no account access and no playlist URL to give. spinback reads the playlist from what is on screen instead.
Record. On your phone, use the native screen recording (iOS or Android), open the playlist, then scroll slowly from the top to the bottom without pausing or stopping the recording. Screenshots work too: take several that overlap a little, so every track appears in at least one, and give them in scrolling order.
Supported apps. Spotify (dark theme) and Deezer (light theme), on iOS;
layouts are tuned for an iPhone in portrait. The app is detected from the
brightness of the screen, and --app spotify or --app deezer forces it.
Any resolution works, a copy recompressed by WhatsApp included.
Import. In the downloader, use the import button or drop the video or the
screenshots on it (several screenshots dropped together are sorted by file
name: rename them if that is not the scrolling order), or run
spinback video-songs <video> or spinback video-songs <shot1> <shot2> …
on the command line.
Then. spinback reads the tracks by OCR and searches each one on YouTube. It shows a score and alternatives for every match; validate them before downloading.
Known limits.
- Titles truncated by the app stay truncated.
- OCR sometimes misreads a letter.
- The first track can be cut off by the top of the screen.
- Accents and non-Latin characters are the least reliable.
Metadata
Release files for spinback 0.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| spinback-0.3.0.tar.gz | 130.5 kB | Without provenance | Details for spinback-0.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| spinback-0.3.0-py3-none-any.whl | Python 3 | none | any | Details for spinback-0.3.0-py3-none-any.whl |
Total release size: 273.9 kB
Release files / spinback-0.3.0.tar.gz
| Download URL | spinback-0.3.0.tar.gz |
|---|---|
| Size | 130.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e94c8aea53b39a02ddcaf4ae23c0a7157affacb1fc108fd62a6eae33a8f105ed
|
|
BLAKE2b-256 checksum How to use checksums |
3d43493a6ad80cf5b8159d0b406de9030c098d87e3a1fbc05a501e5840ef6a0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.13 {"installer":{"name":"uv","version":"0.9.13"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / spinback-0.3.0-py3-none-any.whl
| Download URL | spinback-0.3.0-py3-none-any.whl |
|---|---|
| Size | 143.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3153a38aa25461b9e5ee18fcdf221e36d79e9f677f9714af9c8ad022fc831836
|
|
BLAKE2b-256 checksum How to use checksums |
fd8260dd6a43233da095dcd58df00117669ef48942bd32c2e785772a3e242be3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.13 {"installer":{"name":"uv","version":"0.9.13"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for spinback 0.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.