Bertold Héjja

Budapest, Hungary

Electrical Engineer · Senior Software Engineer · Project Manager

ERP, embedded systems & cloud — from the circuit board to the product roadmap.

← All projects

SubSorter

A self-hosted web app that turns my YouTube subscription feed into playlists. It collects new uploads from subscribed channels and adds each one to the playlist chosen for that channel, after a review or fully automatically on a schedule.

01 About

YouTube shows new uploads from every subscription in a single feed. SubSorter turns that feed into playlists: each channel gets a target playlist, and its new videos, Shorts or both are added there, so different kinds of videos each end up in their own place.

A check reads each channel's automatically generated uploads playlist and collects only what was published since the last accepted check. The new videos are grouped by target playlist for review, and accepting them adds them oldest first. A separate scheduler container can run the same flow automatically on a schedule.

The YouTube Data API has a daily quota, so the app makes one request per checked channel and none for thumbnails or channel icons, and skipped channels aren't requested at all. Sign-in uses Google OAuth with the tokens stored encrypted, and the whole app is a single Docker image with SQLite.

02 Screenshots

The Videos page: new uploads grouped by target playlist, with thumbnails, ready to be accepted
New uploads grouped by target playlist, ready to accept
The Channels page: each subscription with Videos and Shorts checkboxes and a target playlist, color-coded by playlist
A target playlist and Videos / Shorts for each channel
The Channels page filtered to one playlist and searched for "cafe", finding Café Cartography
Filtered to one playlist; search ignores accents

03 What it does

  • A target playlist per channel, with videos, Shorts, both or neither, and a default playlist for everything else
  • Review screen that groups new uploads by target playlist with thumbnails: remove anything unwanted, then accept in one click
  • Google OAuth sign-in and YouTube Data API v3 integration, with tokens stored encrypted
  • Quota-aware: one API request per checked channel and no extra calls for thumbnails, so about 190 videos can be added a day on the default quota
  • No duplicates: only uploads since the last accepted check are collected, and failed additions stay in the list to retry
  • Single Docker image with SQLite and an optional scheduler container, published to GHCR with versioned releases and a ready-made TrueNAS compose file

04 Built with

  • Laravel
  • PHP
  • YouTube Data API
  • OAuth 2.0
  • SQLite
  • Docker
  • GitHub Actions