a desktop tv and program guide for over-the-air broadcasts: what's on air, what your tuner gets, live tv, recordings https://src.rest/cat/airwaves/ 2026-11-02T10:05:17-07:00 9d065f2720a3a4e979cb659e5749205ecdf300a1 FelineStateMachine 2026-11-02T10:05:17-07:00 2b8cb8bf4a85460eab914d3e692ddc0d08844d43 cat 2026-10-17T16:56:18-06:00 .forge/ci runs go vet ./... and go test ./.... forge attest runs it in a clean worktree of each commit and signs the result into refs/notes/ci, and forge push sends it with the branch. Go's build and module caches live outside the worktree, so runs stay warm. eb0d5925c0b71bad3e7a6aa5b196779b408ba286 FelineStateMachine 2026-10-13T18:31:15-06:00 The column the episode picked and the grid share took the width of the picked episode's title and description, set on one line: 1,300 to 2,300 pixels in a 966-pixel area, so the grid of episodes changed its columns with every pick and ran off the screen. It now keeps to its area, as Recordings' library does. The episode picked also takes the same room whichever it is: room for two lines of title (a longer one ends in "..."), three of description, the actions and the hint, the words at the bottom by the actions. Its picture is its column's width rather than the height of the words, which made it grow past its column. On a phone the actions stay in one row, scrolling sideways, as the guide's do. 7c7538696d7df66799a95ff8c3c2fe3ab17da0e8 FelineStateMachine 2026-10-13T18:20:51-06:00 Adding a show waited for yt-dlp's one listing job at a time, which the YouTube channels hold for minutes while they list a whole catalog for their schedules. Its two minutes ran out while it waited, so it failed the moment its turn came, and pressing Add again only queued more. Now adding a show lists it at once, a few seconds' work, as a search does. The background listings and lookups still take turns, but their time starts when their turn does, so a busy channel no longer fails them. Podcasts has Refresh under the shows in the rail (also R), for someone who wants the newest now rather than at the next listing, every 6 hours while YouTube's feeds are down. The server lists every show again, a few at once, and the app says how many episodes are new and when every show was last checked. In Settings, Add says it's still adding when pressed again, a channel found says how many subscribers it has as YouTube does (3.39M), and one already a show says Added. Names from YouTube lose the spaces around them. 6129c5cc215d1cf96465e8d95f51f0b14a43c950 FelineStateMachine 2026-10-12T20:44:00-06:00 A browser counted as a touch screen only if it had no fine pointer at all. A Galaxy phone with an S Pen reports one, so it got the desktop layout, where nothing answered a tap or a swipe on the picture. Now its main pointer decides. Taps and swipes are also taken from a finger in any layout, as on a laptop's touch screen. On TV a swipe over the banner, or over the timeline, counts as one over the picture. The browser no longer takes a drag on the banner as a scroll, which ended the swipe. f6cf4475353c7a4ce39af19307372557698e221a FelineStateMachine 2026-10-12T20:38:35-06:00 On a phone held sideways the controls covered about 70% of the picture, so a tap aimed at the picture landed on the banner: it put the controls away but left the banner up with no timer. Now, on a short touch screen, the controls draw tighter (what's next is left to the guide) and cover about half. A tap anywhere off a button puts the banner away with them, as a phone's video players do. The tap is listened for on the picture and the banner themselves, since an iPhone sends a tap's click only to what listens for one. A finger's stand-in mouse events no longer act a second time. Two quick taps in a list were also a double click, playing again what the second tap had already played. A tap's move was also a pointer brought to the screen. The first tap unmutes a picture that started muted on the tap's click, not when the finger lands, which browsers don't count as the user's yet. 114b5948464065e2b8c9804bfd3d2dd85de51dba FelineStateMachine 2026-10-12T16:00:32-06:00 The web app has a manifest, icons rendered from the launcher's art, and a service worker that keeps nothing offline but says when the server can't be reached, so a phone or a browser can install it from a secure address such as a Tailscale Service. Touch is its own platform (body.pf-touch, js/touch.js), found by a touch screen without a mouse: a tap on TV brings up the controls, swipes skip and change channel, the guide swipes through the hours, a second tap watches or plays, and holding a program shows its actions. Nothing names keys. A phone on its side gets a compact banner and guide, and the picture-in-picture goes; held upright it asks to be turned. The tests check that no name is declared in two of the app's files, which share one scope. b7fa79df4c0b287deb4035649bf617a915722eb4 FelineStateMachine 2026-10-12T15:42:41-06:00 An episode's English captions (the uploader's, else YouTube's own) are fetched with where it streams from, ahead for the newest, and go to the app as a WebVTT rendition timed from where the stream starts: its first sound, since a copied picture starts at the key frame before. WebKit calls a player stalled when it has all it needs and stops fetching, as an on-demand stream does; the waiting mark then stayed up over a picture that played on. It now shows only while the picture has stopped, and goes once it moves. fec7b36daab98507804a811045f0da73552c3040 FelineStateMachine 2026-10-12T15:33:08-06:00 A card clips what it holds, so a long list squeezed each to a sliver to fit the grid; its rows are now as tall as their cards. 23c10d9f4c476a2b1d380096a2e4858274e8309c FelineStateMachine 2026-10-12T15:30:33-06:00 189823c3efa08791159c5061d0c08adf0bb595b2 FelineStateMachine 2026-10-12T15:29:39-06:00 "Every Episode" says what a playlist holds, not which show; a premiere to come is listed without a title until it airs. 758b5ecc158d5f4e94988fc02b87933acec2e10e FelineStateMachine 2026-10-12T15:26:20-06:00 /api/podcasts lists the shows and their episodes; shows are found with a search for YouTube channels, added by link and taken out; an episode plays like a recording, and how far it was watched is kept. The desktop app and the web app have the same calls, /api/info says when the server has the app, and airwavesd keeps the library in podcasts.json. 6ca783a947264d232cb0a06a1f2be1cb94e76683 FelineStateMachine 2026-10-12T15:26:20-06:00 A show is a channel's videos or past live streams, or a playlist. Its newest 30 episodes are kept, with how far each was watched, in podcasts.json: listed every 6 hours, its channel's feed read every 30 minutes for new uploads, new videos looked up a few at a time, and clips, Shorts and streams to come left out. The newest unwatched episode of each show has where it streams from found ahead. An episode plays through the stream server from where it's asked to, its H.264 picture copied rather than transcoded. 6af73667de0900ad072a29d7039e5074b2dd8bc2 FelineStateMachine 2026-10-12T15:26:20-06:00 internal/youtube has yt-dlp (kept up to date), channel and playlist listings, feeds, search and lookups, and a video's details with where to stream it from. The YouTube channels use it as before; the admin page and airwavesd name it directly. Nothing changes in what they do. d0c9c3523d980295d0f4d7e4091cf3740997dd8f FelineStateMachine 2026-10-12T15:17:43-06:00 df7a6ae652ed8fcba8d23a7364f2e6e41bf57ead FelineStateMachine 2026-10-12T15:13:14-06:00 Laid out as Recordings' library is, with Latest, Continue and a list per show, and played by the recordings' player (now playOnDemand), which shows positions in the whole episode and saves where it got to. Settings, Podcasts adds a show by search or address and removes one. The view stays hidden until the server says it has podcasts. a440a82686881f280b7cc3bab902e6070bdf26e8 FelineStateMachine 2026-10-12T15:09:49-06:00 app.js had grown to 5,000 lines. It's now ten files by area (core, player, input, guide, reception, settings, recordings, captions, playback, weather), loaded in their old order as plain scripts sharing one scope: still no build step, and nothing changes for the TV, which loads them from /tv/ as before. The embed test checks the page loads every file there. dc8aac0ecb5a3da68342ad58ff1a00c869ed575f FelineStateMachine 2026-10-12T15:06:43-06:00 A name for the server alone, such as a Tailscale Service, then opens it. cbf3d1504187045f50d48d207adf5bd91480e7d6 FelineStateMachine 2026-10-12T15:04:19-06:00 The top bar is TV, Guide, Recordings, Weather and More. More is Settings with a tab for each area in the rail, Reception among them: Up and Down pick a tab, OK goes in, Back comes out, as on Android TV. The app is three experiences, chosen once (platform, body.pf-*): a desktop's mouse and keyboard, a console's controller, a TV's remote, with Settings, Display, Layout to change it on a device. What used to ask whether this was the Android TV app now asks what's in hand. While a stream is open the app says so every 30 s, and starts one the server stopped again. A failed recording puts a count on Recordings. 09a035da3052c3bbe8805b6fa14c95c413c9cc3d FelineStateMachine 2026-10-12T15:04:19-06:00 AIRWAVES_PLATFORM says otherwise. 71151f59be443b65522c7e2ccfd70859155e73e2 FelineStateMachine 2026-10-12T14:57:23-06:00 PUT /api/config took a whole config, so an app could move the server's location; the location is the server's own, from its flags. b15ab0845c3b1b1e2e8f8a00c82e7e8c3e28ddd4 FelineStateMachine 2026-10-12T14:57:23-06:00 One way of saving the server's records (store.WriteFile): atomically and synced, the file replaced kept as .bak, and the first save of a day keeps the file as it was in backups/, a week of them. A file that can't be read is set aside as .corrupt-<time> and the newest readable backup read and put back, instead of starting empty; a config with no good backup leaves the defaults rather than a server that won't start. 05a14fcd3a6fe9ee28890acb5ad176b1d7a14a34 FelineStateMachine 2026-10-12T14:57:23-06:00 A stream unfetched and untouched for two minutes is stopped, freeing its tuner when an app quits or a TV is switched off without saying so. A player holding one paused calls POST /api/heartbeat (Heartbeat in the desktop app and web.js), which keeps it and says whether it's still there. 83eee8152f368132ee417a80bcbf5c20cd1c7513 FelineStateMachine 2026-10-12T14:55:04-06:00 e268f0f0c355959355ff9ca4f6dc8fff71299eea FelineStateMachine 2026-10-12T14:55:04-06:00 A scheduled channel that fell more than a few seconds behind joined its next airing part way in, losing however much it was late of the start. Up to two minutes late, the next airing now plays from its top and loses that much of its end instead, as a broadcaster running long would. 2bfb8c61c376ae5f166359c42abb93f088bf5325 FelineStateMachine 2026-10-12T14:38:41-06:00 One conversion for antenna and library channels: cast with roles, first aired date or year, type words players file by (Movie, Series, Sports, News, Children) ahead of genres, running time, an absolute picture for antenna programs too, xmltv_ns, onscreen and dd_progid episode numbers (made up for library programs, so each episode is its own), HD, repeats with when they first aired, premieres, new, live, the rating with its system, stars and a series ID. a2588d9a50700d8c33a35bbe8356f87f04d6af32 FelineStateMachine 2026-10-12T14:26:45-06:00 From a review against what got other clients banned: a 4003 on anything but a login is an old token (as Schedules Direct sometimes says), so it gets one new login rather than stopping the account; pictures are fetched from where they redirect without the token going along to S3; programs are asked for 2000 at a time rather than the 5000 allowed; and up to 2000 pictures an update, of a subscriber's 5000 a day. Saving the account again lifts a picture pause, as a subscription lifts a trial's cap. 9633ca2e7b6a5c1e87223a037d485fc6a0029978 FelineStateMachine 2026-10-12T14:25:00-06:00 The guide's actions had three record buttons side by side. One Record now opens, in its place, to the three choices, the first focused; Esc or another program folds them back. A program without series information keeps the plain Record. R, Shift R and N are as before. b1832427144bb0a1813f8fc378b73fa1c9b6e867 FelineStateMachine 2026-10-12T14:15:39-06:00 The Jellyfin client now asks for each video's people, content rating and genres too, so the guide shows a Jellyfin channel's programs as it does Schedules Direct's: the cast with their characters, the rating (R, TV-14), genres, when it first aired, and up to 1000 characters of the overview rather than 300. The community rating is left out: it's on a 10-point scale, not the guide's 4 stars. 8e08183a288c2d63c3b0c35dd9f26e3675166dde FelineStateMachine 2026-10-12T14:12:16-06:00 Schedules Direct's pictures are behind the token and capped daily, so the server keeps them: for each series or movie aired, one landscape picture, without the title written on it where there's one, near 720 wide, downloaded once into the listings' folder and served at /guide-art/ (on the API and the emulated HDHomeRun, whose XMLTV now gives absolute URLs). Up to 500 a day, the shows on soonest first; the daily cap pauses them until midnight UTC, a picture Schedules Direct hasn't got is never asked for again, and a key without any is looked up again after a week. Listings kept before pictures were fetch them at the next start. The guide hid the program's picture whenever the interface size made its top tight, on a wide window as much as a TV; it now goes only when the window is too narrow for it.