1. Install the Windows app
Download the Windows x64 installer, check the requirements and run it with administrator permission. Open TubeWhitelist after installation.
In your browser, create an account. This creates your family workspace. Already registered? Log in to your dashboard.
2. Build a whitelist
A whitelist is a shared collection of approved content and default playback rules. A client is one installed app. Several clients can use the same whitelist.
Add channels and playlists in the dashboard, then assign them to your whitelist. A YouTube playlist uses its YouTube source; a mix playlist contains the videos you add. Check that the content is active and available to the intended whitelist.
For autoplay, enable the playlists you want, set their order in the whitelist and choose sequential or shuffle playback. Enable looping if you want another round after the last playlist.
3. Connect your client
Open Settings using the app’s gear icon. Its QR code contains the installation’s client UUID.
In the web dashboard, add a client. Scan the QR code with a camera, upload a QR image or enter the client UUID. Assign the client to your whitelist and enable it. Browser camera access may require HTTPS and camera permission.
Keep the app’s local data when upgrading so its UUID and binding can be retained.
4. Set your boundaries
Set weekday and weekend screen-time limits and optional Start/End windows. Start and End must both be entered or both left empty. A screen-time limit of 0 means unlimited. Times use the client computer’s local time.
Outside an enabled playback window, or after the daily limit is reached, the player displays a message and blocks playback. An optional shutdown time schedules a computer shutdown, with advance warnings.
Enable whitelist checking to restrict links opened inside YouTube. Approving a channel allows its content, including future uploads. Review your choices periodically.
Watch Only Mode limits the app to automatic playback. Client overrides apply only where the whitelist permits them; PIN overrides have their own setting.
5. Review something new
When a video is blocked by the whitelist, the app can offer a request for the video, its channel or a playlist present in the link. Submitted requests appear in the app and in the dashboard’s request management.
Review the request in the dashboard. Approval opens the matching add-content form. Complete and save that form to record the approval; ensure the new content is assigned to the intended whitelist.
The app checks client binding and control policies every minute. Its regular content-list refresh runs every 10 minutes; use Reload for a manual refresh. Lists remain usable during synchronization.