- Автор
- rootscripts
- Размер
- 8.9 MB
- Звёзды
- 935
- Обновлён
- КоммитNov 17Релизv0.7.6Nov 14
- Возраст
- 1 мес
- Коммиты · 90 дней
README проекта с github.com/rootscripts/riff. Одним файлом markdown: README.md.
Desktop music player for YouTube Music, SoundCloud, and local audio.
Overview • Features • Architecture • Getting Started • Building • macOS Notes • Contributing • License
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.
.lrc files, manual timing offset, and translations.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
18+git clone https://github.com/rootscripts/riff.git
cd riff
npm install
npm start
# 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 releases are ad-hoc signed. If Gatekeeper blocks the app on first launch:
Riff.app in /Applications, click Open, and confirm. On macOS 15+, open System Settings → Privacy & Security and select Open Anyway.xattr -cr /Applications/Riff.app
brew install yt-dlp ffmpeg
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
Distributed under the MIT License.