Skip to main content

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.

pipeline status coverage

Linter: ruff Code style: black Copier

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)

Source distribution for spinback 0.3.0
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)

Table of built distributions (wheels) for spinback 0.3.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page