From f0ee4472019442e1a8907952ec03b07dc3e7c480 Mon Sep 17 00:00:00 2001 From: Jeffrey Li Date: Tue, 27 Oct 2026 17:33:53 -0400 Subject: [PATCH 1/2] Add internet radio as a source: paste a stream's address The source menu (S) gets a fifth row, a radio button and a field for a stream's address: the stream itself, MP3 or AAC from an Icecast or Shoutcast server, over http or https. Toaster comes with no stations: a stream is its station's to offer, and many don't let apps come with theirs. The last address that played is remembered with the other settings. It plays through an audio element as a file does (playElement, now shared with useFile), read cross-origin so the analysis hears it. The app's page is a file, which may read any stream that way; on the web page a stream only plays if its server allows it, and an https page can't play an http stream, which the error says. The CSP's media-src allows http and https for it. A stream that ends or drops says so and brings back the source menu, as system audio does when it stops. Stream titles (ICY metadata) aren't read, so the radio is untitled, like an input. Co-Authored-By: Claude Opus 5.5 --- README.md | 14 +++++++++----- docs/how-it-works.md | 17 ++++++++++++++++- renderer/app.js | 45 ++++++++++++++++++++++++++++++++++++-------- renderer/index.html | 5 +++-- renderer/style.css | 5 +++-- tools/serve.mjs | 2 +- 6 files changed, 69 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index dd11698..426303c 100644 --- a/README.md +++ b/README.md @@ -63,7 +63,7 @@ These are the keys as they come; every one can be changed in the help (**?**): c | Key | Does | | --- | --- | -| S | audio source: system audio, demo beat, file, input | +| S | audio source: system audio, demo beat, file, input, radio | | V | background: spectrum, tunnel, spiral, pitch wheel, warp, cuts, worlds, chrome, spectrogram, scenery, rain, scope, fire, off (each described under [Backgrounds](#backgrounds)) | | A | how strongly the ASCII background (spectrum, rain, scope) shows: soft (how it used to be), normal, bold. The code lines sit on their own bands, so they stay readable. With the worlds on, A picks their look instead: auto (film, and on each drop another look for 8 bars), night (as auto, but every world keeps a dark sky with its stars, so no cut lights the whole screen; with fewer flashes on, the worlds always have night skies), film, ASCII (the planet as text, each character in its own colour), code (the planet drawn in the song's own code the way ASCII art draws a picture: as many characters as the world is bright there, each in its colour, the world faint underneath), ink (the theme's two colours, dithered as the ID card's picture is), and the Locust Worlds page's print finishes: risograph, cyanotype, receipt, thermal camera, night vision, CRT, VHS, quadtree; and cells, the planet cut into cells of the worlds around it, turning over cell by cell into the next on each cut (after Days of Glitch's moving cells). A print look covers the planet, or the sky when the code sits over the planet. With chrome, A turns its collage off and on; with the spectrogram, it switches its colours between the rainbow and the theme's own; with the scenery, its scene: auto (a new one each song), the lake, the sea, the campfire, the snow, the city in the rain, the garden, the falls, Halloween, the sharks, the festival, the koi pond, space, the eye, and last auto again in the theme's two colours. With the handheld game on (P), A goes round the game's screens instead: Toaster's own (in the theme's colours), neon, an old LCD. Remembered | | R | orb, over whichever background is picked (or none): after libraries.dev's Thinking Orbs, a cloud of 2,200 soft dots in 3D that holds a form for 8 bars and then flows, dot by dot, into the next, landing on the phrase's one: a sphere, a glitch ball (after animoscillator's glitch orb: the dots fade into a ball of neon noise smeared into streaks, each kick dropping fresh noise in and each bar's first kick breaking it up again), a crystal (a cube of dots on its corner), orbit paths with their dots running round them and bright particles among them, a staff the bass notes appear on as they're played, a spiral galaxy, a network its signals run through on the hats, a field of waves riding the spectrum, a sphere in slices that turn one a beat and then solve themselves (Thinking Orbs' moves), a globe's lines, a ring, an icosahedron, rings swelling with their bands of the spectrum, a burst of rays, ripples on a disc, and an outline that changes shape on the bar. The kick breathes it out, the clap spins it, the hats send a band of light round it, the bass swells the dots. Timed off the beat like the blocks | @@ -94,7 +94,8 @@ These are the keys as they come; every one can be changed in the help (**?**): c | H / F | hide header and footer / fullscreen | The background and its strength, blocks, orb, card, glass, theme, camera effect and drop-effect -choices are remembered between launches, and so are the keys; the camera always starts off. +choices are remembered between launches, and so are the keys and the radio's address; the camera +always starts off. ## Backgrounds @@ -171,9 +172,10 @@ More on all three in [docs/how-it-works.md](docs/how-it-works.md). Everything Toaster hears and sees stays on your machine. The sound is worked out in the app, and the camera (off until you press C) is looked at by the system's own face detector (Windows' face detector, or the Mac's Vision framework) and by Google's MediaPipe, both running on your machine. -Nothing is uploaded. It reaches the internet for two things only: GitHub, when it starts, to see -whether there's a newer Toaster (turn that off in the help, under Updates), and strudel.cc when you -press O (your browser opens it with the code in the link). +Nothing is uploaded. It reaches the internet for three things only: GitHub, when it starts, to see +whether there's a newer Toaster (turn that off in the help, under Updates), strudel.cc when you +press O (your browser opens it with the code in the link), and the radio's stream while it plays +(from the server at the address you typed). ## Good to know @@ -182,6 +184,8 @@ press O (your browser opens it with the code in the link). - The song's title (and its cover, for the ID card) come from the system's media controls (Windows' media controls, or the Mac's Now Playing), so any player that shows up there works: Spotify, browsers and the rest. +- The radio (S) plays an internet radio stream whose address you paste in; Toaster comes with no + stations. More in [docs/how-it-works.md](docs/how-it-works.md#the-radio). - For the finger frame, the portals and the hand signs, keep your hands a little inside the camera's picture. - On a touch screen (an iPad, say), ☰ in the header opens every key as a button, each showing what it's set to. - What it can and can't hear yet: the end of [docs/how-it-works.md](docs/how-it-works.md). diff --git a/docs/how-it-works.md b/docs/how-it-works.md index 60b8d49..e496981 100644 --- a/docs/how-it-works.md +++ b/docs/how-it-works.md @@ -55,6 +55,21 @@ from its first frame, so every clip is an ordinary video, nothing cut or stitche works alongside M. While it's on, the rec button shows ✂; it costs a video encoder or two running all the time, so it's off until you turn it on. +## The radio + +The radio (in the source menu) plays an internet radio stream from the address you paste in: the +stream itself, MP3 or AAC from an Icecast or Shoutcast server, not the station's page or its .pls or +.m3u playlist (the stream's address is inside those). Toaster comes with no stations (a stream is +its station's to offer, and many don't let apps come with theirs), so you bring the address; the +last one that played is remembered. It plays through the app the way a file does, so the blocks are +timed the same way. The song titles a stream carries aren't read, so, as on an input, a new song +starts the code over when Toaster hears a new tempo or a pause. If the stream ends or drops, it +says so and the source menu comes back. + +The stream is read cross-origin (CORS), the only way the analysis hears sound from another server. +The app's page is a file on your machine, which may read sound from any server; on the web page a +stream only plays if its server allows it, and an https page can't play an http stream. + ## The camera Everything the camera sees stays on this machine. While it's on, two things look at it: @@ -74,7 +89,7 @@ a second to set up on the graphics card; after that it starts at once. If the mo (`hand_landmarker/hand_landmarker/float16/1/`, `face_landmarker/face_landmarker/float16/1/` and `image_segmenter/selfie_segmenter/float16/latest/`). -To look at the page in a browser (only the demo beat, files and inputs work there): +To look at the page in a browser (only the demo beat, files, inputs and some radio streams work there): `node tools/serve.mjs`, then open http://localhost:5173. ## The blocks diff --git a/renderer/app.js b/renderer/app.js index 223791e..0bc16d5 100644 --- a/renderer/app.js +++ b/renderer/app.js @@ -141,6 +141,7 @@ const state = { sceneryScene: 'auto', // and its scene (A too): auto (a new one each song), or one by name calm: false, // fewer flashes (the help's setting; on at first if Windows' animations are off) updates: true, // look for a newer Toaster when it starts (the help's setting) + radio: '', // the radio's address, as last played seenVersion: '', // the version last opened, to tell what's new after an update firstRun: false, // nothing saved yet: this is the first time Toaster has opened hushed: false, // every part muted and the picture dimmed (a raised fist, or Q) @@ -153,7 +154,7 @@ let col = { bg: [5, 29, 181], fg: [255, 255, 255], ink: [2, 11, 69] }; // The look you picked (background and its strength, blocks, orb, card, glass, theme, drop effect) // is remembered between launches. The camera always starts off. -const SAVED = ['keys', 'codeHidden', 'crt', 'strength', 'blocks', 'blockLook', 'gameScreens', 'orb', 'card', 'cardV', 'cardBig', 'glass', 'theme', 'drop', 'syncTrim', 'camFx', 'calm', 'updates', 'worldLook', 'chromeCollage', 'spectroTheme', 'sceneryTheme', 'sceneryScene', 'seenVersion']; +const SAVED = ['keys', 'codeHidden', 'crt', 'strength', 'blocks', 'blockLook', 'gameScreens', 'orb', 'card', 'cardV', 'cardBig', 'glass', 'theme', 'drop', 'syncTrim', 'camFx', 'calm', 'updates', 'worldLook', 'chromeCollage', 'spectroTheme', 'sceneryTheme', 'sceneryScene', 'radio', 'seenVersion']; function loadSettings() { let saved = {}; try { @@ -245,7 +246,7 @@ function attach(node, source, label) { state.label = label; tapRecording(); clips.retap(); - // a file or the demo plays from its start; system audio and inputs may be halfway through a song + // a file or the demo plays from its start; system audio, inputs and the radio may be halfway through a song freshStart(source === 'file' || source === 'demo'); $('menu').hidden = true; document.body.classList.add('live'); @@ -314,17 +315,19 @@ async function useDemo() { attach(state.demo.out, 'demo', 'demo beat'); } -async function useFile(file) { +// A file or the radio: an audio element, played to the speakers and heard by the analysis. load +// gives it what to play, once it's this pick's turn. +async function playElement(source, label, load) { const ticket = ++picking; await ac.resume(); if (outdated(ticket)) return; detach(); - const el = new Audio(URL.createObjectURL(file)); - el.loop = true; + const el = new Audio(); + load(el); const node = ac.createMediaElementSource(el); node.connect(ac.destination); state.el = el; - attach(node, 'file', file.name); + attach(node, source, label); try { await el.play(); } catch (err) { if (state.el !== el) return; // a newer source already took over detach(); @@ -335,7 +338,29 @@ async function useFile(file) { $('status').textContent = restingStatus(); throw err; } - if (outdated(ticket)) el.pause(); + if (outdated(ticket)) { el.pause(); return; } + // (a stream that ends, or anything that drops, says so, as system audio does when it stops) + el.onended = el.onerror = () => { if (state.el === el) showMenu(`${label} stopped playing. Pick a source.`, 'warning'); }; +} + +async function useFile(file) { + await playElement('file', file.name, (el) => { el.src = URL.createObjectURL(file); el.loop = true; }); +} + +// The radio: the stream at an address you paste in (Toaster comes with no stations). It's read +// cross-origin, the only way the analysis hears another server's sound (see docs/how-it-works.md). +async function useRadio(address) { + let url = null; + try { url = new URL(address.trim()); } catch { /* not an address */ } + if (!['http:', 'https:'].includes(url?.protocol)) throw new Error("That isn't a stream's address: paste one that starts with http:// or https://."); + const label = url.host + url.pathname.replace(/\/$/, ''); + const browser = desktopApp() ? '' : ` In a browser, a stream only plays if its server lets other sites play it, and an https page can't play an http stream: the Toaster app for Windows or Mac has neither limit (${$('b-star').href}).`; + await playElement('radio', label, (a) => { a.crossOrigin = 'anonymous'; a.src = url.href; }).catch(() => { + throw new Error(`Could not play ${label}. The station may be off the air, or this isn't the stream itself (MP3 or AAC) but the station's page or a .pls or .m3u playlist (open one of those in a text editor: the stream's address is in it).${browser}`); + }); + if (state.source !== 'radio') return; // (another pick took over before it played) + state.radio = url.href; // (kept for next time once it plays) + saveSettings(); } // What went wrong when the microphone wouldn't open, said so it can be acted on. iOS asks about the @@ -498,6 +523,8 @@ function currentSong() { if (state.source === 'system') return state.winSong; if (state.source === 'demo') return { title: 'demo_beat', artist: 'Toaster' }; if (state.source === 'file') return { title: state.label.replace(/\.[^.]+$/, ''), artist: 'File' }; + // (an input or the radio: no title, which also lets the engine drop a beat that's gone, as when + // a station goes from a song to talking: see song() in engine.js) return null; } @@ -1527,6 +1554,7 @@ $('go-system').onclick = run(useSystem); $('go-demo').onclick = run(useDemo); $('go-file').onclick = () => $('file').click(); $('go-input').onclick = run(chooseInput); +$('radio').onsubmit = (e) => { e.preventDefault(); useRadio($('radio-url').value).catch(showError); }; // (its button, or Enter in the field) $('file').onchange = () => { const f = $('file').files[0]; if (f) useFile(f).catch(showError); $('file').value = ''; }; $('b-source').onclick = () => showMenu(); // (on a touch screen, with no Esc: the menu closes with its button, or a tap beside it) @@ -1740,7 +1768,7 @@ addEventListener('keydown', (e) => { const k = e.key.toLowerCase(); if (!visMenu.hidden) { showVisMenu(false); if (k === 'escape') return; } if (k === 'escape') { closeMenu(); return; } - if (e.target.closest('#alerts')) return; // let Enter/Space press the message box's button + if (e.target.closest('#alerts, #menu:not([hidden]) input')) return; // let Enter/Space press the message box's button, and an address be typed if (k === '?' || k === '/') { $('help').showModal(); return; } if (k === 'f11') { e.preventDefault(); window.nc?.toggleFullscreen(); return; } const act = byKey.get(k); @@ -1790,6 +1818,7 @@ window.nc?.version?.().then((v) => { }); loadSettings(); +$('radio-url').value = state.radio; newsRows(); $('b-rec').dataset.title = `Record a video of the window, with the sound, into ${onMac() ? 'Movies/Toaster' : 'Videos\\Toaster'}`; applyKeys(); diff --git a/renderer/index.html b/renderer/index.html index 98ea346..bb9edb0 100644 --- a/renderer/index.html +++ b/renderer/index.html @@ -2,7 +2,7 @@ - + Toaster @@ -99,6 +99,7 @@

toaster

built-in test track or drop a file on the window a mic or line-in +

Nothing is recorded or uploaded. Esc closes this.

@@ -148,7 +149,7 @@

how it works

H / Fhide the header and footer / fullscreen Imachine readout setup - Saudio source: system audio, demo beat, file, input + Saudio source: system audio, demo beat, file, input, radio Ename the song yourself [ / ]blocks timing: ] if they land late, [ if early diff --git a/renderer/style.css b/renderer/style.css index 0c5a02b..c2539f1 100644 --- a/renderer/style.css +++ b/renderer/style.css @@ -398,9 +398,10 @@ html.darwin.full header { padding-left: 12px; } .card { width: min(620px, 100%); border: 2px solid var(--fg); background: var(--bg); padding: 26px; } .card h1 { margin: 0; font-size: 28px; } .card .sub { margin: 6px 0 20px; color: var(--dim); } -.opts { display: grid; grid-template-columns: max-content 1fr; gap: 10px 14px; align-items: center; } +.opts { display: grid; grid-template-columns: max-content minmax(0, 1fr); gap: 10px 14px; align-items: center; } .opts button { font-size: 14px; padding: 8px 14px; text-align: left; } .opts span { color: var(--dim); font-size: 12px; } +#radio { display: contents; } /* (its button and field sit in the grid as the other rows do) */ .tip { font-size: 12px; line-height: 1.5; margin: 16px 0 0; color: var(--dim); } /* a touch screen (an iPad has no Esc or S): the bars stay readable while playing, the menu has a way out, and the buttons are big enough to hit */ .menu-close { display: none; } @@ -613,7 +614,7 @@ dialog .vtag { color: var(--dim); font-size: 11px; margin-left: 4px; } dialog tr.sec th { text-align: left; padding: 12px 0 4px; color: var(--dim); font-weight: 400; letter-spacing: .12em; text-transform: uppercase; font-size: 11px; } dialog form { text-align: right; margin-top: 14px; } #rename-form { display: grid; gap: 10px; text-align: left; } -#rename-form input { font: inherit; padding: 6px 8px; background: transparent; color: inherit; border: 1px solid var(--dim); } +#rename-form input, #radio-url { font: inherit; padding: 6px 8px; background: transparent; color: inherit; border: 1px solid var(--dim); } #rename-form button { justify-self: end; } #device-list { display: grid; gap: 8px; margin: 8px 0; } #device-list button { text-align: left; } diff --git a/tools/serve.mjs b/tools/serve.mjs index 4abe25a..f9e2d67 100644 --- a/tools/serve.mjs +++ b/tools/serve.mjs @@ -1,5 +1,5 @@ // Serves the app's page as a plain web page (http://localhost:5173), for looking at the UI in a -// browser. Outside the desktop app only the demo beat, files and audio inputs work as sources. +// browser. Outside the desktop app only the demo beat, files, audio inputs and the radio work as sources. import { createServer } from 'node:http'; import { readFile } from 'node:fs/promises'; import { extname, join, normalize, sep } from 'node:path'; From 2700b26274a6080f7707ad5f39795da91bd62bdd Mon Sep 17 00:00:00 2001 From: Jeffrey Li Date: Tue, 27 Oct 2026 17:34:06 -0400 Subject: [PATCH 2/2] List a few radio stations that publish their streams for other players docs/radio-stations.md: five stations whose own pages publish their stream addresses for listening in other players, and whose terms allow it (Radio Paradise, WFMU and its Drummer channel, Radio Swiss Jazz, Deutschlandfunk Nova), each linked to the page the address comes from and marked when its server lets the browser version play it. Toaster doesn't read the list; it's for copying an address into the radio. Linked from the README and docs/how-it-works.md. Co-Authored-By: Claude Opus 5.5 --- README.md | 3 ++- docs/how-it-works.md | 3 ++- docs/radio-stations.md | 29 +++++++++++++++++++++++++++++ 3 files changed, 33 insertions(+), 2 deletions(-) create mode 100644 docs/radio-stations.md diff --git a/README.md b/README.md index 426303c..bd2dcfb 100644 --- a/README.md +++ b/README.md @@ -185,7 +185,8 @@ press O (your browser opens it with the code in the link), and the radio's strea (Windows' media controls, or the Mac's Now Playing), so any player that shows up there works: Spotify, browsers and the rest. - The radio (S) plays an internet radio stream whose address you paste in; Toaster comes with no - stations. More in [docs/how-it-works.md](docs/how-it-works.md#the-radio). + stations, but [docs/radio-stations.md](docs/radio-stations.md) lists a few that publish theirs. + More in [docs/how-it-works.md](docs/how-it-works.md#the-radio). - For the finger frame, the portals and the hand signs, keep your hands a little inside the camera's picture. - On a touch screen (an iPad, say), ☰ in the header opens every key as a button, each showing what it's set to. - What it can and can't hear yet: the end of [docs/how-it-works.md](docs/how-it-works.md). diff --git a/docs/how-it-works.md b/docs/how-it-works.md index e496981..788687d 100644 --- a/docs/how-it-works.md +++ b/docs/how-it-works.md @@ -60,7 +60,8 @@ all the time, so it's off until you turn it on. The radio (in the source menu) plays an internet radio stream from the address you paste in: the stream itself, MP3 or AAC from an Icecast or Shoutcast server, not the station's page or its .pls or .m3u playlist (the stream's address is inside those). Toaster comes with no stations (a stream is -its station's to offer, and many don't let apps come with theirs), so you bring the address; the +its station's to offer, and many don't let apps come with theirs), so you bring the address +([radio-stations.md](radio-stations.md) lists a few stations that publish theirs for any player); the last one that played is remembered. It plays through the app the way a file does, so the blocks are timed the same way. The song titles a stream carries aren't read, so, as on an input, a new song starts the code over when Toaster hears a new tempo or a pause. If the stream ends or drops, it diff --git a/docs/radio-stations.md b/docs/radio-stations.md new file mode 100644 index 0000000..d5088cb --- /dev/null +++ b/docs/radio-stations.md @@ -0,0 +1,29 @@ +# Radio stations + +Toaster comes with no stations: the radio (in the source menu, S) plays whatever stream address you +paste in. These few stations publish their streams' addresses on their own sites for listening in +other players. Toaster doesn't read this list; copy an address from it. +Each links to the station's page the address comes from, so if one stops working, the current one +is there. Most of them run on their listeners' donations: if you listen a lot, give them something. + +- **Radio Paradise**: an eclectic mix of rock, pop, electronic, world music and jazz, picked by + people. `https://stream.radioparadise.com/aac-128` + ([its stream links](https://radioparadise.com/listen/stream-links), with its other channels). + Plays in the browser too. +- **WFMU**: freeform radio from the New York area, each DJ playing what they like. + `https://stream0.wfmu.org/freeform-128k` ([its streams](https://wfmu.org/audiostream.shtml)). + The app only: its server doesn't let other sites play it. +- **WFMU's Give the Drummer Radio**: WFMU's second channel, soul, funk, garage, psych and more. + `https://stream0.wfmu.org/drummer` ([its page](https://wfmu.org/drummer), in the playlist it + links). The app only. +- **Radio Swiss Jazz**: jazz, swing, soul and blues around the clock from the Swiss public + broadcaster, with no ads and no presenters. `https://stream.srg-ssr.ch/srgssr/rsj/mp3/128` + ([its internet page](https://www.radioswissjazz.ch/en/reception/internet)). Plays in the browser + too. +- **Deutschlandfunk Nova**: German public radio, much of it talk, with indie and pop in between. + `https://st03.sslstream.dlf.de/dlf/03/128/mp3/stream.mp3?aggregator=web` + ([how to listen](https://www.deutschlandfunknova.de/info/empfang)). Plays in the browser too. + +Checked October 2026. A station only goes on this list if it publishes the address itself for other +players and nothing found in its terms objects; some popular ones (SomaFM, for one) ask apps not +to use their streams.