Skip to content
Up NextUp Next
Esc
↑↓navigate↵open⌘Jpreview
On this page

Up Next

Twitch live channels, YouTube uploads and a watch-later queue in one feed.

Overview

Twitch live channels, YouTube uploads and a watch-later queue in one feed.

Up Next watches the Twitch channels you follow, the YouTube channels you list and a watch-later queue, and keeps them in one feed. It sends a desktop notification when something goes live, and can open your favourite channels as soon as they start.

# What's live, new and saved right now
upnext feed

# The feed now and after every change, as JSON lines for panels and scripts
upnext watch --json

Watch later

Save any web address to the queue. YouTube videos get their title, channel and thumbnail looked up; other links show the title you give them, or the address.

upnext queue add https://youtu.be/<video-id>
upnext queue add https://example.com/talk --title "That talk"

# Remove a saved item, or hide a YouTube upload, by the ID from feed --json
upnext watched youtube:<video-id>

A saved video shows only in Watch later, even when it’s also live or one of a channel’s recent uploads. Marking it watched removes it from the queue and hides the upload.

YouTube videos can live in a playlist on your YouTube account instead, so the queue follows you to your phone and TV. See Use a playlist for watch later.

How it fits together

  • upnext serve runs as a systemd user service. It checks each source, keeps the feed and sends notifications.
  • Every other command is a small client. It connects to the daemon socket, makes one request and exits, or streams the feed.
  • The Omarchy panel shows what’s live, upcoming, newly uploaded and saved, with Twitch and YouTube counts in the bar.
  • From TypeScript, use @timmo001/effect-upnext to talk to the socket directly.

Get started

Page Why
Install Install the Arch package or a release build
Set up Twitch Register an app, sign in and pick channels
Set up YouTube Add channels, an API key and a Google sign-in
Configuration Every setting, and where the files live
Running Up Next The user service, logs and upgrades
Omarchy panel The bar widget and panel
Commands Every command and flag
Libraries Use the feed from your own Effect app
Migrating from twitch-notifications What moves and what changes

Machine-readable docs

URL Use
https://upnext.timmo.dev/llms.txt Compact page index
https://upnext.timmo.dev/llms-full.txt Full docs bundle
https://upnext.timmo.dev/mcp Hosted MCP (search, page and navigation)
/{route}.md One page as Markdown

Last updated on