Discord Cider Status Updater

Automatically updates your Discord custom status based on the currently playing song in the Cider (Apple Music) application in real-time. It can display the song title and artist, or even the current line of lyrics if available.

Features

• Real-time Status: Updates your Discord status every 3 seconds.

• Lyrics Display: Shows the currently sung lyric line as your status.

• Song Info: If lyrics aren't available, it defaults to "Song Title - Artist".

• Auto-Pause Detection: Clears your status when music is paused or stopped.

• Efficient: Caches the last status to prevent redundant API calls to Discord.

Requirements

• Node.js (v16 or higher recommended)

• Cider (Apple Music client) running on the same machine.

• A Discord User Token.

• A Cider API Token.

Installation

1. Clone the repository or download the source code:

   git clone https://github.com/KevinAdiwiguna/discord-cider-status.git
   cd discord-cider-status

2. Install the dependencies:

   npm install

3. Configure the environment:

   • Rename the .env.example file to .env.

   • You will need to fill in the DISCORD_USER_TOKEN and CIDER_APP_TOKEN variables.

Configuration

1. Finding Your Discord User Token

Warning: Your Discord User Token is a sensitive piece of information. Do NOT share it with anyone. Giving someone your token is like giving them your account password.

1. Open Discord in your web browser.

2. Open the Developer Tools by pressing Ctrl+Shift+I (or Cmd+Option+I on macOS).

3. Go to the Application tab (if you don't see it, click the double arrow >> icon on the right).

4. In the left sidebar, expand Local Storage and select [https://discord.com](https://discord.com).

5. In the filter/search box, type token.

6. Look for the key named "token", then copy the string value next to it (make sure to remove any surrounding quotes " if they get copied).

7. Copy this token and paste it into the .env file for DISCORD_USER_TOKEN.

2. Getting the Cider API Token

The script will automatically help you get this token when you run it for the first time.

1. Make sure Cider is running.

2. When you first run the script, it will request a token from Cider.

3. A consent dialog will appear inside the Cider application. Click Approve.

4. The script will display the received token and ask if you want to save it. Type y and press Enter.

5. The token will be automatically saved to your .env file.

Usage

Once everything is installed and configured, you can start the script:

npm start

Or, for development with automatic restarts on file changes:

npm run dev

The terminal will show logs indicating that the updater is running and will print the status updates as they happen. To stop the script, press Ctrl+C.