soundcloud-rpc

A SoundCloud Client with Discord Rich Presence, Dark Mode, Last.fm and AdBlock support

Works on Linux (AppImage/deb), Windows and macOS

⚡️ Quick start

For the latest version of soundcloud-rpc, download the installer or executable file from the latest release page.

[!NOTE]

macOS Users

If you encounter a "Damaged App" popup after installation, run the following command in the terminal to resolve the issue:

xattr -dr com.apple.quarantine /Applications/soundcloud.app

After running this command, the app should launch without any problem.

🐧 Linux

Grab the AppImage or deb from the releases page.

chmod +x soundcloud-*-linux.AppImage
./soundcloud-*-linux.AppImage

The AppImage writes its own .desktop file + icon on first run, so the proper icon shows up in the taskbar/launcher from the second launch on (wayland compositors can't know the icon before that). Widevine (GO+ playback) works. Auto updates only work with the AppImage. Tray works out of the box on kde, gnome needs a systray extension.

Or build it yourself:

npm install
npm run build-linux-appimage   # or build-linux-deb

⚙️‍ Building

Before installing and running this app, you must have Node.js installed on your machine.

1. Clone this repository to your local machine
2. Run npm install to install the required dependencies.
3. Run npm build to build the application.

📖 Usage

Press F1 to open the application menu, which provides access to various settings and features.

Keyboard Shortcuts

Quick Reference:

• F1 - Open Settings
• Ctrl/Cmd + R - Refresh the current page
• Ctrl/Cmd + B - Go back to the previous page
• Ctrl/Cmd + F - Go forward to the next page
• Ctrl/Cmd + = - Zoom in
• Ctrl/Cmd + - - Zoom out
• Ctrl/Cmd + 0 - Reset zoom

🖼️ Preview

🛠️ Built With

• @xhayper/discord-rpc - Discord Rich Presence integration
• Electron - Framework for building cross-platform desktop applications
• electron-builder - Tool for packaging and distributing Electron applications
• @ghostery/adblocker-electron - Ad blocking functionality
• electron-store - Data persistence
• electron-updater - Auto-update functionality

🤝 Contributing

Contributions to this project are welcome. If you find a bug or would like to suggest a new feature, please open an issue on this repository.

📜 License

This project is licensed under the MIT License. See the LICENSE file for details.