docs: enhance Zvuk Music token obtaining instructions

Expand the token authentication instructions with comprehensive details
to address reviewer feedback about needing better explanation:

- Add detailed step-by-step process with visual JSON response example
- Include browser-specific display tips for different platforms
- Add security warning about token privacy
- Restructure "Known Issues" with subsections for authentication and quality
- Provide troubleshooting guidance for common token-related problems

This brings the documentation in line with other token-based providers
like SoundCloud and Deezer while maintaining appropriate detail level
for the JSON API endpoint authentication method.

Addresses feedback from PR review comment requesting better explanation
of the token extraction process.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: trudenboy

docs/music-providers/zvuk.md

@@ -33,10 +33,52 @@ Configuration requires obtaining an X-Auth-Token from Zvuk Music.
 
 ### Obtaining the Token
 
-1. Log in to [zvuk.com](https://zvuk.com) in your web browser
-2. Navigate to [https://zvuk.com/api/tiny/profile](https://zvuk.com/api/tiny/profile)
-3. Copy the `token` value from the JSON response
-4. Paste this token into the Music Assistant Zvuk Music provider configuration
+The Zvuk Music provider requires an authentication token (X-Auth-Token) from your Zvuk account.
+
+**Steps:**
+
+1. **Log in** to your Zvuk Music account at [zvuk.com](https://zvuk.com) using your web browser
+
+2. **Navigate** to the profile API endpoint: [https://zvuk.com/api/tiny/profile](https://zvuk.com/api/tiny/profile)
+
+   Your browser will display a JSON response containing your profile information and authentication token.
+
+3. **Locate the token** in the JSON response
+
+   The response will look similar to this:
+
+   ```json
+   {
+     "user": {
+       "id": 12345678,
+       "email": "your@email.com",
+       "token": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
+       ...
+     }
+   }
+   ```
+
+4. **Copy the token value**
+
+   - Find the line with `"token":` in the JSON
+   - Copy only the alphanumeric string between the quotes (not including the quotes)
+   - The token is typically a long string of random letters and numbers
+   - Example token: `abc123def456ghi789jkl012mno345pqr678stu901vwx234yz`
+
+5. **Paste the token** into Music Assistant
+
+   - Go to Music Assistant Settings → Music Providers → Zvuk Music
+   - Paste the token into the "X-Auth-Token" field
+   - Save the configuration
+
+!!! tip "Browser Display Tips"
+    - **Chrome/Edge**: JSON will be formatted automatically for easy reading
+    - **Firefox**: JSON appears with syntax highlighting
+    - **Safari**: Enable Develop menu → Show Page Source if needed
+    - **Other browsers**: If the browser downloads a file, open it with a text editor
+
+!!! warning "Token Security"
+    Keep your token private and do not share it. Anyone with your token can access your Zvuk Music account.
 
 ### Settings
 
@@ -46,8 +88,15 @@ Configuration requires obtaining an X-Auth-Token from Zvuk Music.
 
 ## Known Issues / Notes
 
-- The token may expire and need to be refreshed periodically
-- If lossless quality is unavailable (no subscription), the provider will automatically fall back to the highest available quality
+### Authentication Issues
+
+- **Token expiration**: The token may expire and need to be refreshed periodically. If you encounter authentication errors, try obtaining a new token by following the steps above.
+- **Login required**: You must be logged in to zvuk.com before accessing the profile endpoint. If you see an error or empty response, make sure you're logged in to your account first.
+- **Invalid token format**: Ensure you copied the complete token value without any extra spaces, quotes, or line breaks.
+
+### Quality Issues
+
+- If lossless quality is unavailable (no subscription), the provider will automatically fall back to the highest available quality (320 kbps)
 
 ## Not yet supported