From 05714ace503707f5b67111ad3cc786997a1178cb Mon Sep 17 00:00:00 2001
From: deluan <deluan@deluan.com>
Date: Sun, 8 Feb 2026 13:05:35 -0500
Subject: [PATCH] docs: update user configuration instructions for Discord Rich
 Presence

---
 README.md | 87 ++++++++++++++++++++++---------------------------------
 1 file changed, 34 insertions(+), 53 deletions(-)

diff --git a/README.md b/README.md
index 454793d..8e9b455 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,8 @@ We don't provide instructions for obtaining the token as it may violate Discord'
 1. Open Navidrome and go to **Settings > Plugins > Discord Rich Presence**
 2. Fill in the configuration:
    - **Client ID**: Your Discord Application ID from Step 2
+    - **Activity Name Display**: Choose what to show as the activity name (Default, Track, Album, Artist)
+      - "Default" is recommended to help spread awareness of your favorite music server 😉, but feel free to choose the option that best suits your preferences
    - **Upload to uguu.se**: Enable this if your Navidrome isn't publicly accessible (see Album Art section below)
    - **Users**: Add your Navidrome username and Discord token from Step 3
 
@@ -89,6 +91,38 @@ For album artwork to display in Discord, Discord needs to be able to access the
 - **Using public instance**: Verify ND_BASEURL is correct and Navidrome was restarted
 - **Using uguu.se**: Check that the option is enabled and your server has internet access
 
+## Configuration
+
+Access the plugin configuration in Navidrome: **Settings > Plugins > Discord Rich Presence**
+
+### Configuration Fields
+
+#### Client ID
+- **What it is**: Your Discord Application ID
+- **How to get it**: 
+  1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
+  2. Create a new application or select an existing one
+  3. Copy the "Application ID" from the General Information page
+- **Example**: `1234567890123456789`
+
+#### Activity Name Display
+- **What it is**: Choose what information to display as the activity name in Discord Rich Presence
+- **Options**:
+  - **Default**: Shows "Navidrome" (static app name)
+  - **Track**: Shows the currently playing track title
+  - **Album**: Shows the currently playing track's album name
+  - **Artist**: Shows the currently playing track's artist name
+
+#### Upload to uguu.se
+- **When to enable**: Your Navidrome instance is NOT publicly accessible from the internet
+- **What it does**: Automatically uploads album artwork to uguu.se (temporary hosting) so Discord can display it
+- **When to disable**: Your Navidrome is publicly accessible and you've set `ND_BASEURL`
+
+#### Users
+Add each Navidrome user who wants Discord Rich Presence. For each user, provide:
+- **Username**: The Navidrome login username (case-sensitive)
+- **Token**: The Discord user token (see Step 3 in Installation for how to obtain this)
+
 ## How It Works
 
 ### Plugin Capabilities
@@ -150,59 +184,6 @@ Discord requires images to be registered via their external assets API. The plug
 | [manifest.json](manifest.json) | Plugin metadata and permission declarations                            |
 | [Makefile](Makefile)           | Build automation                                                       |
 
-## Configuration
-
-Access the plugin configuration in Navidrome: **Settings > Plugins > Discord Rich Presence**
-
-### Configuration Fields
-
-#### Client ID
-- **What it is**: Your Discord Application ID
-- **How to get it**: 
-  1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
-  2. Create a new application or select an existing one
-  3. Copy the "Application ID" from the General Information page
-- **Example**: `1234567890123456789`
-
-#### Activity Name Display
-- **What it is**: Choose what information to display as the activity name in Discord Rich Presence
-- **Options**:
-  - **Default**: Shows "Navidrome" (static app name)
-  - **Track**: Shows the currently playing track title
-  - **Album**: Shows the currently playing track's album name
-  - **Artist**: Shows the currently playing track's artist name
-- **Default**: "Default"
-- **Use case**: Choose "Track" or "Artist" for more dynamic, music-focused presence that changes with each song
-
-#### Upload to uguu.se
-- **When to enable**: Your Navidrome instance is NOT publicly accessible from the internet
-- **What it does**: Automatically uploads album artwork to uguu.se (temporary hosting) so Discord can display it
-- **When to disable**: Your Navidrome is publicly accessible and you've set `ND_BASEURL`
-
-#### Users
-Add each Navidrome user who wants Discord Rich Presence:
-
-**Format**: Array of user objects with `username` and `token` fields
-
-**Example**:
-```json
-[
-  {
-    "username": "john",
-    "token": "your-discord-user-token-here"
-  },
-  {
-    "username": "jane", 
-    "token": "another-discord-user-token"
-  }
-]
-```
-
-**Important**: 
-- `username`: Your Navidrome login username (case-sensitive)
-- `token`: Your Discord user token (see installation instructions for how to obtain this)
-
-
 ## Building
 
 ### Prerequisites