Credits

Credits and licenses

• BubbleFacts

  Free and open source under the MIT license. The BubbleFacts name and logo are trademarks and aren't covered by that license. It's 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, reviews and tests every change, and is responsible for what's released. See the AI disclosure. The code is on GitHub.

• Open source it's built on

  Open source components

  Project	What it does here	License
  Electron	Turns BubbleFacts into a desktop app	MIT
  node-llama-cpp	Connects the app to the built-in AI	MIT
  llama.cpp	Runs the AI model on your computer	MIT
  Node.js	Runs the fact server in the Linux app	MIT
  Web Scrobbler metadata-filter	Some of the rules for reading the artist and song from a YouTube title follow it	MIT
  Everything else	Express, ws, the Anthropic SDK and the smaller packages they use, each with its license text	Mostly MIT and ISC

• The AI model

  Meta's Llama 3.2 3B Instruct, used under the Llama 3.2 Community License. Llama 3.2 is licensed under the Llama 3.2 Community License, Copyright © Meta Platforms, Inc. All Rights Reserved.

  The optional Larger AI model: Meta's Llama 3.1 8B Instruct, used under the Llama 3.1 Community License. Llama 3.1 is licensed under the Llama 3.1 Community License, Copyright © Meta Platforms, Inc. All Rights Reserved.

• Wikidata

  Some facts, such as a song's year and album, or a classical piece's catalog number, come from Wikidata, whose structured data is in the public domain (CC0).

• MusicBrainz

  When Wikidata doesn't have them, BubbleFacts uses release dates, albums and composers from MusicBrainz, and it asks MusicBrainz which artist recorded a title that came with no artist. MusicBrainz's core data is in the public domain (CC0).

• Wikipedia

  Facts are rewritten from Wikipedia articles, whose text is shared under CC BY-SA 4.0. Bare facts, like a year or a composer's name, aren't covered by copyright, but wording taken from an article can be, and then the license asks you to credit Wikipedia. Captions are short rewrites, so most never reach that line. When a caption quotes a few of someone's own words, those words belong to the person quoted. Crediting the sources is still the safest habit, though a credit line on its own doesn't settle every possible use, and this isn't legal advice. Put this in your stream panel or in the description of published videos (Copy credit line, under Help and troubleshooting in the app, copies it):

  Song facts from Wikipedia (CC BY-SA 4.0), Wikidata and MusicBrainz, shown with BubbleFacts.

  Wikipedia's text comes without any warranty: see Wikipedia's general disclaimer.

• Facts written by an AI the streamer chose

  Saw a bubble on a stream that said "Some facts are adapted from Wikipedia (CC BY-SA 4.0) by an AI the streamer chose"? Here's what it means.

  BubbleFacts writes its facts with its own built-in AI. This streamer chose a different AI: an online service, such as Groq or Anthropic, or an AI model on their own computer. That AI rewrites short facts from the song's Wikipedia article, whose text is shared under CC BY-SA 4.0. BubbleFacts doesn't control or test that AI, so it can't vouch for what it writes. Its accuracy tests before each release cover only the full app's own AI.

  So these facts are not written or verified by BubbleFacts. They may be wrong, incomplete or out of date, and they may not keep to BubbleFacts' content rules (about the music, and family-friendly). Don't rely on them for anything important. Other facts on the stream may come from Wikidata and MusicBrainz, or be the streamer's own. Spot a mistake? Let the streamer know: they chose the AI, and they decide what shows on their stream.

  BubbleFacts is free software, provided "as is", without warranty of any kind, under the MIT license. To the extent the law allows, its authors aren't liable for facts written by an AI the streamer chose, or for how those facts are used. The AI's provider has its own terms. BubbleFacts isn't affiliated with or endorsed by Groq, Anthropic or Ollama.

• Thanks

  To our beta testers, DarkN8V, Epic Realms, izzyparadox, MacYoda and SaxDragon: thank you for your time, your bug reports and your ideas. BubbleFacts is better because of you.

  Special thanks to charliesbeats, for being the best mod ever.

  Thanks also to everyone in the music streaming and StreamerSongList communities who tried BubbleFacts, asked questions or shared an idea; to the volunteers who write Wikipedia and build Wikidata and MusicBrainz, where every fact starts; and to the open source developers listed above.

• Other services and trademarks

  StreamerSongList and StreamElements are separate services. BubbleFacts is not affiliated with or endorsed by any of the apps and services it works with, including those two, Streamling, Nightbot, the Now Playing app, the OBS Project and Twitch. All product names are trademarks of their owners and are used only to say what BubbleFacts works with.