Complete Reference Guide

Learn how to install the app, build your network database, stream your channels, and use the Native OS Share integrations.

Installing the App (PWA)

Yrrejut TV is a Progressive Web App (PWA). This means it lives on the web, but you can install it directly to your phone or computer just like a native application.

Why install it? Installing unlocks core OS-level features, like Fullscreen immersion, background data caching, and the incredible Native Share Menu feature discussed below.

How to Install:

  • Android/Chrome: Open the site in Chrome. Tap the 3-dot menu in the corner and select "Add to Home Screen" or "Install App".
  • iOS/Safari: Open the site in Safari. Tap the Share button (square with arrow pointing up) at the bottom, then scroll down and tap "Add to Home Screen".
  • Desktop (Chrome/Edge): Look for the small "Monitor with a downward arrow" icon in your URL address bar. Click it to install the desktop application.

Getting Started (Data)

Because Yrrejut TV is completely private, your video library lives entirely on your device inside a local database (Dexie). No one tracks what you watch.

When you start the app for the very first time, the database is empty. You have a few ways to populate it:

  • Defaults: The app will look for a default-data.js file on the server. If found, it instantly seeds your database with starter channels and videos.
  • Import JSON: Go to the Network Admin panel, click Import, and upload a backup JSON file you created previously.
  • Manual Entry: In the Admin Panel, you can manually type in YouTube Video IDs and Channel names one by one.
  • Dropbox Sync: In the Admin Panel, authorize your Dropbox account to instantly pull down your cloud-saved master database.

Native YouTube Sharing

Once you have Installed the App (see Chapter 1), Yrrejut TV becomes a registered "Share Target" on your operating system.

This allows you to add content to your channels magically fast, straight from the official YouTube app:

  1. Open the native YouTube App on your phone.
  2. Find a video you want to add to your network.
  3. Tap the standard Share button.
  4. In the list of Apps that appears (Messages, Twitter, Copy Link, etc.), you will now see Yrrejut TV.
  5. Tap it. Yrrejut will instantly open, parse the YouTube link, download the thumbnail, and ask you which Channel you want to save it to.
  6. Hit Save, and instantly resume browsing YouTube!

The Live TV Player

The core of Yrrejut TV. The Live player simulates a real 24/7 cable network broadcast.

  • The Schedule Engine: The app looks at all the videos in a Channel and calculates exactly which one would theoretically be playing right now based on the current time of day.
  • Scrubbing: If you try to fast-forward the YouTube player, the app will snap you back to the exact "Live Broadcast Time". You cannot skip ahead of a live broadcast!
  • Picture-in-Picture: Try clicking the PiP button on desktop browsers to pop the video out into a floating window that stays on top while you browse other tabs.

On Demand Navigation

Sometimes you just want to binge specific content. The On Demand tab transforms your linear channels into a streaming service interface.

  • Dynamic Grids: The layout automatically calculates how many columns can fit on your screen. It loads massive posters beautifully without squishing them.
  • Load More Categories: The "Browse All Networks" section uses an infinite horizontal scroll. If a row gets too long, click the Right Arrow button at the end to jump smoothly to the next set of videos.
  • Global Search: Found at the top of the Admin Panel, but soon integrating fully into On Demand.

Favorites & Watch Later

Keep track of your favorite episodes or bookmark long movies for later viewing using the built in list-management systems.

On Desktop / Mouse:

The interface remains completely clean of clutter. When you Hover your mouse over any video thumbnail, a subtle Heart and Clock icon will fade into view in the top right corner. Click them to toggle the status.

On Mobile / Touch:

Since phones don't have "hover," you simply Tap the video. This instantly opens the cinematic "Modal Player". Resting perfectly in the top black bar of this player are your Heart and Clock buttons.

Once you tag a show, special "My List" and "Favorites" rows will magically appear at the very top of the On Demand screen.

Cloud Sync & Backups

Because your database lives in your browser cache, clearing your browser history or reinstalling the app WILL DELETE YOUR TV NETWORK.

You must regularly back up your database using the Network Admin panel.

  • Local Export: Click "Export to JSON" to download a physical file containing all your channels, shows, history, and favorites. We recommend keeping this file on your desktop.
  • Dropbox Sync: Authorize Dropbox to sync your database to the cloud. You can then open the App on your Tablet, click "Load from Dropbox", and instantly clone your phone's customized TV network onto the big screen!
Update Warning: If the app ever detects a major code update, it will display a massive Warning screen asking you to click the Export Data button before it forces you to reinstall. Don't skip it!