https://github.com/demaisj/soundcloud-rp
Adds Discord Rich Presence support to Soundcloud.
https://github.com/demaisj/soundcloud-rp
discord discord-rich-presence discord-rpc music rich-presence soundcloud
Last synced: about 1 month ago
JSON representation
Adds Discord Rich Presence support to Soundcloud.
- Host: GitHub
- URL: https://github.com/demaisj/soundcloud-rp
- Owner: demaisj
- Archived: true
- Created: 2018-05-07T15:25:40.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-11T03:00:20.000Z (about 3 years ago)
- Last Synced: 2024-09-27T11:43:21.513Z (5 months ago)
- Topics: discord, discord-rich-presence, discord-rpc, music, rich-presence, soundcloud
- Language: JavaScript
- Size: 365 KB
- Stars: 113
- Watchers: 10
- Forks: 16
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Soundcloud Rich Presence
Adds Discord Rich Presence support to Soundcloud.
## Introduction
Soundcloud Rich Presence allows you to show off your Soundcloud listening session to your friends using Discord Rich Presence.
It is a combination of a server, communicating with discord itself, and a user-script, running on your browser to send playback information to the server. Sadly, due to restrictions in the rich presence protocol, it is mandatory to run both the server and the user-script in order for the system to work.
Artwork upload is not available by default due to Discord's asset limit (150). In order to activate it, you need to create a new app on the developer interface, and set the new ClientID and your APIKey of the developer interface. More details at **[Artwork Upload](#artwork-upload)**.
## Preview
### With artwork upload
| Profile | Popup |
| ------ | ----- |
|  |  |
### Without artwork upload
| Profile | Popup |
| ------ | ----- |
|  |  |
## Installation
You will need to install [nodejs (v10) and npm (v6)](https://nodejs.org/en/download/current/) first. Make sure the `node` & `npm` commands are installed on your **PATH**.
**Server:**
1. Clone the repository somewhere on your hard drive or [unzip this archive](https://github.com/demaisj/soundcloud-rp/archive/master.zip) if you don't have git installed
2. Open a terminal in the **soundcloud-rp** directory
3. Install the dependencies with `npm install`
4. Retrieve your Soundcloud ClientID :
- Open [Soundcloud](https://soundcloud.com/) then hit Ctrl+Shift+I to open the devtools
- Go to the **Network** tab
- Filter by `api-v2.soundcloud.com`
- Click on the first result. If there is no results, try changing page on Soundcloud to trigger some requests
- Scroll down to the **Query String Parameters** section
- Look for the **client_id** field and copy the value
- Paste it in the corresponding field of the `config/default.json` file
5. Start the server with `npm run start`
6. Additionnaly create a systemd service (linux) or startup shortcut (windows) to start the server on bootup
**Browser:**
1. Install a userscript extension for your browser like [Tampermonkey](https://tampermonkey.net/)
2. Download & install [`soundcloud-rp.user.js`](soundcloud-rp.user.js?raw=true)
3. Open soundcloud & enjoy
## Artwork upload
Here is a step by step guide to activate artwork upload:
1. In the `config/default.json` file, change `uploadArtwork` from `false` to `true`
2. Go to the [developer interface](https://discordapp.com/developers/applications/me) of Discord
3. Create a new app, give it a cool name and save it
4. Paste the Client ID (found in App Details on the top of the page) into the `config/default.json` file
5. ~~Scroll down and click "*Enable Rich Presence*"~~
6. Hit save changes just in case
7. Retrieve your APIKey
- Hit ctrl+shift+i to open the devtools
- Go to the **Network** tab
- Filter by `/api/`
- Click on the first result. If there is no results, try changing page to trigger some requests
- Scroll down to the **Request Headers** section
- Look for the **authorization** field and copy the value
- Paste it in the corresponding field of the `config/default.json` file (do not forget to wrap it in double quotes as in `"value"`)
8. Restart your server and it should be ok!