riff README

README проекта с github.com/rootscripts/riff. Одним файлом markdown: README.md.

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


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


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.

riff (rootscripts/riff)

Ищем в базе…

935 ·GitHub
Что это такое?Riff — бесплатный музыкальный проигрыватель для компьютера с открытым исходным кодом, который объединяет YouTube Music, YouTube, SoundCloud и локальные файлы в одном интерфейсе. Создан на Electron, без рекламы, аккаунтов и отслеживания.
Это приложение на Electron или что-то полегче?Это полноценное настольное приложение на Electron, написанное на Vanilla JavaScript с использованием WebGL для отрисовки, а не легковесный нативный клиент.
Как установить Riff?Скачайте готовый бинарный файл на странице Releases; сборки для Windows и Linux включают yt-dlp и ffmpeg, так что дополнительная настройка среды не нужна. Сборки для macOS не подписаны и являются экспериментальными: нужно открыть приложение через правый клик и «Открыть», а для нужных бинарников потребуется Homebrew.
Сборка для macOS полностью готова, и есть ли официальные мобильные приложения?Поддержка macOS пока экспериментальная, а приложение не подписано, поэтому его нужно разрешить вручную. Официального приложения для Android или iOS нет, есть только форки от сообщества.
Можно ли пользоваться Riff без интернета?Да, скачанные треки, сохранённые аудиофрагменты и проиндексированные локальные библиотеки полностью работают офлайн.
Riff отслеживает или отправляет мои данные о прослушивании?Нет. Riff не собирает никакой телеметрии и хранит все настройки, кешированные потоки и историю воспроизведения строго на вашем компьютере.
Riff действительно бесплатный, без платной версии?Да, Riff распространяется по разрешительной лицензии MIT без подписок, платных стен и премиум-тарифов.
Можно ли перенести мои плейлисты из Spotify в Riff?Да, достаточно вставить ссылку на публичный плейлист Spotify, Apple Music, YouTube Music или SoundCloud, и Riff найдёт треки и создаст редактируемый локальный плейлист, даже если в нём 100+ треков.
Какое редактирование аудио можно делать в приложении?В Riff есть встроенный визуальный редактор для обрезки без потерь и извлечения фрагментов, 10-полосный параметрический эквалайзер и эффекты DSP в реальном времени: темп, высота тона, реверберация и искажение.
Отображается ли Riff в Discord?Да, есть нативный Discord Rich Presence, который показывает название и исполнителя текущего трека, прошедшее время и платформу-источник.
Можно ли изменить внешний вид или поведение Riff?Riff поддерживает динамическую цветовую тему Material Design 3, встроенный редактор CSS для собственного оформления и систему плагинов для добавления новых функций.
Какие есть похожие проекты?stemkit, cliamp, Levyra-deepsound, spotify-downloader, mixmusic, Mochy-Music, openspot-music-app, SimpMusic
Автор
rootscripts
Размер
8.9 MB
Звёзды
935
Возраст
1 мес
Коммиты · 90 дней