Skip to content
rootscriptsPublic

About

Riff is the best, free music player with YouTube Music & SoundCloud library and WebGL shader visuals. No backend or telemetry. No paid tiers.

Topics

Resources

Stars

925 stars

Watchers

9 watching

Forks

Repository files navigation

Riff

Desktop music player for YouTube Music, SoundCloud, and local audio.

Release Downloads Platforms License

Overview • Features • Architecture • Getting Started • Building • macOS Notes • Contributing • License


изображение

Overview

Riff is the best open-source desktop music player for Windows, Linux, and macOS. It streams from YouTube Music, YouTube, and SoundCloud without ads, and plays local audio files (FLAC, WAV, MP3, OGG).

No account or subscription required. No tracking or telemetry. Never.


Features

  • Streaming & local: Stream from YouTube Music, YouTube, and SoundCloud without ads, or play local lossless tracks (FLAC, WAV, MP3, OGG, M4A).
  • Syllable-synced Lyrics: Syllable and timestamped lyrics with support for .lrc files, manual timing offset, and translations.
  • Audio editor, presets: 10-band equalizer, playback speed and pitch control with presets, reverb, bass boost, clear sound function, volume normalizer, and an in-app sleep timer. Provides also presets tab to switch between your custom or our official presets like slowed + reverb, nightcore.
  • Playlist import: Import public playlists from Spotify, Apple Music, Deezer, VK Music, Yandex Music, YouTube Music and YouTube directly into your library with synchronization so you don't miss new tracks in the playlist.
  • Visualizers: WebGL and canvas audio visualizers (3 types available: wave, bars, swift).
  • Interface & Themes: Theme customizer with dynamic colors extracted from album art, plus a built-in CSS editor for custom styles, intensity, monochrome brightness, brightness slider, with 20+ icons available and custom icon available also.
  • Discord RPC: Shows the active track, artist, and playback progress in Discord.
  • Plugins: Extensible system for custom functionality and custom .css themes.

Architecture

Riff is built with Electron and runs an internal proxy server alongside a Vanilla JS and WebGL renderer.

riff/
├── assets/              # Icons and UI presets
├── scripts/             # Build and packaging scripts
├── src/
│   ├── main/            # Electron main process
│   │   ├── main.js      # App lifecycle, window management, and IPC
│   │   ├── discord.js   # Discord Rich Presence
│   │   ├── launcher.js  # yt-dlp and ffmpeg runner
│   │   ├── plugins.js   # Plugin loader
│   │   ├── preload.js   # Context bridge to renderer
│   │   ├── themes.js    # Theme and custom CSS handler
│   │   └── updater.js   # Auto-update manager
│   ├── renderer/        # Frontend UI (Vanilla JS & HTML5)
│   │   ├── audio.js     # Web Audio API playback engine
│   │   ├── styles.css   # Main stylesheet
│   │   └── modules/     # UI modules
│   │       ├── eq.js    # Equalizer and audio filters
│   │       ├── lyrics.js# Synced lyrics renderer and parser
│   │       ├── visualizer.js # WebGL and canvas visualizers
│   │       ├── library.js    # Local file indexing
│   │       ├── import.js     # Playlist importer
│   │       └── ui.js         # UI controls and color extraction
│   ├── server/          # Local backend proxy
│   │   ├── server.js    # Stream resolution and caching
│   │   └── tools.js     # Media extractors
│   └── shared/          # Shared constants and schemas
├── vendor/              # Bundled binaries
├── package.json
└── LICENSE

Getting Started

Prerequisites

  • Node.js 18+
  • npm

Setup

git clone https://github.com/rootscripts/riff.git
cd riff
npm install

Running in Development

npm start

Building

# Build for your current OS (output goes to dist/)
npm run dist

Pre-built binaries for Windows (.exe), Linux (.AppImage), and macOS (.dmg) are also available on Releases.


macOS Notes

macOS releases are ad-hoc signed. If Gatekeeper blocks the app on first launch:

  1. Right-click Riff.app in /Applications, click Open, and confirm. On macOS 15+, open System Settings → Privacy & Security and select Open Anyway.
  2. If macOS reports the bundle as damaged, run:
    xattr -cr /Applications/Riff.app
  3. On Apple Silicon, installing dependencies via Homebrew is recommended:
    brew install yt-dlp ffmpeg

Contributing

Contributing is not welcome and we will never open pull request tab, the app is developed exclusively by our core team, please do not write us if you want to join or something


License

Distributed under the MIT License.

About

Riff is the best, free music player with YouTube Music & SoundCloud library and WebGL shader visuals. No backend or telemetry. No paid tiers.

Topics

Resources

Stars

925 stars

Watchers

9 watching

Forks

Releases

Packages

Contributors

Languages