hitsub/soundcloud-extension

This repository is a Tampermonkey userscript that adds extra features to the SoundCloud website, built for people who already use SoundCloud in a browser and want a few extra tools layered on top. It is an unofficial project, not affiliated with SoundCloud, and some of its functions call SoundCloud's private internal API directly, so the author warns that using it carries some risk under SoundCloud's terms of service. The script needs no special browser permissions and reads and writes the page directly. Most of the code in this repository was written with AI assistance by someone who does not work in web development professionally. Once installed through Tampermonkey, the script adds a button to copy a track's cover art image straight to the clipboard as a PNG, working across the feed, likes, and playlist views. For tracks that already show a "Download file" option, it adds a second option that downloads the file and writes metadata into it, including title, artist, album, genre, and cover art. This works for WAV, MP3, and FLAC files, using a different method for each format, and it will not overwrite metadata that is already present. The script also changes how downloadable tracks look: their menu button and thumbnail get an orange highlight so they stand out in lists, grids, and playlists. If a track has a purchase link, the script shows the destination domain name next to the link, and it can resolve redirect or gate style links to reveal the real destination site. Tracks with a purchase link that would not normally show one in a given view get a white outline highlight instead, plus a menu option to open that link directly. On the Likes page, in list view, the script also detects other purchase links pasted into a track's description text and displays them, filtering out common social media links that are not real purchase destinations. The tool only works on tracks visible while logged into SoundCloud, and it depends on reading data SoundCloud already loads on the page rather than making separate network requests of its own. Some highlighting features only work correctly once thumbnails have finished loading.