ChatterinoWatch

Browser extension that reports the Twitch channel you're watching to Chatterino.

Built with TypeScript and Bun.

Installation

From Stores (Recommended)

• Chrome: Chrome Web Store
• Firefox: Firefox Add-ons

Manual Install

1. Install Bun
2. Build extension:

   git clone https://github.com/miguVT/ChatterinoWatch.git
   cd ChatterinoWatch
   bun install
   bun run build

3. Load in browser:
   • Chrome: chrome://extensions Developer Mode Load unpacked dist/chrome
   • Firefox: about:debugging Load Temporary Add-on dist/firefox/manifest.json

Chatterino Setup

1. Open Chatterino and navigate to Settings

2. Go to the Browser Integration category

3. Under "Additional extension IDs," add the appropriate ID:

   For Chrome:

   pnpdojeoploiomepdhikamokjmapkimh

   For Firefox:

   [email protected]

4. Click OK and you're all set!

Development

bun install          # Install dependencies
bun run dev          # Watch mode
bun test             # Run tests
bun run validate     # Full check (lint + format + test + typecheck)
bun run build        # Build all browsers
bun run release      # Full release pipeline

See DEVELOPMENT.md for details.

Features

• Automatic Twitch channel detection
• Real-time Chatterino sync
• Cross-browser (Chrome/Firefox)
• Manifest V3
• TypeScript strict mode
• 95%+ test coverage

Requirements

• Chrome 88+ or Firefox 109+
• Chatterino with native messaging
• Bun v1.0+ (development only)

Documentation

• CHANGELOG.md - Version history
• docs/DEVELOPMENT.md - Dev guide
• PRIVACY.md - Privacy policy
• LICENSE - MIT License

Fun fact

Yes, apparently (at least for git and how GitHub verifies contributor status), Linus Torvalds is listed as a contributor.
No, he didn’t really work on this project, it was just a little git/GitHub easter egg!
If you’re curious, this is a known developer meme that sometimes shows up in open source projects like this.

License

MIT - see LICENSE file.