rootscripts / riff
git clone https://github.com/rootscripts/riff.git
v42.3.0 · 2d ago
Your desktop music player.
—
stars, 24h
—
stars, 7 days
+138
stars, 30 days · #1,726
138
★ total
18
forks · 4 open issues
Star history starts 2026-10-20; the chart appears after the second daily snapshot.
LanguageJavaScript
LicenseMIT
Created2026-10-04 (16d ago)
Last pushtoday
Watchers1
OwnerUser
GitHub topics
Links
- GitHub: github.com/rootscripts/riff
- Homepage: https://t.me/riffplayer
- Releases · Issues · Hacker News mentions
README excerpt
Riff A free, open-source desktop music player for YouTube Music, SoundCloud, and local files. Built with Material Design 3, no tracking, and no account needed. Download · Features · Audio Suite · Interface · Install · FAQ · Build ## What is Riff? Riff is an open-source, telemetry-free desktop audio hub and player for **Windows, Linux, and macOS**. It unifies playback across **YouTube Music**, **YouTube**, **SoundCloud**, and offline local media into a single high-performance interface without ads, subscriptions, or login constraints. Built with **Electron**, **Vanilla JavaScript**, and **WebGL**, Riff provides responsive UI interactions and hardware-accelerated audio visualization without runtime framework overhead. The project is distributed under the **MIT license** and enforces strict privacy: all configuration, cached streams, and playback history remain strictly on the local machine. ## Core Features - **Ad-Free Streaming Hub**: Native stream resolution for YouTube Music, YouTube, and SoundCloud without third-party advertisements or account requirements. - **Offline Lossless Playback**: Full local library support for high-resolution formats including FLAC, WAV, MP3, OGG, and M4A. - **Built-in Audio Suite**: Integrated visual waveform editor for lossless trimming, 10-band equalizer, and real-time DSP effects (tempo, pitch shifting, studio reverb, distortion). - **1-Click Multi-Platform Playlist Migration**: Direct import and resolution of public playlists from Spotify, Apple Music, YouTube Music, and SoundCloud. - **Material Design 3 (M3 Expressive) UI**: Dynamic color extraction from album artwork, deep UI theming, responsive layout presets, and an integrated CSS editor. - **Hardware-Accelerated Visuals**: Canvas and WebGL visualizers including real-time frequency analyzers, an interactive squiggly progress scrubber, and synchronized karaoke lyrics. - **Discord Rich Presence**: Real-time playback status reporting track metadata, artist info, and elapsed time to Discord. - **Zero Telemetry**: No tracking identifiers, analytics pings, or background data collection. ## Built-in Audio Suite Riff includes an integrated audio engineering toolkit accessible directly within the player interface: ### Visual Audio Editor - **Lossless Audio Trimming**: Define start and end boundaries to trim tracks without transcoding loss. - **Region Extraction**: Select and isolate specific audio segments to save as standalone files. - **Non-Destructive Processing**: Edit operations produce independent files while preserving original source media untouched. ### 10-Band Parametric Equalizer - Dedicated frequency sliders covering 32 Hz through 16 kHz with pre-configured acoustic profiles (Bass Boost, Vocal Clarity, Electronic, Flat, Rock). - Per-channel gain adjustments with real-time Web Audio API signal processing. ### Real-Time DSP Effects Chain - **Tempo Control**: Dynamically speed up or slow down playback rate without altering pitch. - **Pitch Shifting