Skip to content

Zvuk Music Preview image

Music Assistant has support for Zvuk Music. Contributed and maintained by TrudenBoy.

This provider is built on top of the zvuk-music library.

Note

A Zvuk Music subscription is required for lossless (FLAC) quality. Free accounts can stream at high quality (320 kbps) with limitations.

Features
Subscription FREE Yes (with limitations)
Self-Hosted Local Media No
Media Types Supported Artists, Albums, Tracks, Playlists
Recommendations Supported No
Lyrics Supported No
Radio Mode No
Maximum Stream Quality Lossless FLAC (with subscription)
Login Method Token

Other

  • Searching the Zvuk Music catalogue is possible
  • Items in a users Zvuk Music library will be synced to Music Assistant
  • Adding/removing items to/from the Music Assistant library will sync back to Zvuk Music
  • Playlist creation and editing is supported

Configuration

Configuration requires obtaining an X-Auth-Token from Zvuk Music.

Obtaining the Token

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 using your web browser

  2. Navigate to the profile API endpoint: https://zvuk.com/api/tiny/profile

Your browser will display a JSON response containing your profile information and authentication token.

  1. Locate the token in the JSON response

The response will look similar to this:

{
  "user": {
    "id": 12345678,
    "email": "your@email.com",
    "token": "abc123def456ghi789jkl012mno345pqr678stu901vwx234yz",
    ...
  }
}

  1. Copy the token value

  2. Find the line with "token": in the JSON

  3. Copy only the alphanumeric string between the quotes (not including the quotes)
  4. The token is typically a long string of random letters and numbers

  5. Example token: abc123def456ghi789jkl012mno345pqr678stu901vwx234yz

  6. Paste the token into Music Assistant

  7. Go to Music Assistant Settings → Music Providers → Zvuk Music

  8. Paste the token into the "X-Auth-Token" field
  9. Save the configuration

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

Token Security

Keep your token private and do not share it. Anyone with your token can access your Zvuk Music account.

Settings

  • Audio quality: Select preferred audio quality
    • High (320 kbps) - Available for all accounts (default)
    • Lossless (FLAC) - Requires a Zvuk Music subscription

Known Issues / Notes

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

  • Recommendations and personalized content
  • Lyrics display
  • Radio mode