rootscripts/riff

Riff is a free forever, best and freshly updating desktop music player for Windows, Linux, and macOS. It is made for playing music, managing a music library, and downloading tracks for offline listening.

Riff can download audio from:

• YouTube
• YT Music
• SoundCloud

Downloaded tracks can be added to the local library and played without an internet connection

Android & iOS Riff forks are unofficial and are not made by rootless. All Riff Android & iOS FORKS:

https://github.com/cloverscripts/riff-muriel Muriel (Riff Android & iOS & Windows) by cloverscripts

macOS support is still in beta and some functions may not work.

! When you install the .dmg, you'll get this error:

To fix it, write this command in the terminal

xattr -d -r com.apple.quarantine /Applications/Riff.dmg

(replace Riff.dmg with actual dmg name)

Then run the app again.

Your music files stay on your computer.

Riff can read track information such as:

• Title
• Artist
• Album
• Track number
• Album art
• Other common audio tags

You can also organize music into folders and playlists.

Riff has a small built-in editor for making simple changes to a track.

You can:

• Speed up/slow down tracks realtime
• Add reverb, distortion, make the track sound high quality by equalizing
• Trim the beginning or end of a track
• Select a part of a song
• Save a selected section as a separate file

It is meant for quick edits, so you do not need to open another program for small changes.

Lyrics are enabled with online search by default.

Riff supports:

• Plain text lyrics
• LRC files
• Manual lyric timing
• Online auto lyric timing

LRC files can be used when you already have timestamps. You can also adjust the timing yourself from inside the player.

Riff can show what you are listening to on Discord.

The Rich Presence can include:

• Track name
• Artist
• track progress

You can create and manage playlists from your local music library.

Tracks can be added or removed without changing the original files.

Music continues playing while Riff is in the background or minimized.

Riff does not require an account to play local music.

Your local library, playlists, downloaded files, and other music data can stay on your computer.

Riff does not need a subscription or paid Premium.

Riff is designed to stay relatively light, comfortable and fast for a desktop music player.

On a typical system, it uses around ~180 MB of RAM, although actual usage depends on the number of tracks loaded, the current features being used, and the system itself. We fix RAM issues only if it's really big (500+ MB instead of 180 mb)

• Node.js 18 or newer
• npm
• yt-dlp, ffmpeg

! ALL OF THESE ARE INSTALLED BY DEFAULT AND COMPILED IN RELEASES !

Clone the repository:

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

Install the dependencies:

npm install

Start the development version:

npm start

To create a production build, use:

npm run dist

The exact build output depends on the current project configuration.

Support for macOS is experimental (built in CI, not tested on every Mac).

• Riff-<version>-mac-arm64.dmg for Apple Silicon (M1 and newer)
• Riff-<version>-mac-x64.dmg for Intel

Open the dmg, drag Riff to Applications.

The app is not signed. Right-click Riff in Applications, choose Open, and confirm. If macOS says the app is "damaged": run xattr -cr /Applications/Riff.app in Terminal and open it again.

Run brew install yt-dlp ffmpeg (Riff finds Homebrew installs automatically).

• No automatic updates on macOS (download the new dmg from Releases).
• Data is stored in ~/Library/Application Support/Riff.

npm install
npm run dist

Please run tests for your PR if it works first, if it looks good, and search any bugs possible.

If it contains bugs/several critical issues/crashes and not tested, please do not post a PR as it's useless

Developed for educational and personal media management purposes only. Users are responsible for complying with local copyright laws and the terms of service of any third-party streaming platforms.

Riff is primarily intended for personal use with music you are allowed to download and store.

When downloading content from third-party services, make sure your use of that content follows the service's rules and the laws that apply to you.

MIT