ytmusic-organizer 0.2.1

Organize YouTube Music likes into playlists with guided bootstrap and weekly sync

ytmusic-organizer

your likes are not a playlist system. they are a pile.

ytmusic-organizer turns that pile into reusable youtube music playlists with a guided setup and a weekly sync that handles the boring part.

            ██╗   ██╗████████╗███╗   ███╗ ██████╗
            ╚██╗ ██╔╝╚══██╔══╝████╗ ████║██╔═══██╗
             ╚████╔╝    ██║   ██╔████╔██║██║   ██║
              ╚██╔╝     ██║   ██║╚██╔╝██║██║   ██║
               ██║      ██║   ██║ ╚═╝ ██║╚██████╔╝
               ╚═╝      ╚═╝   ╚═╝     ╚═╝ ╚═════╝

            Y T M O  •  playlist automation, human taste.

demo

good fit

• you dump tracks into youtube music likes and want usable playlists out of it.
• you want a weekly sync instead of another manual cleanup ritual.
• you prefer a cli that does the job over hand-curating playlists every week.

what it does

• builds an initial playlist structure from your liked songs.
• applies weekly incremental updates as you like new tracks.
• supports manual mode when you want to provide JSON plans and api mode when you want openai-backed planning.
• keeps state in ~/.ytmusic-organizer by default so runs stay repeatable.

install

recommended:

pipx install ytmusic-organizer

from source:

pipx install .

first run

1. run guided setup:

ytmo setup

2. run your weekly sync:

ytmo sync

3. if you want end-to-end planning, use api mode:

export OPENAI_API_KEY=...
ytmo sync --mode api

safety model

• deletes only playlists listed in managed_playlists.json, using playlist ids.
• never performs arbitrary playlist deletion.
• rebuild and cleanup are destructive and require explicit confirmation unless --yes is passed.
• --dry-run does not write playlists or workspace artifacts, but it may still require auth and network reads.

core commands

• ytmo setup - guided bootstrap and initial playlist build
• ytmo sync - weekly incremental updates
• ytmo rebuild --yes - full destructive rebuild
• ytmo cleanup --yes - remove managed playlists and local managed artifacts
• ytmo stats - read-only workspace diagnostics
• ytmo demo - simulation walkthrough with no auth, network, or writes

docs

• cli and reference details: docs/reference.md
• automation integration: docs/automation.md
• demo asset workflow: docs/demo.md
• collaborator workflows: docs/collaborators.md