Getting Yandex Credentials (OAuth Token)

This guide explains how to obtain the Yandex Music OAuth token required to configure octo-fiesta with Yandex Music.

Prerequisites

• An active Yandex account with access to Yandex Music
• A web browser (Chrome, Firefox, Edge, etc.)

Step 1 - Authorize the Yandex Music OAuth client

1. Open the official Yandex Music OAuth authorization link:

   https://oauth.yandex.ru/authorize?response_type=token&client_id=23cabbbdc6cd418abb4b39c32c41195d

2. Log in with your Yandex account if prompted

3. Approve the authorization request

Step 2 - Copy the token from the address bar

After authorization, your browser is redirected to a URL that contains the token in the fragment after #:

https://music.yandex.ru/#access_token=AQAAAAA...&token_type=bearer&expires_in=...

Copy the value of access_token (everything between access_token= and the next &). This is your YANDEX_OAUTH_TOKEN.

Step 3 - Configure octo-fiesta

Using Docker (.env file):

MUSIC_SERVICE=Yandex
YANDEX_OAUTH_TOKEN=your_token_here
YANDEX_QUALITY=FLAC  # Optional: FLAC, MP3_320, AAC_256, AAC_192, MP3_192, AAC_64

Using appsettings.json:

{
  "Subsonic": {
    "MusicService": "Yandex"
  },
  "Yandex": {
    "OAuthToken": "your_token_here",
    "Quality": "FLAC",
    "Language": "ru",
    "IncludeUnavailable": false
  }
}

Step 4 - Verify configuration

When you start octo-fiesta, you should see a startup validation message confirming the Yandex token was accepted. If the token is invalid or expired, an error is shown and you will need to repeat the authorization steps above.

Optional Settings

• Yandex:Language - Language for API responses. Some titles and curated playlists are translated into this language. Available values: en, uz, uk, us, ru, kk, hy. Default: ru.
• Yandex:IncludeUnavailable - Include tracks marked unavailable for listening in search results, albums, and playlists. Default: false.

Quality Options

Value	Description
FLAC	FLAC 16-bit/44.1kHz (default)
MP3_320	MP3 320 kbps
AAC_256	AAC 256 kbps
AAC_192	AAC 192 kbps
MP3_192	MP3 192 kbps
AAC_64	AAC 64 kbps

If not specified or unavailable, octo-fiesta uses the highest quality available for your account.

Troubleshooting

"Invalid credentials" error

• The token may have expired. Repeat the authorization steps to get a fresh token.
• Make sure you copied the full access_token value without the trailing &token_type=... part.

"Track unavailable" errors

• Some content is region-restricted and may not be available in your account's region.

---

Note: Yandex Music tops out at CD-quality FLAC (16-bit/44.1kHz). There is no Hi-Res tier.