yt2ym

Download YouTube audio (with chapter splitting) and upload it to Yandex Music as a playlist — with proper titles, track numbers, and album cover.

Install / run

Requires uv, yt-dlp, and ffmpeg on $PATH.

git clone https://github.com/nikicat/yt2ym
cd yt2ym
uv run yt2ym.py --help

First-time setup

uv run yt2ym.py login

This runs the OAuth 2.0 device flow against Yandex: it prints a short user-code, you open the URL in a browser, approve, and the token gets saved to ~/.config/yt2ym/token (0600). You can also pass --token, set $YANDEX_MUSIC_TOKEN, or place the token in that file manually.

Subcommands

login	OAuth device flow → save token.
playlists	List your playlists with their kind ids.
create-playlist TITLE [--public]	Create a new playlist (private by default).
clear-playlist PLAYLIST [--yes]	Remove every track from a playlist (by kind or name).
set-cover PLAYLIST PATH	Set a playlist's cover from an mp3/m4a (embedded cover) or image.
download URL [--out DIR] [--single] [--force]	Download audio to ~/.cache/yt2ym/<videoid>/, splitting by chapters if present.
upload PATH [--playlist X] [--force]	Upload an mp3/m4a file or directory of them.
sync URL --playlist X [--force]	Download a YouTube video as a single track and upload it.
sync-album URL [--playlist X] [--force]	Download a chaptered video and upload each chapter as a track; playlist name defaults to the video title (created if missing).

--playlist accepts a numeric kind id (e.g. 3 = Liked) or a playlist name. Names are looked up; if missing, a new private playlist is created.

Example

# All-in-one: download "Complete SUNDER OST", create a playlist of the same name,
# tag each chapter properly, upload them in correct order, set the album cover.
uv run yt2ym.py sync-album https://www.youtube.com/watch?v=AJK4eo2PwQY

Re-run the same command and it's a no-op: yt2ym checks both the local cache and the Yandex playlist before doing anything. Pass --force to wipe the playlist and re-upload.

How it works

• Audio: yt-dlp's native m4a/AAC (no transcoding step). --no-embed-chapters keeps Yandex from picking a chapter atom name as the track title.
• Tags: track titles and track numbers are written via mutagen (mutagen.id3 for mp3, mutagen.mp4 for m4a) from yt-dlp's chapter filename pattern.
• Order: Yandex displays user-uploaded tracks newest-first, so yt2ym uploads in reverse to make chapter 01 appear first.
• Idempotency is state-based:
  • Download skips if expected audio files already exist in the cache dir.
  • Upload fetches the target playlist's track titles and only uploads files whose title isn't already there.
  • --force bypasses both (and wipes the playlist before re-uploading).
• Cache layout: ~/.cache/yt2ym/<videoid>/ per video. Override with --out.

Token / credentials

yt2ym uses the publicly-known Yandex Smart-TV OAuth client (same one every open-source Yandex Music client uses) to get an access token via device flow. The token is yours; the client_id/secret are not secret.

Credits

Upload logic adapted from Kay0k1/yandex-music-uploader (MIT). Built on MarshalX/yandex-music-api.

License

MIT.