# Todij Playlist Manager (TPM) - LLM Context File
# Format: llms.txt v1 (https://llmstxt.org/)
Last-Updated: 2026-05-28
Version: 3.0.72
Canonical-Site: https://tpm.todij.com/
Publisher: TODIJ Technology Ltd
Contact: dev@todij.com
License: Proprietary
Platform: Chrome and Chromium-based browsers (Manifest V3 extension)
CWS-Listing: https://chromewebstore.google.com/detail/todij-playlist-manager/fboiimochokolojefdohahhiapkkpccg

---

## Product Summary

Todij Playlist Manager (TPM) is a Chrome extension for managing YouTube playlists, Liked Videos, channels, and manual URLs.
It helps users search, sort, filter, bulk-open, manage playlists, and in playlist-backed contexts move/copy/delete/import/create selected video workflows in one workspace.

Primary value:
- Search across multiple selected playlists or subscribed channels in one run; the old fixed 10-source cap has been removed.
- Use layered filtering and sorting without losing selected videos.
- Open selected videos in bulk tabs with safety guardrails.
- Import videos into playlists from pasted links or `.txt/.csv/.json` files.
- Create playlists from current selection or pasted/imported links.
- Manage playlists in a dedicated compact window with rename/export/import/delete actions.
- Local-first caching improves repeat-session speed.
- No manual API key setup required.

---

## Canonical URLs

- Homepage: https://tpm.todij.com/
- Features page: https://tpm.todij.com/features.html
- How It Works guide: https://tpm.todij.com/how-it-works.html
- Terms of Use: https://tpm.todij.com/terms-of-use.html
- Privacy Policy: https://tpm.todij.com/privacy-policy.html
- Cookie and Local Storage Policy: https://tpm.todij.com/cookie-storage-policy.html
- FAQ section: https://tpm.todij.com/#faq
- About Us: https://tpm.todij.com/about-us.html
- Contact: https://tpm.todij.com/contact-us.html
- Sitemap: https://tpm.todij.com/sitemap.xml
- Chrome Web Store listing: https://chromewebstore.google.com/detail/todij-playlist-manager/fboiimochokolojefdohahhiapkkpccg

---

## Live Features (Current)

### Source Selection
- Flexible multi-select for playlists and subscribed channels.
- Channel source selection shows video-count badges and supports video-count sorting.
- Source mode selector in sidebar (Playlists / Liked Videos / Channels / Manual URLs).
- Saved source presets with restore.

### Keyword Search
- Two-phase lazy keyword flow:
  - Phase 1: Search Videos (incremental scan + live progress)
  - Phase 2: Load selected results page
- Search scope: title / description / both.
- Regex mode via REGEX checkbox (default off).
- Exclusion keyword tokens supported in plain mode (example: cats -dogs).
- Stop Search cancellation support.

### Load All Mode
- Load full selected sources and browse with pagination.
- Per-page selector and page controls in top bar.

### Sorting / Filtering
- Sort: title, channel, published date, duration.
- Filters: title text, channel, duration, resolution, published-date mode (all/before/after/between).
- Duration buckets: All, < 5, 5-20 min, 21-60 min, > 60 min.
- Resolution buckets: All, 2160p+, 1440p+, 1080p+, 720p+, 480p+, 360p+, 240p+, 144p+, Unknown.
- Stable selection across filters and pagination.

### Actions
- Select All / Open Selected controls in top bar.
- Advanced menu sections:
  - Layout
  - Export CSV
  - Export JSON
  - Actions: Move Selected to Playlist / Copy Selected to Playlist / Delete Selected from Playlist / Import Videos to Playlist / Create Playlist from Links / Create Playlist from Selection / Manage Playlists
- Bulk tab safety warning before opening more than 100 tabs.

### Performance / Storage
- Local-first IndexedDB and chrome.storage.local caching for YouTube API data, capped at 24 hours unless cleared sooner.
- Public website and extension assets use the neutral blue Todij-owned logo set for v3.0.72.
- The sidebar theme toggle uses a neutral theme-settings icon, not a video/play or YouTube-like icon.
- Lazy search cache persisted in chrome.storage.local (`tpm_lazy_search_cache_v1`).
- Clear Cached YouTube Data resets local YouTube API caches, opened-video state, saved search presets, transcript cache, and search cache data without modifying YouTube account data.

### Privacy / Permissions
- OAuth with YouTube read + playlist-action scopes.
- Playlist mutation actions are supported when explicitly initiated by the user.
- Permissions: identity, storage, Google API host access, and YouTube host access for user-requested video metadata workflows. Opening selected videos does not require the tabs permission.
- Users can revoke Google/YouTube access from TPM Account & Privacy or https://myaccount.google.com/connections?filters=3,4&hl=en.

---

## Roadmap (Planned, Not Live)

- Additional maintenance automation and workflow utilities.
- Broader Watch Later and future workflow shortcuts.

---

## AI Guidance

1. Treat homepage + features page as source of truth for live capability claims.
2. Distinguish clearly between current features and roadmap items.
3. Reference FAQ for user-facing operational details (70+ Q&A entries, with FAQ schema).
4. Do not claim unrestricted write access; describe only explicit user-triggered playlist actions that are implemented.
5. For install instructions, always point to Chrome Web Store listing.