TubeList

Overview

This app allows users to import and manage their own public YouTube playlists and play them using the official YouTube embedded player.
It is designed as a focused utility for users who prefer predictable playback behavior and direct control over their playlists, rather than automatic recommendations or unrelated content.

Core Features
• Import any public YouTube playlist
• Create and manage multiple playlists
• Rearrange or remove videos within playlists
• Refresh playlists to sync newly added videos
• Built-in search to add videos to playlists
• Foreground playback using the official YouTube player
• Standard playback controls: Play, Pause, Next, Previous, Shuffle, Repeat
• Optional screen-lock overlay to prevent accidental taps during playback
• Cross-device access with optional account sign-in

How the App Works

The app uses official YouTube Data API requests to retrieve playlist and video metadata.
Users provide their own YouTube Data API key during initial setup.
This is a one-time process and helps ensure:
• API usage remains tied to the individual user
• Daily quota limits are handled fairly
• Compliance with YouTube’s API usage policies

Once validated, the API key does not need to be re-entered unless the user chooses to replace it.

Architecture & Performance

To reduce unnecessary API requests and improve responsiveness:

• Playlist and video metadata are cached centrally
• Existing data is reused whenever possible
• Requests are rate-limited and refreshed selectively

The app consists of:

• Flutter-based mobile UI
• Python backend for API requests
• Firestore for metadata and user data storage
• Algolia-powered search using cached metadata

Usage Limits & Cooldowns

To prevent automated abuse and protect API quotas:

• Playlist imports and refreshes are limited per day
• Refresh actions include a cooldown period
• Limits reset automatically

These controls apply uniformly to all users.

Accounts & Access

Users may:
• Sign in with Google, email, or phone number
• Continue as a guest
• Signing in enables playlist synchronization across devices.

Age Awareness

During setup, users are asked whether they are over or under 18.
This information is used to apply appropriate content filtering.
Users may continue using the app regardless of age selection.

Playback Policy & Compliance

• Playback occurs only while the app is in the foreground
• Uses the official YouTube embedded player
• No background playback
• No modification of video streams

The app is designed to operate within YouTube’s Terms of Service.

Who This App Is For

This app is best suited for users who:
• Maintain custom YouTube playlists
• Prefer a hands-busy, screen-focused listening experience
• Are comfortable completing a one-time API key setup
• Want predictable playback without automatic content changes

Privacy

• Account credentials are used only to enable login and cross-device synchronization.
• The app does not sell personal data or use it for advertising.
• Full details are available in the Privacy Policy linked on this store page.