YouTube Tracks & Playlist Import in tinytunes DJ

tinytunes DJ supports YouTube in two complementary ways:

1. Add individual YouTube tracks via in-app YouTube search.
2. Import playlists from YouTube (one-way import) to create local, editable playlists in your tinytunes DJ library.

This guide explains both flows and how to manage your tracks and playlists afterwards.

1. Key rules (how YouTube works in tinytunes DJ)

• One-way import only: tinytunes DJ reads from YouTube and never writes back.
• Imported playlists become local-only immediately after import.
  • They remain usable and fully editable even if you later disconnect YouTube.
  • They are not kept in sync with YouTube.
• Re-import creates new copies.
  • Importing again creates a new local playlist copy and does not overwrite existing playlists.
• Disconnect removes access only.
  • Disconnect deletes YouTube tokens from the backend but keeps imported playlists/items and keeps YouTube tracks.

2. Add individual YouTube tracks (Search YouTube)

Use this when you want to add a few tracks quickly without importing full playlists.

Steps

1. Open Library.
2. Switch the SOURCE to youtube.
3. Click SEARCH YOUTUBE.
4. Enter keywords (track name, artist, remix, etc.) and click SEARCH.
5. Click ADD on the result you want.

What happens after you add a track

• The track appears under ALL TRACKS (with YouTube as its source).
• You can:
  • Load it to Deck A/B,
  • Add it to playlists,
  • Use it in set lists,
  • Search/filter it like other tracks.

Notes:

• YouTube playback requires an internet connection.
• Some videos may become unavailable later (private, deleted, region-restricted).

If YouTube search is missing or fails consistently, the app deployment may not have YouTube Search configured (it requires a YouTube Data API key). Contact the site/admin for your environment.

3. Import playlists from YouTube (Connect + Import)

Use this when you want a fast way to bring your YouTube playlists into tinytunes DJ as editable playlists.

3.1 Connect YouTube

1. Open Library.
2. Switch the SOURCE to youtube.
3. In YOUTUBE IMPORT, click CONNECT (or the connect button shown).
4. Complete the Google consent screen.

After connecting, the panel will show CONNECTED and your Last import status.

3.2 Import playlists

1. In YOUTUBE IMPORT, optionally choose Select playlists (if available) to import a subset.
2. Click IMPORT FROM YOUTUBE.
3. Keep the tab open while the import runs.

3.3 What you get after import

• For each YouTube playlist imported, tinytunes DJ creates a new local playlist copy.
  • The playlist name includes an import timestamp, e.g. My Playlist (Imported 2025-12-28 01:23 UTC).
  • You can rename it immediately (it’s a normal local playlist).
• Each YouTube playlist item is imported into your library as a YouTube track (deduped by video ID).
  • The same video appearing in multiple playlists becomes one track in your library.
  • The same video appearing twice in a single playlist remains two separate playlist entries (duplicates preserved).

3.4 Re-import (creates new copies)

Use RE-IMPORT when you want a fresh copy from YouTube:

• It creates a new local playlist copy for each selected YouTube playlist.
• It does not overwrite or update your existing imported playlists (including ones you’ve edited).

3.5 Disconnect YouTube (keeps your library)

If you disconnect:

• tinytunes DJ deletes the backend tokens and loses access to YouTube APIs.
• Your previously imported playlists and YouTube tracks stay in your library and remain editable.

4. Manage YouTube tracks after adding/importing

4.1 Playability and unavailable videos

YouTube tracks can become unavailable over time. tinytunes DJ keeps the track entry so your playlists stay stable, but marks the track as unplayable.

If a track is shown as unavailable:

• It stays visible in playlists (so ordering doesn’t shift).
• It’s disabled for playback/loading.

Common reasons:

• Private video
• Deleted video
• Not returned by YouTube metadata (unavailable/unknown)

4.2 Remove vs keep

Depending on your workflow, you can either:

• Keep unavailable tracks (useful when preserving the history/structure of a playlist or set list), or
• Remove them from a specific playlist, or from the library if you no longer want them.

5. Manage imported playlists (local-only + editable)

Imported playlists behave like normal tinytunes DJ playlists:

• Rename them.
• Reorder items.
• Add/remove tracks (local or YouTube).
• Delete playlists you don’t need.

Imported playlists may show a small YouTube badge (e.g. YT) to indicate provenance only.

Remember: imports are not kept in sync. If you want the latest version from YouTube, use Re-import (which creates a new copy).

6. Troubleshooting

“Connect” finishes but you land on the wrong environment

Your environment’s site URL may be misconfigured. Ask the site/admin to verify that the app’s SITE_URL matches the environment domain.

Import takes a long time

• Keep the tab open.
• If the import panel shows “in progress”, wait for it to finish.
• Large playlists can take longer due to YouTube API rate limits.

YouTube track won’t play

• Confirm you’re online.
• Open the video on YouTube to confirm it’s still available.
• If it’s private/deleted, it cannot be played in tinytunes DJ.