LimeWire Studio V 4.0

Python desktop audio studio for download, analysis, editing, stem separation, playlist transfer, and batch processing

Download • Analyze • Edit • Separate • Transfer • Batch Process

Quick Start • Feature Highlights • Docs • Application Overview • Roadmap

LimeWire is a Windows-friendly Python audio application that brings downloading, playback, analysis, editing, stem separation, playlist transfer, and batch processing into one desktop workspace. It is designed to feel like a practical production tool rather than a collection of disconnected utilities.

1. keeping common audio tasks in one desktop application instead of sending users between specialist tools
2. supporting both quick utility workflows and deeper production workflows, from grabbing a track to editing stems
3. pairing broad feature coverage with security controls, documentation, and release hygiene

# 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

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

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

# Run the automated installer
setup.bat

# 1. Install FFmpeg via Homebrew
brew install ffmpeg

# 2. Install core Python dependencies
pip3 install yt-dlp pillow requests mutagen pyglet

# 3. Launch
python3 LimeWire.py

Note: sounddevice requires PortAudio on macOS: brew install portaudio && pip install sounddevice pedalboard is fully supported on macOS (Apple Silicon and Intel). tkinterdnd2 requires: brew install python-tk

# 1. Install FFmpeg (Debian/Ubuntu)
sudo apt install ffmpeg python3-tk

# Fedora/RHEL:
# sudo dnf install ffmpeg python3-tkinter

# 2. Install core Python dependencies
pip3 install yt-dlp pillow requests mutagen pyglet

# 3. Launch
python3 LimeWire.py

Note: Audio playback uses sounddevice which requires libportaudio2: sudo apt install libportaudio2 && pip install sounddevice tkinterdnd2 on Linux: pip install tkinterdnd2 (no extra system packages needed on most distros)

Screenshots (20 of 25 tabs — Lyrics, Visualizer, Library, DJ, and Image Scraper tabs pending screenshots)

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

• 25 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

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

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.

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, 25 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)

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.

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

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

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.

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 for full details.

LimeWire is the most productized repository in the current set. The application already covers the full path from audio intake to analysis, editing, transfer, and batch processing, and it has the strongest release and desktop-tooling baseline.

Current documentation work is focused on making the repo easier to understand as an application: which workflows are strongest today, how the modular package is organized, and where optional dependencies or third-party services change the feature surface.

MIT License for the code in this repository.