Metadata-Version: 2.4
Name: spinback
Version: 0.2.0
Summary: A local web GUI to browse a Traktor music library and download playlists from YouTube as tagged audio files
Author: leogermond
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Requires-Dist: beautifulsoup4>=4.14.3
Requires-Dist: click>=8.3.1
Requires-Dist: contractme>=2
Requires-Dist: epycs>=2
Requires-Dist: fastapi>=0.162.0
Requires-Dist: more-itertools>=10.8.0
Requires-Dist: mutagen>=1.48.1
Requires-Dist: pillow>=12
Requires-Dist: rapidocr-onnxruntime>=1.4.4
Requires-Dist: requests>=2.32.5
Requires-Dist: requests-cache>=1.3.1
Requires-Dist: selenium>=4.41.0
Requires-Dist: selenium-requests>=2.0.4
Requires-Dist: uvicorn>=0.54.0
Requires-Dist: yt-dlp>=2026.8.19
Requires-Python: >=3.14
Project-URL: Homepage, https://gitlab.com/leogermond/spinback
Project-URL: Repository, https://gitlab.com/leogermond/spinback
Description-Content-Type: text/markdown

# spinback


[![pipeline status](https://gitlab.com/leogermond/spinback/badges/main/pipeline.svg)](https://gitlab.com/leogermond/spinback/-/commits/main)
![coverage](https://gitlab.com/leogermond/spinback/badges/main/coverage.svg?job=test)

[![Linter: ruff](https://img.shields.io/badge/Linter-Ruff-brightgreen?style=flat-square)](https://github.com/charliermarsh/ruff)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
[![Copier](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/copier-org/copier/master/img/badge/badge-grayscale-inverted-border-orange.json)](https://github.com/copier-org/copier)

## Installation

```sh
pipx install spinback
# or
uv tool install spinback
```

The distribution, the command and the Python package are all named `spinback`.

## 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`).
