Skip to main content

Introduction

Welcome to homescreen-hero! HH is a self-hosted Plex companion app designed to be your new base of operations for all things Plex. Automatically rotate collections to keep your homescreen fresh and surface forgotten content, manage your server from a sleek web dashboard, and pull in widgets from your favorite companion apps like Tautulli and Seerr (with more to come).

Web Dashboard​

The dashboard is your central hub for managing everything homescreen-hero has to offer. It features a fully customizable drag-and-drop layout where you can arrange widgets, view rotation status, and get a quick overview of your Plex server, all at a glance. The dashboard is designed to be your starting point every time you open the app.

Automated Collection Rotation​

The core feature that started it all. Schedule collection rotations on your Plex homescreen to keep things fresh for all your users. Organize collections into groups with min/max picks and weights, and choose from three selection strategies:

  • Random - Groups processed in config order, collections selected randomly
  • Weighted - Groups processed by weight (highest first), collections selected randomly
  • Least Recently Used - Collections that haven't been featured recently get priority, ensuring fair rotation across your entire library

All strategies respect gap settings to prevent the same collections from appearing too frequently.

3rd Party Integrations​

Don't feel like going through the hassle of creating your own collections? Why not use lists from all these awesomme sites that are specifically made for creating and sharing lists? Just grab the link from your site of choice, paste it in homescreen-hero, and boom! Collection created. We currently have the following sites integrated, with more to come soon:

  • Trakt - Import public lists and watchlists (requires API key)
  • MDBList - Pull in community-curated lists (requires API key)
  • Letterboxd - Scrape public lists from Letterboxd (no API key required)

Synced lists automatically create and update Plex collections, keeping your library in lockstep with external sources. We also keep record of what content from the collection is missing in your Plex library. Follow-up release will integrate with Radarr/Sonarr to auto-download missing items.

Widget System​

NOTE: The widget system is currently in it's MVP form. Now that the infrastructure is in place, my plan is to add more widgets in order of most requested by users.

Extend your dashboard with widgets from popular self-hosted apps. Currently supported:

  • Tautulli - Streaming activity, watch history, analytics, and sweet looking graphs
  • Seerr - View/approve recent requests, quick-search widget for quickly requesting content from the dashboard

More widget integrations are on the way. Widgets are drag-and-drop, so you can arrange your dashboard exactly how you want it.

Tools & Utilities​

Similar to the widget system, the Tools Page is currently in its MVP form. More tools are already in development, and future tools will be added in order of what is most requested by users.

  • Date Added Editor - Fix the "Date Added" timestamp on movies and shows that were redownloaded. Choose from a custom date, 30 days ago, or match the original release date.
  • Watch History Cleaner - Mark TV shows as unwatched to fix issues with Plex's "Continue Watching" row. Useful when shows disappear or you want a fresh rewatch.
  • Unwatched Report - Find content collecting dust in your library. Search for items never watched or not watched within a specified period. Requires Tautulli. Export results to CSV.

Next Steps​