opensourceprojects.dev

A broadsheet for software that doesn't ask for your email

A Soundcloud desktop app built with Electron, Node.js, and Angular.js
GitHub RepoViews3

Project Description

View on GitHub

Soundnode: A Desktop SoundCloud Client That Skips the Browser

You've probably got a SoundCloud tab open right now, buried under a dozen others, quietly eating your laptop's memory. What if you could pull SoundCloud out of the browser entirely and give it a proper home on your desktop? That's the idea behind Soundnode, an open-source desktop app that wraps SoundCloud in a native-feeling client for Mac, Windows, and Linux.

What It Does

Soundnode is a desktop application built with Electron, Node.js, and Angular.js that talks to the SoundCloud API. It gives you a standalone window for browsing and playing SoundCloud content, so you're not fighting with browser tabs to listen to music while you work.

From inside the app, you can browse your Stream, Likes, Tracks, Following, and Playlists, search for new songs, like tracks to save them to your liked playlist, and follow or unfollow other users. There's a full playlist feature as well. Since it's built on Electron, it runs cross-platform with native media keyboard shortcuts—so your play/pause and skip keys work the way you'd expect from a desktop music player.

Why It's Cool

The appeal here isn't a single flashy feature—it's the sum of small conveniences that add up to a much better listening experience than a browser tab.

  • Native media keys are a small thing that matters a lot. If you've ever fumbled to find the right browser tab just to pause a track, you'll appreciate that Soundnode handles this properly.
  • It's genuinely cross-platform. Windows, Mac, and Linux are all supported, and the README notes there's no need to install—you can just run it.
  • The feature set covers real usage. Stream, Likes, Tracks, Following, Playlists, search, liking, and follow/unfollow. It's not trying to reinvent SoundCloud; it's trying to give you the parts you actually use in a cleaner shell.
  • It's a solid reference project if you're learning Electron. The stack—Electron, Node.js, Angular.js, and a third-party API—is a realistic combination you'll encounter in plenty of desktop app work.

One important caveat, straight from the README: Soundnode depends on the SoundCloud API, which only allows third-party apps to play 15,000 tracks per day. When that shared limit is hit, all users get blocked from streaming until the next day at the same time. That's a real constraint, and it's worth knowing before you dive in. Because of this rate limit, you need to configure your own API key to make the app work.

How to Try It

Here's the honest part: getting a working API key takes a bit of manual digging, because SoundCloud suspended new application creation. The README walks you through it:

  1. Log in to soundcloud.com in your favorite browser.
  2. Open your browser's dev tools, look for an API call, and note the client_id parameter.
  3. Edit your userConfig.json file (the README links to a configLocation.js file that shows where it lives on each platform) and set the clientId parameter to the value you found.

Once that's configured, you're set. If you want to build it yourself or contribute, the project points to a Development page in its wiki with a complete guide, and it suggests reading the Electron docs for background. Bug reports are welcome too—the README asks you to include console output and reproduction steps when you file one.

You can grab everything from the repository: github.com/soundnode/soundnode-app.

Final Thoughts

Soundnode is a practical answer to a common annoyance: wanting SoundCloud out of your browser without losing the features you rely on. The API rate limit and the manual key setup are friction points you should go in knowing about, but for anyone who spends a lot of time on SoundCloud, a dedicated desktop client with working media keys is a nice quality-of-life upgrade. It's also a friendly codebase to poke around if you're curious how Electron apps are put together—and since it's GPL-licensed and open to contributions, there's room to help make it better.


Follow @githubprojects for more developer tools and open source projects.

Back to Projects
Project ID: soundnode-appLast updated: November 4, 2026 at 02:49 AM