BubbleFacts™, a free, open-source app for musicians and DJs who stream
Fun facts about the song you're playing, right on your stream.
BubbleFacts follows your song requests or your music player and shows short facts from Wikipedia and open music databases in game-inspired bubbles while you play, each one checked against its source.
Free and open source for Mac, Windows and Linux.
Are you a musician? BubbleFacts follows your song list on StreamerSongList or StreamElements, so facts show up as you move to the next song.
Are you a DJ? BubbleFacts can follow your DJ software or music player through a now-playing text file, with no extra account.
macOS 13+, Windows 10 or 11, or Linux · OBS Studio 28+ · 8 GB of memory · same computer as OBS. Full requirements.
Not signed yet: your computer may ask you to confirm the app the first time you open it. See what to click.
It isn't signed yet, so your computer may ask you to confirm it the first time you open it. Every download is built publicly from the GitHub source. See what to click.
All downloads
- Mac macOS 13 or newer. Need the Intel version? Which Mac do I have?
- Windows Windows 10 or 11
- Linux, Ubuntu and Debian .deb
- Linux, other .AppImage
Works with
- Song requests StreamerSongList · StreamElements
- Music apps Streamling · Nightbot · Now Playing app, for Mixxx and more · any app that saves the song to a text file
- Streaming OBS Studio · Twitch
- Computers Mac · Windows · Linux
Free and open source: every line of code is on GitHub.
Get running in three steps
-
Install and confirm
Install it like any app. The first time you open it, your computer asks you to confirm. See what to click.
-
Connect your songs
Sign in with StreamerSongList, paste a StreamElements token, or pick Streamling, Nightbot or any app that saves the song to a text file.
-
Put BubbleFacts on your stream
Drag it from the app into your OBS Sources list.
A test bubble appears in OBS as soon as you add it, so you know it worked.
No coding. No Terminal. No AI setup. BubbleFacts finishes getting ready in the background, so you don't wait for it.
Made by a musician who streams, so viewers learn about the music they're hearing and the music content creators playing it.
Want to make it yours? Optionally, tell it about your originals and live learns, or add your own facts. The setup guide shows every click.
How BubbleFacts checks its facts
AI can make things up. BubbleFacts is built to keep made-up facts off your stream, so its AI never answers from memory.
- It finds the source first. When a song starts, it looks up the song, or the game or film it's from, on Wikipedia.
- It writes only from that article. The built-in AI rephrases details from the article and adds nothing of its own.
- It screens every caption. Names, who did what, years, consoles, and award or chart claims have to appear in the article, or the caption is dropped. So is anything viewers already know from the request, like the title and artist. That catches most mistakes, not every one: a caption can still mix up details the article does mention. One click on Wrong takes a fact off your stream.
- You can see the source. On the dashboard, each fact says where it came from. Click a Wikipedia fact to see the sentence it was written from.
- No article, no AI. Free music databases fill in plain facts, like the year and the album. If they don't know the song either, it shows your own facts, or nothing.
- Family-friendly, and honest about it. Bubbles stay clear of gossip and scandal and say where their facts come from. No checker is perfect, so Wrong takes a bad fact off for good.
What you'll see on stream
Now playing
Briefly shows the song title when it starts. You can turn it off.
Song facts
Short facts pop up while you play, in the part of the screen and the look you choose.
Playing your own compositions, or learning a request live? BubbleFacts handles those too.
AI disclosure
BubbleFacts is developed with AI assistance. Most of the code so far was generated by Claude Code, Anthropic's AI coding agent. The maintainer, Christopher Feyrer (@frolicchris), is the human in the loop: he reviews and tests every change, including on live streams, and is responsible for everything that's released.
The captions on stream are written from the song's Wikipedia article by a small AI model, by default Meta's Llama 3.2 on your own computer, then screened against the article. Facts from Wikidata and MusicBrainz are fixed sentences filled in from their data, with no AI involved.
BubbleFacts is open source on GitHub, and contributions are welcome, with or without AI tools. See the AI disclosure for details.
Questions
Is it free?
Yes. BubbleFacts is free and open source, and its built-in AI costs nothing to run.
Is it safe and private?
Yes. You sign in to StreamerSongList in your own web browser, so BubbleFacts never sees your Twitch password. Your sign-in, or your StreamElements token, is stored encrypted on your computer (on Linux, that needs a keyring). BubbleFacts looks song titles up on Wikipedia, Wikidata and MusicBrainz, and nothing is sent to this project. The privacy page has the details.
Do I need to know coding?
No. You download an app, connect your songs, and drag it into OBS. If you can add a webcam to OBS, you can do this. The setup guide walks you through every click.
What if a song isn't on Wikipedia?
BubbleFacts looks it up in two free music databases, Wikidata and MusicBrainz, for plain facts like the year and the album. If they don't know it either, it shows your own facts, or no bubbles at all rather than filler. See how to add your own facts.
Can BubbleFacts run on a different computer from OBS?
Not yet. BubbleFacts needs to run on the same computer as OBS. Two-PC setups, such as a music PC plus a streaming PC, aren't supported yet.
Does it work with Streamlabs Desktop?
It should, but it isn't tested yet. Dragging the tile may not work there. Instead, add a Browser source by hand: follow the add-it-by-hand steps. Only OBS Studio is tested.
More questions? See the full list on the help page.