A modern desktop GUI for streamrip
A polished interface for managing your media library — no terminal required.

streamrip-ui is an Electron-based desktop application that wraps nathom's streamrip library in a polished, dark-themed interface. It provides a visual experience designed for daily use, replacing the CLI workflow entirely.

Note: This project does not bundle or redistribute streamrip. It depends on a local checkout of the streamrip repository as its backend engine.

• Paste & Go — Drop a URL and get a full preview in one click
• Real-Time Progress — Per-item progress bars with speed and ETA via a custom progress hook
• Rich Previews — Album, track, artist, and playlist views with cover art, tracklists, and quality badges
• Multi-Source Search — Search across supported platforms with instant results
• Queue Management — Concurrent processing with queue, history, and wishlist
• Full Configuration — Every streamrip setting exposed: quality, filepaths, filters, metadata, conversion, database
• Keyboard Shortcuts — Ctrl+1—6 navigation, Ctrl+F search focus, Escape to dismiss
• Drag & Drop — Drop URLs directly onto the window to start previewing
• Backend Health Monitoring — Live status indicator with auto-reconnect
• Toast Notifications — Status updates for every action — always in the loop

Paste a URL to instantly preview content with full metadata

Search across multiple platforms with instant results

Real-time progress tracking with speed and ETA

Complete history of all processed items

Save items to your wishlist for later

Full configuration — sources, quality, filepaths, and more

Go to Releases and download:

• Python 3.10+ installed and on your PATH
• streamrip dependencies: the app will install them automatically on first launch, or you can install manually:

cd repo
pip install poetry
poetry install

# Clone the repo
git clone https://github.com/netz-sg/streamrip-ui.git
cd streamrip-ui

# Install frontend dependencies
cd desktop/frontend
npm install

# Install Electron dependencies
cd ..
npm install

# Run in development mode
npm start

# Build installer
npm run dist          # Current platform
npm run dist:win      # Windows .exe
npm run dist:mac      # macOS .dmg

1. Launch the app — the Python backend starts automatically
2. Paste a URL into the input bar on the Home page
3. Preview the content with full metadata
4. Process with one click — monitor progress in the queue
5. Configure quality, output paths, filters, and more in Settings

streamrip-ui/
├── desktop/
│   ├── electron/              # Electron main process
│   │   ├── main.js                # Window creation, backend spawn
│   │   └── preload.js             # Context bridge
│   ├── frontend/              # React + TypeScript + Tailwind
│   │   ├── public/                # Static assets & logo
│   │   └── src/
│   │       ├── api/               # HTTP & WebSocket clients
│   │       ├── components/
│   │       │   ├── layout/        # AppShell, Sidebar, TitleBar
│   │       │   └── previews/      # Album, Track, Artist, Playlist views
│   │       ├── hooks/             # useKeyboardShortcuts, etc.
│   │       ├── pages/             # Home, Downloads, Search, Settings, History, Wishlist
│   │       ├── stores/            # Zustand state management
│   │       └── styles/            # Global CSS
│   ├── backend/               # Python FastAPI server
│   │   ├── main.py                # App entry, health endpoint
│   │   ├── api/
│   │   │   ├── endpoints/         # REST routes (config, download, search, url, wishlist)
│   │   │   ├── schemas/           # Pydantic request/response models
│   │   │   └── websocket.py       # WebSocket for real-time progress
│   │   └── core/
│   │       ├── compat_check.py    # Startup compatibility validation
│   │       ├── download_manager.py
│   │       ├── progress_hook.py   # Real-time progress tracking
│   │       ├── streamrip_wrapper.py  # Hardened adapter layer
│   │       └── wishlist.py
│   └── tests/                 # Compatibility tests
├── repo/                      # streamrip library (git submodule)
└── .github/workflows/         # CI: compat checks, release builds

• streamrip by @nathom — the core engine that powers this application
• Built with Electron, React, FastAPI, and Tailwind CSS

This project is licensed under the GNU General Public License v3.0 — the same license as streamrip.

This application is provided for personal use only. The developers are not responsible for any misuse of this software.