-
-
Notifications
You must be signed in to change notification settings - Fork 3
Extension Settings
The Settings panel lets you customize how Discord Music RPC extension looks and behaves. You can change the visual theme, set a background image, adjust colors, configure network ports, control data processing, and manage your backups.
Choose between Dark (default) and Light mode. The theme controls the overall color scheme of the popup window.
You can override individual UI colors to match your personal preference:
- Background Color – Main panel background
- Foreground Color – Card and container backgrounds
- Accent Color – Buttons and active elements
- Scrollbar Color – Custom scrollbar appearance
- Border Color – Dividers and outlines
- Text Color – All text content
- Link Color – Hyperlinks
How to use:
- Click the gear icon next to "Color Settings"
- Click any color swatch to open the color picker
- Select your desired color
- Changes apply immediately
Click the "X" button next to any color to revert to the theme default. Use the "Remove Colors" button to reset all custom colors at once.
Add a custom background image to personalize the popup and dashboard:
- Click the gear icon next to "Background Image"
- Enter an image URL in the text field
- Adjust the image using the sliders:
| Control | Effect |
|---|---|
| Blur | Softens the background image (0-40px) |
| Brightness | Makes the image lighter or darker (0-200%) |
| Saturation | Controls color intensity (0-200%) |
| Position | Shifts the image horizontally (0-100%) |
Click the "X" button to remove the background image entirely.
Controls UI motion effects throughout the extension:
| Setting | Result |
|---|---|
| System | Follows your operating system's "Reduce motion" preference |
| Always | All animations enabled |
| Never | All animations disabled (accessibility friendly) |
Many music websites include artist names in the song title (e.g., "Song Title - Artist Name"). Normalization cleans this up before sending to Discord.
| Mode | What It Does |
|---|---|
| Enable | Extracts artist and title separately, sends clean data |
| Clean Only | Removes separators but doesn't extract artist info |
| Disable | Sends the raw title exactly as received |
Click the "i" icon next to this setting for detailed examples of each mode.
When enabled, the extension logs detailed information to the browser console. This is useful for:
- Troubleshooting why a website isn't detected
- Reporting issues to developers
- Understanding what data is being captured
Note: Only enable this when actively debugging, as it creates additional log output.
The extension communicates with a local companion application. In most cases, you won't need to change these settings.
| Port | Purpose |
|---|---|
| RPC Port | Main communication with the companion app |
| Discord Web Port | Communication with the Discord web integration |
To change a port:
- Enter the new port number
- Click "Apply"
- Click "Restart Extension" to activate the change
Important: The companion application must use the same port number. If you change it here, you don't need to change the port separately in the application.
Opens a separate page for safeguarding your configuration:
Export Backup – Creates a JSON file containing:
- All your settings and preferences
- Custom parsers you've created
- User scripts you've added
- Color customizations
Import Backup – Restores from a previously exported file
Sync History – Forces a manual sync between the extension and companion app history databases
Returns all extension settings to their installation defaults.
How it works:
- Click the "Factory Reset" button
- The button changes to "Confirm?" for 5 seconds
- Click again to confirm
What resets: Everything What remains: Nothing
Opens an interface for creating and managing custom website parsers using CSS selectors. This is an advanced feature for adding support for websites not included by default.
Reloads the entire extension. Required after:
- Changing port settings
- Some debug mode toggles
- Certain parser modifications