What's new: BubbleFacts

Version 2.2.0 November 10, 2026

Facts ready the moment a song starts, a look for every stream, and fewer wrong facts. Shaped by beta testers' live streams.

New: Prepare my songs writes facts for your list ahead of time, only while OBS is closed and your computer is plugged in. Off until you turn it on in Settings.
New: Styles and icons for the bubbles, under Bubbles: Classic, Light, Minimal, Retro game or High contrast, or your own colors. A change shows on stream as soon as you click Save.
New: a vertical overlay for phone-shaped streams.
New: bubbles about the good artists do, such as charity work and benefit shows. At most one a song.
New: original songs by Twitch artists can get facts from the artist's Twitch About page. Connect Twitch to use it.
New: the bubble that says where the facts come from shows at least once each stream, the moment you go live in OBS.
Improved: fewer wrong facts. BubbleFacts keeps to the right artist, recording and work, and video game songs get facts from the game's article. No more facts about a song's or artist's failures.
Improved: on a busy or slower computer, BubbleFacts writes fewer, quicker facts and gives the AI less of the computer.
Improved: setup asks where bubbles go, and Settings is shorter with a Save bar that stays in view.
Changed: High quality is now called Larger AI. Standard is still the one we recommend.
Changed: online AIs and Ollama are a legacy choice, leaving BubbleFacts in 3.0. Their facts carry a bubble saying BubbleFacts hasn't verified them. BubbleFacts Lite is retired; this is its last update.
Fixed: an OBS source that stops answering reconnects by itself, and the built-in AI tries again if it fails to load.
Fixed: songs prepared before the fact rules changed are prepared again.
Security: in-app updates now check a signature on each release.
Accuracy, measured: about 6% of facts wrong or misleading with the default Standard AI (range 4 to 8%) on 160 fresh songs. Wrong is the backstop. Details in #172.

Version 2.2.0-rc.2 Release candidate, November 9, 2026

Fixes for bubbles that stopped showing in OBS and for songs that got only your own facts. Thanks to everyone who reported it. 2.2.0 is this code unless testing finds a blocker.

Improved: video game songs, where the game is the artist, now get facts from the game's Wikipedia article. Before, most of them fell back to your own facts only.
Improved: the log now says how many OBS sources each batch of bubbles reached, and names any that were sent bubbles and drew none.
Fixed: an OBS source that stopped answering is dropped and reconnects by itself, and a restart no longer locks a song to your own facts.
Fixed: if the built-in AI fails to load, BubbleFacts tries again twice, a few minutes apart, and loading it no longer makes the next songs skip the AI.

Version 2.2.0-rc.1 Release candidate, November 8, 2026

Viewers always see where the facts come from, BubbleFacts stops vouching for other AIs, and Lite's last update. The 2.2.0 release candidate: 2.2.0 is this code unless testing finds a blocker.

New: the bubble that says where the facts come from shows at least once each stream, even with its setting off, and goes out the moment you go live in OBS.
New: facts written by an online AI or your own Ollama carry a bubble saying they are adapted by an AI the streamer chose and not verified by BubbleFacts.
Changed: online AIs and Ollama are a legacy choice, leaving BubbleFacts in 3.0. Anyone who already chose one keeps it until then; a new install doesn't offer them.
Changed: BubbleFacts Lite is retired. This is its last update; installing the full BubbleFacts keeps your settings and facts.
Improved: the Settings warning, the guide and the credits page say plainly that BubbleFacts doesn't control or test another AI, instead of claiming the same screening.
Fixed: with no AI writing (Lite, or while the AI downloads), the credit no longer says the facts were retold by AI.
Fixed: messages and docs no longer point to a removed online option when the built-in AI can't run or a download fails.
Accuracy, measured: about 6% of facts wrong or misleading with the default Standard AI (range 4 to 8%) on 160 fresh songs, checked blind with a second independent checker. Details in #172.

Version 2.2.0-beta.4 Beta, November 7, 2026

A choice of bubble icons, safer in-app updates, and a clearer name for the larger AI.

New: an Icon choice under Settings, Bubbles, next to Style: the Style's own, music symbols, heart, star, moon or diamond. It shows on stream as soon as you click Save.
New: for designers of custom looks, a stable --bf-icon setting, a short design guide and a preview page that shows a look without the app, all on GitHub.
Improved: Light, Minimal, Retro game and High contrast each use one plain icon in the Style's own colors, so it never clashes. Classic keeps its rotating symbols.
Improved: High quality is now called Larger AI. In our latest fact check it was not more accurate than Standard, so Standard is still the one we recommend.
Improved: Troubleshooting starts with a fix for bubbles that vanish after a new Custom CSS: empty the Custom CSS box in OBS and click OK.
Fixed: a song whose album has no usable name no longer shows "appears on -".
Security: in-app updates now check a signature on each release's checksum list, not only the checksum. Earlier releases carry no signature, so updating from beta.3 or earlier opens the download page.
Security: the library that runs the built-in AI is updated, clearing known advisories.

Version 2.2.0-beta.3 Beta, November 2, 2026

Facts ready the moment a song starts, a Style for every stream, and BubbleFacts Lite.

New: Prepare my songs writes facts for your list ahead of time, only while OBS is closed and your computer is plugged in. Off until you turn it on in Settings; Your songs shows how many are ready.
New: Styles for the bubbles, under Bubbles: Classic, Light, Minimal, Retro game or High contrast, or your own colors. OBS's Custom CSS still wins.
New: BubbleFacts Lite, a smaller download without the AI engine, for Mac, Windows and Linux.
New: a new Style or Bubble size shows on stream as soon as you click Save, with no Refresh in OBS.
Improved: on a busy or slower computer, BubbleFacts writes fewer, quicker facts and gives the AI less of the computer.
Improved: more facts for songs with short articles, from their album or soundtrack page.
Improved: your StreamerSongList sign-in is checked when BubbleFacts starts, so an expired one is caught before the show.
Improved: facts about the music come first, and your own facts take turns fairly.
Fixed: on Linux, BubbleFacts (not Lite) stayed on "Getting BubbleFacts ready" and never showed facts (also fixed in 2.1.1).

Version 2.1.1 November 2, 2026

A fix for Linux. On Mac and Windows nothing changes; update when it's convenient.

Fixed: on Linux, BubbleFacts (not Lite) stayed on "Getting BubbleFacts ready" and never showed facts. It starts as it should now.

Version 2.2.0-beta.2 Beta, November 1, 2026

Vertical bubbles for phone-shaped streams, and facts for original songs by Twitch artists.

New: a vertical overlay for phone-shaped streams.
New: when no source knows an original song's artist, BubbleFacts can check that artist's Twitch About page. Connect Twitch, then choose Check Twitch for artists no source knows.
Improved: release posts in Discord now say what's new.

Version 2.2.0-beta.1 Beta, November 1, 2026

Fewer wrong facts, bubbles about the good artists do, and an easier setup. Several fixes came from beta testers' live streams.

New: bubbles about the good artists do, such as charity work, benefit shows, public roles and honors. At most one a song, told as plain public acts.
New: Share song facts with other apps, so an app that takes song context can use the song's facts. Off until you turn it on.
New: Anthropic and Groq models for your AI.
Improved: fewer wrong facts. BubbleFacts keeps to the right artist, recording and work, checks data facts harder, and drops captions that lose their context.
Improved: no more facts about a song's or artist's failures.
Improved: setup asks where bubbles go and keeps them off Now Playing, and Settings is shorter with a Save bar that stays in view.
Improved: no facts for commercials and station idents, and the dashboard shows how long the AI took.
Improved: reduced motion in the overlay, and screen reader fixes in the app.
Fixed: steadier recovery from crashes and outages, and settings stay put through a restart.

Version 2.1.0 October 30, 2026

More ways to follow your music, facts the moment a song starts, and fewer wrong ones. Shaped by beta testers' live streams.

New: follow a now playing file instead of a song list. Streamling and Nightbot are one click, or pick any app that writes the song to a text file. In Settings, under Your song list.
New: No facts for this song and No facts for this artist, under Your facts for a song, or one click under Earlier songs.
Improved: more classical pieces find the right article, catalog numbers and nicknames included.
New: now and then, a bubble says where the facts come from. Turn it off under Bubbles.
Improved: basic facts show the moment a song starts, and the AI's facts follow when they're ready.
Improved: with StreamerSongList, BubbleFacts hears the moment you move to the next song, and the dashboard says whether it's listening live or checking every 15 seconds.
Improved: fewer facts about the wrong song, game, film, place or person.
Improved: a stronger family-friendly filter leaves out scandals, crime and threats, and anything that labels who a person is. No filter is perfect, so Wrong is always there.
Fixed: an overlay that reloads mid-song, after a scene switch or with a second output, gets the rest of that song's bubbles.
Security: the app's framework (Electron) and two small libraries are updated with security fixes.

Version 2.1.0-beta.2 Beta, October 26, 2026

Bubbles keep up with your queue, and fewer facts about the wrong thing. Several fixes came from beta testers' live streams.

Improved: with StreamerSongList, BubbleFacts hears the moment you move to the next song, instead of up to a minute later.
New: the dashboard says how BubbleFacts hears about your songs: live updates, or checking every 15 seconds.
Improved: a game's article is used over a film with the same name.
Improved: fan uploads titled "Song - Artist" are read the right way round, and a city or country's article is never taken for a song.
Fixed: a different middle initial now means a different person, so one artist's facts don't land on a near namesake.
Fixed: a viewer's name in a "Commissioned by" or "requested by" note is never searched, sent to the AI or written to the log.
Improved: the High quality AI setting says what it does, without promising a level of accuracy.
Security: the app's framework (Electron) and two small libraries are updated with security fixes.

Version 2.1.0-beta.1 Beta, October 23, 2026

The first 2.1 beta: more ways to follow your songs, facts that show the moment a song starts, and fewer wrong ones. Shaped by beta testers' live streams.

New: follow a now playing file instead of a song list. Streamling and Nightbot are one click, or pick any app that writes the song to a text file. In Settings, under Your song list.
New: No facts for this song and No facts for this artist, under Your facts for a song, or one click under Earlier songs.
New: now and then, a bubble says where the facts come from. Turn it off under Bubbles.
New: classical pieces get facts about the right piece, catalog numbers and nicknames included.
Improved: basic facts show the moment a song starts, and the AI's facts follow when they're ready, so a busy computer no longer leaves songs empty.
Improved: fewer facts about the wrong song, game or album, and the year and album often come as one bubble.
Improved: facts stay family-friendly: no scandals, crime or threats, and nothing that labels who a person is.
Fixed: songs with a year or a "(feat. ...)" in the title, and artists with a note in brackets, find their article.
Fixed: pressing Wrong during a song also clears the rest of that song's bubbles from the same source.
Fixed: an overlay that reloads mid-song, after a scene switch or with a second output, gets the rest of that song's bubbles.
Fixed: YouTube titles like "Artist_Song" or "Song - The Tonight Show" are read as the right song.

Version 2.0.1 October 19, 2026

Fixes, most of them found on real streams. Update when it's convenient; your settings and facts stay.

Improved: classical pieces such as Beethoven's Minuet in G keep their own article, instead of a list of other composers' minuets
Improved: artists written with symbols, such as P!nk and Ke$ha, find their songs' articles
Fixed: some true facts were dropped, such as a song title starting with "My" or "We", a date written "3 and 5 June", or a title with "After" in it
Fixed: changing the artist of a request that isn't on your list, mid-song, now writes new facts
Fixed: StreamElements could check for songs twice at once
Fixed: Settings accepts ports up to 65535, and About opens once
Fixed: with fact checking turned off, the AI is no longer told to expect an article it won't get
Fixed: the command-line setup starts with a Groq or Anthropic key, or with StreamElements

Version 2.0.0 Stable, October 15, 2026

The first stable release, which is 2.0.0-rc.2 with only the version number changed. Everything since 1.0 in one place: the desktop app, and a new name. Stream Facts is now BubbleFacts. Download it, open it, and click through setup. No Terminal needed.

Installers for Mac, Windows and Linux
A built-in AI that downloads on its own, with nothing extra to install
A two-step setup: connect your songs, then put BubbleFacts on your stream by dragging one tile into OBS
Works right away: songs get facts from Wikidata, MusicBrainz and your own facts while the built-in AI downloads
Add your own facts in Settings, or for one song
A dashboard showing what's playing and the facts shown, with Pause bubbles and Show a test bubble
Wrong, Report it and Report a problem buttons
Fixes itself: if something stops, it restarts on its own
Runs in the menu bar or system tray
Tells you when a new version is out

Known issue: with the default Standard AI, about 1 in 10 facts were wrong or misleading on songs our fixes had never seen. (This note first said 8% and 3%, from test lists that also shaped the fixes.) Press Wrong, or set up Hands-free Wrong, to take one off your stream. Getting under 5% is planned for 2.1.0.

Release notes on GitHub

Version 2.0.0-rc.2 Release candidate, October 12, 2026

The last release candidate: 2.0.0 will be this version with only the number changed, unless testing finds a blocker.

Improved: the default Standard AI retells its article more plainly, and fewer wrong or misleading facts get through. It now gets clear instructions and writes the same way each time, the fact screens are stricter, and when more facts pass than there are bubbles, the ones the article backs best are shown.
Improved: Send a beta test report and Copy beta test report show in release candidates too, under Help and troubleshooting.
Fixed: on a Mac, the first launch after an update opens the BubbleFacts window before asking about your saved sign-in, so the prompt can't hide behind other windows.

Version 2.0.0-rc.1 Release candidate, October 6, 2026

The first release candidate: the features of 2.0 are final, and what's left before 2.0 is fixing what testing finds, starting with fewer wrong facts on the default AI.

New: a High quality choice for the built-in AI, in Settings, under Advanced. In our first fact checks it made about half as many mistakes; later, stricter checks found it made more than Standard, so it is now called Larger AI. It's a bigger download (about 5 GB) and needs 16 GB of memory and a graphics chip that can hold it; Standard stays the default.
New: Show a LIVE LEARN bubble during a live learn, under Bubbles, to turn that bubble off like the Now Playing one.
Improved: many more songs find their Wikipedia article, including artists credited together ("A - B", "A x B", "ft."), version tags written onto the title, covers that name the original in brackets, and remixes with the game after a dash. Thanks to SaxDragon's song list.
Improved: fewer wrong or misleading facts. Bubbles now drop words put in someone's mouth, a detail moved to the wrong record or person, and an unnamed "the duo" or "this chart".
Fixed: Bottom center sits at the very bottom when the Now Playing bubble is off. Thanks to izzyparadox.
Fixed: an update on a Mac that couldn't open its download now tries again, and BubbleFacts always reopens either way.
Fixed: two issues found by GitHub's code scanning (a pattern that could run slowly on unusual text, and how the Linux start-at-login entry is written).

Version 2.0.0-beta.13 Beta, October 4, 2026

Facts you write for a whole game or artist now take turns across its songs.

Improved: a fact in Your own facts that starts with a game or artist in brackets, like [Chopin], is shared by all their songs: each song gets one, taking turns, and the rest of its bubbles stay about the song. Before, those facts opened every one of the songs the same way. A song with its own facts gets one too, while there's room. Facts tagged with one song's title work as before. Thanks to izzyparadox for the idea.

Version 2.0.0-beta.12 Beta, October 3, 2026

The last beta before the release candidates: hands-free Wrong, fewer wrong facts, and finishing touches.

New: Hands-free Wrong. A key, foot pedal or Stream Deck marks the bubble on stream as wrong, so you never stop playing. Settings, under Bubbles.
New: Add facts for another song searches your song list as you type, and fills in the title and artist exactly.
New: bubbles can stay in one fixed spot (top left, center or right; bottom left, center or right), under Where bubbles appear.
New: choose Stable or Beta updates in Settings, under General.
New: Copy report under Help and troubleshooting, to send a problem report without a GitHub account. The app also shows its exact build, and what's new after an update.
Improved: about 40% fewer wrong or misleading facts, measured by checking facts for 100 songs from two beta testers' lists against their sources. Work toward fewer still continues before 2.0.
Improved: many more songs find their Wikipedia article, including titles marked [Instrumental], artists like "Star Trek TV" or "Mass Effect Series", misspelled names and traditional songs.
Improved: custom facts live in one place. The example fact packs are gone; an empty box shows examples to follow.
Improved: error messages in plain words, with what to do; your song facts show their limits as you type; unsaved Settings changes wait while you look elsewhere; easier to read and zoom.
Fixed: marking Wrong under Earlier songs no longer takes a bubble off the stream when that song is playing again.
Fixed: Pause holds when OBS reconnects mid-song; saving your facts for a song no longer says it failed while the AI is busy; a fact tagged for one version of a song stays with that version.
Fixed: Wrong on one of your own facts now says so and opens it for editing; a creator's link shows even without a songwriter.

Thanks to izzyparadox and SaxDragon for letting us check their whole song lists, and to charliesbeats, the best mod ever.

Version 2.0.0-beta.11 Beta, October 3, 2026

Wrong after the song, facts from another music content creator's channel, and a safety check of everything.

New: Earlier songs on the dashboard. Spotted a wrong fact while playing? Mark it Wrong after the song, no need to stop.
New: Connect Twitch (optional, in Settings). Then, for another music content creator's song, Fill from their Twitch About fills in facts from their channel's About, for you to check before saving.
Safer: after a security review of the whole app, a bubble can never show a link, a chat command or an @mention, whatever a request's title says. Only OBS can connect to BubbleFacts. The built-in AI only accepts the exact file it expects. Restoring a backup never changes which AI you use.
Fixed: Show a test bubble during a song no longer clears that song's bubbles.
Fixed: a fact marked Wrong stays off even if BubbleFacts restarts, and Pause bubbles stays on if BubbleFacts has to recover from a problem mid-song.
Improved: OBS picks BubbleFacts back up within a few seconds when you open it, and the app says "Connecting to OBS" meanwhile instead of asking you to add it.
Improved: Add facts for another song is a button on the dashboard, and About your own compositions opens right under I play my own compositions.
Improved: clearer setup wording, a Groq key hint, and Troubleshooting and Ask on Discord buttons in the app's help.

After updating, right-click the BubbleFacts source in OBS and choose Refresh.

Version 2.0.0-beta.10 Beta, October 2, 2026

Fixed: on a Mac, after an update, the request for your password could still appear before the BubbleFacts window (beta.7's fix missed one early check). Now the window opens first and tells you to click Always Allow.

Version 2.0.0-beta.9 Beta, October 2, 2026

Your facts are backed up for you, and bubble timing says what it does.

New: BubbleFacts backs up your settings and facts by itself whenever they change, and keeps the last 20. Back up… and Restore… move them to another computer. Your sign-in is never in a backup.
Improved: the bubble timing settings now read A new bubble every (seconds) and Each bubble stays up (seconds), with a line saying whether bubbles show one at a time or overlap.
Improved: the About page says BubbleFacts isn't affiliated with Twitch.

Thanks to izzyparadox for the timing question that led to the clearer labels.

Version 2.0.0-beta.8 Beta, October 2, 2026

Bubbles that really sit at the bottom, and an About page.

Fixed: with Where bubbles appear set to the bottom, bubbles showed just below the middle of the screen. They now sit on the bottom edge, and the first ones of a song keep clear of the Now Playing bubble.
New: an About page, also in the tray menu, with credits, thanks, and the license of everything BubbleFacts is built on and where its facts come from.

Thanks to izzyparadox for spotting where the bubbles really landed.

Version 2.0.0-beta.7 Beta, October 2, 2026

A sign-in fix, two settings testers asked for, and no more repeated bubbles. (There was no public beta.6: its fixes are all here.)

Fixed: signing in with StreamerSongList could stop at step 2 with "Connected to ." and a blank overlay. BubbleFacts now starts as soon as you're signed in.
Fixed: a live learn typed as a video title got no facts with the built-in AI.
Fixed: a full disk while downloading an update now shows a message.
Changed: notes about your own compositions show only when the song's artist is your channel name or Your name on stream. A friend's piece tagged "Originals" no longer gets them.
New: choose where bubbles appear: anywhere, or the top, bottom, left or right of the screen. Settings, then Bubbles.
Mac: after an update, the window opens before your Mac asks to use your saved sign-in, and tells you to click Always Allow.
A restart, or reloading the BubbleFacts source in OBS, no longer replays bubbles the song already showed.
New: turn off the Now Playing bubble if your own overlay already shows the song. Settings, then Bubbles.
More bubbles per song: true facts that only mention a game or a colleague are no longer held back, and an award is checked against who won it.
Game tracks draw on the game's music article when it has one, so two songs from one game get different facts.
A fellow streamer's piece (an @handle as the artist) is no longer looked up.
The log lists each fact shown and its source.

Thanks to izzyparadox for finding the sign-in bug and asking for the two new settings.

Version 2.0.0-beta.5 Beta, October 1, 2026

Facts with more color, sources you can check, and an app that updates itself.

More interesting facts: what the people who made the music said about it, who and what influenced it, how it's built (with music terms explained in plain words), and how it did on the charts and at awards.
See where a fact came from: click its source on the dashboard to read the sentence it was written from and open the article.
Updates from inside the app: Update now downloads and checks the new version, and Install now swaps it in. Nothing installs without your click. This starts with the version after this one.
Live learns get facts when BubbleFacts can find the song, under the LIVE LEARN banner.
Your originals lead with your own notes about your compositions. "Hasn't come up in N days" is gone.
BubbleFacts learns how your song list is written: the game in the artist field, "Game - Track" with the composer, "Track (Film)", and more.
Game tracks with their own Wikipedia article use it, and a song's article is preferred to its album's.
Add facts for this song has one box per fact, so a long fact stays one fact. Your own facts get an Edit button where they show.
Saving a setting no longer restarts BubbleFacts mid-song unless the change needs it.

Release notes on GitHub

Version 2.0.0-beta.4 Beta, October 1, 2026

Facts that tell viewers something new, a shorter setup, and custom facts for one song.

No more facts viewers already know: a caption that only repeats the title and the artist on the request is skipped.
Setup ends as soon as the test bubble shows: click Start using BubbleFacts. Originals and live learns are optional, and in Settings.
Custom facts for one song, artist or game: start the line with its name in brackets, like [Song of Storms] It plays in a windmill. It shows only for that, first.
Add facts for this song works before a show: click Preparing a different song? and type its title and artist. Settings lists every song you've done this for, with Edit and Remove. A creator's link always gets its bubble.
The dashboard says why a song is quiet: still looking, no reliable facts, or a live learn. Quiet is normal.
Stricter fact check: a credit needs the article to tie that person to that role, not just mention both.
Shorter Settings: the example fact packs and the choice of AI are under Advanced. The instrument setting is gone.
An online AI, if you choose one, is sent the song and the article only. Nothing about you.
Send a beta test report under Help and troubleshooting fills in your version and computer for you.

Release notes on GitHub

Version 2.0.0-beta.3 Beta, September 30, 2026

StreamElements song requests, a Wrong button, and more facts for songs Wikipedia doesn't know.

StreamElements works as a song source, besides StreamerSongList. Choose it in setup or in Settings and paste your JWT token. BubbleFacts reads the artist and song from each request's YouTube title, and reads YouTube's auto-generated uploads exactly.
A Wrong button next to each fact under On stream now. One click takes the fact off your stream, and BubbleFacts never uses that fact's source for that song again, even after a restart. Undo if you clicked by mistake, and Report it (opens GitHub) if you'd like to tell us. It replaces Report this fact.
Add facts for this song: give any song its own facts, like another streamer's original. They show exactly as you write them, and a songwriter is only credited when you name one.
The dashboard says where each fact came from: Wikipedia, Wikidata, MusicBrainz, your song list or your own facts.
Songs with no Wikipedia article can get facts from Wikidata, then MusicBrainz. These are plain sentences filled in from their data, with no AI involved. Titles in Japanese, Korean, Chinese or Cyrillic are looked up as written.
Backup facts are now called custom facts. The example packs are off by default, and with no custom facts, a song no source knows gets no bubbles.
Better matching: fewer wrong articles, such as a band matched to a game with a similar name. When only the artist's article exists, facts about the song itself come first.
Stricter fact check: a caption saying who composed, wrote or directed something needs the article to say so.
Better facts: no critics' opinions, nothing about the music video, no repeats from earlier songs, and no song length.
Copy credit line under Help and troubleshooting, for your stream panel or video descriptions.
Pausing a StreamElements song no longer stops BubbleFacts. If a song is playing but not followed, the dashboard says so, and BubbleFacts reconnects on its own.
Linux: the built-in AI no longer crashes, and the app warns you if your computer has no keyring to protect your saved token.

Thanks to SaxDragon for testing StreamElements.

Release notes on GitHub

Version 1.0.0 September 28, 2026

First public release: the command-line version, for people comfortable with Terminal. It's still available for anyone who prefers it.

Release notes on GitHub