https://github.com/ccwilliams314/limewire

LimeWire is a 20-tab all-in-one audio production studio built with Python and tkinter. It started as a simple YouTube downloader and evolved into a comprehensive music utility — from downloading and converting, to analysis, editing, stem separation, remixing, and batch processing.
https://github.com/ccwilliams314/limewire
audio audio-analysis audio-editor demucs music-production python stems tkinter youtube-downloader yt-dlp
Last synced: 3 months ago
JSON representation
Host: GitHub
URL: https://github.com/ccwilliams314/limewire
Owner: Ccwilliams314
License: mit
Created: 2026-03-09T05:51:26.000Z (4 months ago)
Default Branch: main
Last Pushed: 2026-04-04T07:05:38.000Z (3 months ago)
Last Synced: 2026-04-04T07:05:56.315Z (3 months ago)
Topics: audio, audio-analysis, audio-editor, demucs, music-production, python, stems, tkinter, youtube-downloader, yt-dlp
Language: Python
Homepage: https://github.com/Ccwilliams314/LimeWire
Size: 6.61 MB
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project

README

          







# LimeWire Studio Edition

### The Swiss Army Knife of Audio Production

[![Python 3.10+](https://img.shields.io/badge/python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white)](https://python.org)

[![License: MIT](https://img.shields.io/github/license/Ccwilliams314/LimeWire?style=for-the-badge&color=2ECC71)](LICENSE)

[![GitHub Stars](https://img.shields.io/github/stars/Ccwilliams314/LimeWire?style=for-the-badge&color=FFD600&logo=github)](https://github.com/Ccwilliams314/LimeWire/stargazers)

[![Latest Release](https://img.shields.io/github/v/release/Ccwilliams314/LimeWire?style=for-the-badge&color=00E5FF)](https://github.com/Ccwilliams314/LimeWire/releases)

[![CI](https://img.shields.io/github/actions/workflow/status/Ccwilliams314/LimeWire/check.yml?style=flat-square&label=CI&logo=github)](https://github.com/Ccwilliams314/LimeWire/actions)

[![Issues](https://img.shields.io/github/issues/Ccwilliams314/LimeWire?style=flat-square&color=FF1744)](https://github.com/Ccwilliams314/LimeWire/issues)

![25 Tabs](https://img.shields.io/badge/tabs-25-2ECC71?style=flat-square)

![15 Themes](https://img.shields.io/badge/themes-15-BD93F9?style=flat-square)

![6 Languages](https://img.shields.io/badge/languages-6-FF9E64?style=flat-square)

![195 Tests](https://img.shields.io/badge/tests-195-00E676?style=flat-square)

**Download • Play • Analyze • Edit • Separate • Remix • Transfer • Process**

[Getting Started](#-quick-start) • [Features](#-features) • [Screenshots](#-screenshots) • [Themes](#-themes) • [Architecture](#-architecture)



---

## What is LimeWire?

A **25-tab all-in-one audio production studio** built with Python and tkinter. From simple YouTube downloads to AI-powered stem separation, professional audio analysis, non-destructive editing, cross-platform playlist transfers, and batch processing — all in a single app with 15 themes and 6 languages.

### Headline Features

| | Feature | What it does |

|---|---------|-------------|

| :arrow_down: | **1000+ Site Downloads** | YouTube, Spotify, SoundCloud, Bandcamp via yt-dlp |

| :brain: | **AI Stem Separation** | Vocals, drums, bass, guitar, piano via Demucs |

| :bar_chart: | **Audio Analysis** | BPM, key, Camelot, LUFS, waveform, spectrogram |

| :mag: | **Track Identification** | Shazam, MusicBrainz, Chromaprint, Apple Music |

| :scissors: | **Non-Destructive Editor** | Cut, trim, fade, merge with full undo/redo |

| :microphone: | **Recording + Whisper** | Mic capture with AI transcription and SRT export |

| :control_knobs: | **Effects Chain** | Gain, compressor, reverb, delay, chorus, filters |

| :musical_score: | **Stem Remixer** | Per-stem volume, pan, mute/solo mixing console |

| :zap: | **Batch Processor** | Normalize, convert, fade, trim silence at scale |

| :repeat: | **Cross-Platform Transfers** | Sync playlists, liked songs, artists between Spotify, YouTube, TIDAL, Deezer, SoundCloud |

| :art: | **15 Live Themes** | Switch instantly — no restart, includes custom theme loader |

---

## :rocket: Quick Start

```bash

# Prerequisites: Python 3.10+ and FFmpeg on PATH

winget install ffmpeg

# Core install (download + playback)

pip install yt-dlp pillow requests mutagen pyglet

# Launch

python LimeWire.py

# or: python -m limewire

```

Optional modules — install only what you need

```bash

pip install librosa soundfile pyloudnorm   # BPM/key/loudness analysis

pip install musicbrainzngs pyacoustid      # Track identification

pip install shazamio                       # Shazam (Python <=3.12)

pip install demucs                         # AI stem separation (needs PyTorch)

pip install pydub sounddevice pyrubberband # Editing & recording

pip install openai-whisper                 # Whisper transcription

pip install pedalboard                     # Audio effects (Spotify)

pip install pyflp                          # FL Studio integration

pip install tkinterdnd2                    # Drag & drop

```

**All-in-one:**

```bash

pip install yt-dlp pillow requests mutagen pyglet librosa soundfile pyloudnorm musicbrainzngs pyacoustid demucs pydub sounddevice pyrubberband openai-whisper pedalboard

```

> The status bar shows module count (e.g., `12/14`). Click it to see what's missing.

### Windows One-Click Setup

```bash

# Run the automated installer

setup.bat

```

---

## :camera: Screenshots

Screenshots (20 of 25 tabs)

Search & Grab


Batch Download


Playlist


Converter


Player


Analyze


Stems (AI)


Effects


Discovery


Samples


Editor


Recorder


Spectrogram


Pitch/Time


Remixer


Batch Process


Scheduler


History


Cover Art


Settings


---

## :sparkles: Features

### Download & Library

| Tab | Capabilities |

|-----|-------------|

| **Search & Grab** | Paste any URL, auto-detect source, choose format (MP3/WAV/FLAC/OGG/M4A/AAC/OPUS), quality selector |

| **Batch Download** | Queue multiple URLs, persistent queue, retry failed, progress tracking |

| **Playlist** | YouTube playlist fetch, cross-service transfer (Spotify, YouTube, TIDAL, Deezer, SoundCloud, Apple Music, Amazon Music), sync liked songs, artists, albums |

| **Converter** | Format conversion via ffmpeg, metadata preservation |

| **History** | Searchable download log with replay and management |

| **Scheduler** | Schedule downloads for specific times with background polling |

| **Cover Art** | View, add, fetch (iTunes/MusicBrainz), batch-apply album artwork |

### Playback & Analysis

| Tab | Capabilities |

|-----|-------------|

| **Player** | Waveform display, EQ spectrum, album art, speed control, A-B loop, crossfade, M3U playlists |

| **Analyze** | BPM, key, Camelot, LUFS, true peak. Shazam/MusicBrainz/Chromaprint/Apple Music identification |

| **Discovery** | Library scanner, BPM/key caching, harmonic mixing suggestions, smart playlists, CSV export |

| **Spectrogram** | Linear/Mel/CQT with viridis/magma/plasma/inferno colormaps, PNG export |

### Production & Editing

| Tab | Capabilities |

|-----|-------------|

| **Stems** | AI separation via Demucs (htdemucs, htdemucs_ft, mdx_extra) — vocals, drums, bass, other, piano, guitar |

| **Remixer** | Mix stems: per-stem volume (0-150%), pan (L-R), mute/solo, preview, export |

| **Editor** | Non-destructive trim/cut/fade/merge, undo/redo, waveform selection, 32x zoom |

| **Recorder** | Mic recording, VU meter, live waveform, Whisper AI transcription, SRT export |

| **Pitch/Time** | Pitch shift (semitones), time stretch, BPM auto-detect, vocal isolation |

| **Effects** | Pedalboard chain: gain, compressor, limiter, reverb, delay, chorus, filters. Save/load presets |

| **Batch Process** | Bulk normalize loudness (dBFS), convert format, fade in/out, trim silence, strip metadata |

| **Samples** | Freesound.org browser with preview and download |

| **Lyrics** | Fetch and display synced lyrics, search by title/artist |

| **Visualizer** | Real-time audio visualizations with multiple modes |

| **Library** | Local music library management with smart folders |

| **DJ** | Dual-deck mixing with crossfader and BPM sync |

| **Image Scraper** | Web image extraction, SoundCloud artwork, MP3+art download |

### Settings & Customization

- **15 built-in themes** with instant live switching (no restart)

- **Community theme loader** — load custom JSON themes via Tools menu

- **Skin Customizer** (`skin_customizer.py`) — visual theme editor with live preview

- **6 languages** — English, Spanish, French, German, Japanese, Portuguese

- **Plugin system** — SHA-256 hash-trusted custom audio processors

- **VST3/AU hosting** — load VST3 plugins in the effects chain

- **MIDI Learn** — map hardware controllers in the Remixer

- **Discord Rich Presence** — show currently playing track

- **Cloud sync** — export/import settings to Dropbox/OneDrive/Google Drive

---

## :keyboard: Keyboard Shortcuts

| Shortcut | Action |

|----------|--------|

| `Ctrl+K` | Command Palette — fuzzy search pages, history, library |

| `Ctrl+D` | Download / Grab URL |

| `Ctrl+O` | Open downloads folder |

| `Space` | Play / Pause |

| `Ctrl+Right/Left` | Next / Previous track |

| `Ctrl+Up/Down` | Volume up / down |

| `Shift+Escape` | Quick close |

| `Ctrl+?` | Show shortcuts dialog |

---

## :art: Themes

15 built-in themes with **instant live switching** — no restart required:

| Theme | Preview |

|-------|---------|

| **LiveWire** (default) | Electric cyan on dark navy |

| **Light** | Clean white, green accents |

| **Dark** | Rich dark, green accents |

| **Modern** | GitHub-inspired, high contrast |

| **Synthwave** | Neon pink/purple retro |

| **Dracula** | Purple/pink, dev favorite |

| **Catppuccin** | Soft pastels, easy on the eyes |

| **Tokyo Night** | Blue-tinted calm palette |

| **Spotify** | Green on black |

| **Classic** | OG lime green nostalgia |

| **Nord** | Arctic blue-grey |

| **Gruvbox** | Warm retro earth tones |

| **High Contrast** | Maximum accessibility |

| **Solarized** | Precision colors, reduced eye strain |

| **Monokai** | Vibrant developer classic |

Each theme defines **37 semantic color tokens** (backgrounds, text, accents, borders, cards, states, surfaces, focus rings) for pixel-perfect consistency across all 25 tabs.

**Create your own:** Run `python skin_customizer.py` to visually design custom themes and export them as JSON files loadable via **Tools > Load Community Theme**.

---

## :building_construction: Architecture

LimeWire ships as both a **modular package** (`limewire/`) and a backward-compatible **single-file launcher** (`LimeWire.py`):

```

LimeWire/

  LimeWire.py                 # Thin launcher (backward compat)

  skin_customizer.py          # Visual theme editor

  limewire/

    __init__.py               # __version__ = "4.0.0"

    __main__.py               # python -m limewire

    app.py                    # App(tk.Tk) main class

    core/

      theme.py                # T namespace, 15 themes, apply_theme()

      constants.py            # Timing, dimension, format constants

      config.py               # JSON persistence, file paths

      platform.py             # OS detection

      deps.py                 # Optional dependency flags & lazy loaders

      audio_backend.py        # Playback engine

    i18n/                     # 6-language localization

    utils/                    # Helpers, sanitization

    services/

      analysis.py             # BPM/key, loudness, harmonics, Camelot

      metadata.py             # Shazam, MusicBrainz, AcoustID, lyrics

      cover_art.py            # Extract/embed/fetch album artwork

      audio_processing.py     # Waveform, demucs, pydub, spectrogram

      connectors/             # Music service connectors (7 services)

        base.py               # ConnectorBase ABC, TrackResult, PlaylistResult

        oauth.py              # OAuth 2.0 with PKCE + CSRF state

        storage.py            # DPAPI-encrypted token storage

        spotify.py            # Spotify connector

        youtube.py            # YouTube Music connector

        tidal.py              # TIDAL connector

        soundcloud.py         # SoundCloud connector

        deezer.py             # Deezer connector

        transfer.py           # Cross-service playlist/library transfer engine

    security/                 # Path confinement, subprocess allowlist, JSON validation

    ui/                       # Widgets, styles, tooltips, toasts, command palette

    pages/                    # 25 page classes (one per tab)

  tests/                      # 195 tests (pytest)

```

### Module Dependency Flow

```

core/ <-- utils/ <-- services/ <-- ui/ <-- pages/ <-- app.py

         ^                                              ^

     security/                                     __main__.py

```

Pages receive `app` as a constructor arg — they never import `app.py` directly. No circular imports.

### Security Layer

| Module | Purpose |

|--------|---------|

| `safe_paths.py` | Path traversal prevention, atomic writes, symlink checks |

| `safe_subprocess.py` | Binary allowlist (ffmpeg, ffprobe, yt-dlp only) |

| `safe_json.py` | Size limits (5 MB), depth checks (10), key allowlists |

| `plugin_policy.py` | SHA-256 hash trust — scan without execute |

| `connectors/oauth.py` | OAuth 2.0 PKCE + CSRF state validation for all services |

| `connectors/storage.py` | Windows DPAPI token encryption at rest |

| `network.py` | SSRF prevention — DNS resolution checks, public IP validation |

### Connector Security

All 7 music service connectors are hardened with:

- **OAuth 2.0 PKCE** — Proof Key for Code Exchange prevents authorization code interception

- **CSRF Protection** — Cryptographic state parameter validates OAuth callbacks

- **Encrypted Storage** — Tokens encrypted at rest via Windows DPAPI (`CryptProtectData`)

- **Input Validation** — Regex-based ID validation on all service-specific identifiers

- **SSRF Prevention** — URL domain allowlists block server-side request forgery

- **Error Sanitization** — Tokens and secrets stripped from error messages before display

### Data Files

All stored in `~/.limewire_*.json`: history, settings, schedule, queue, analysis cache, session state, recent files.

---

## :test_tube: Testing

```bash

pip install pytest

python -m pytest tests/ -v

```

**195 tests** covering security modules, core systems, utilities, and services. CI runs on Python 3.10 through 3.14.

---

## :wrench: Tech Stack

| | Component | Technology |

|---|-----------|-----------|

| :snake: | Language | Python 3.10+ (tested through 3.14) |

| :desktop_computer: | GUI | tkinter / ttk |

| :arrow_down: | Downloads | yt-dlp |

| :speaker: | Playback | pyglet |

| :label: | Metadata | mutagen |

| :gear: | Processing | pydub, ffmpeg |

| :bar_chart: | Analysis | librosa, pyloudnorm |

| :brain: | AI Stems | Demucs (Meta AI) |

| :musical_note: | Pitch/Time | pyrubberband |

| :microphone: | Recording | sounddevice |

| :speech_balloon: | Transcription | openai-whisper |

| :control_knobs: | Effects | pedalboard (Spotify) |

| :mag: | Track ID | shazamio, pyacoustid, musicbrainzngs |

---

## :books: Documentation

| Document | Description |

|----------|-------------|

| [Wiki](https://github.com/Ccwilliams314/LimeWire/wiki) | Complete documentation for every module and page (34 pages) |

| [CONTRIBUTING.md](CONTRIBUTING.md) | Developer guide, project structure, how to contribute |

| [SECURITY.md](SECURITY.md) | Security policy, vulnerability scan report |

| [CHANGELOG.md](CHANGELOG.md) | Version history |

| [ROADMAP.md](ROADMAP.md) | Feature roadmap |

---

## :handshake: Contributing

1. Fork & clone

2. `pip install -r requirements.txt`

3. Create a branch, make changes

4. Run tests: `python -m pytest tests/ -v`

5. Submit a PR

See [CONTRIBUTING.md](CONTRIBUTING.md) for full details.

---

## :scroll: License

[MIT License](LICENSE) — free for personal and commercial use.

---



_{"Definitely virus-free since 2024"}
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/ccwilliams314/limewire

Awesome Lists containing this project

README
