Skip to content

Latest commit

 

History

History
74 lines (52 loc) · 3.3 KB

README.md

File metadata and controls

74 lines (52 loc) · 3.3 KB
Raw

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.

Fork Info

My goal is to bring soundcloud-rpc up to date and bring some features:

✓ Switch from Deprecated Request Module to Axios

✓ Add a Listen on SoundCloud! Button

✓ Change the Play soundcloud to Listen to SoundCloud

✗ Custom message from Config (not sure 100%)

✓ Take SoundCloud ID automaticaly

Preview

With artwork upload

Profile Popup

Without artwork upload

Profile Popup

Installation

You will need to install nodejs (v10) and npm (v6) 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 if you don't have git installed
  2. Open a terminal in the soundcloud-rp directory
  3. Install the dependencies with npm install
  4. Start the server with npm run start
  5. 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
  2. Download & install soundcloud-rp.user.js
  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 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. Hit save changes just in case
  6. 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")
  7. Restart your server and it should be ok!