Twitch Stream Swapper

What it does

• Priority list: add streamers and drag to set priority.
• Per-channel on/off: switch a channel off to have Auto-Swap skip it without removing it from the list (it still shows live status and can still notify).
• Auto‑Swap (optional): manages one Twitch tab and redirects it to the top live streamer.
• Category fallback (optional): if nobody is live, it can pick a random stream from a category.
• On‑page status pill: shows when Auto‑Swap is active; indicates fallback mode and lets you pick a new random.

Install

• Chrome Web Store: coming soon.
• From source (developer mode):

npm ci

1. Open chrome://extensions/
2. Enable Developer mode
3. Click Load unpacked → select this repo folder

Quick start

1. Open the extension popup → add streamers → drag to reorder
2. Toggle Auto‑Swap ON (it binds to a single managed Twitch tab)
3. (Optional) Enable Category Fallback in Options and pick a category

Privacy

• Stores your stream list and settings locally in Chrome storage
• Does not sell personal data
• See docs/PRIVACY.md

For maintainers

• Package ZIP: npm run package (outputs to dist/)
• Releases: tag vX.Y.Z → GitHub Actions builds and uploads the ZIP to a GitHub Release
• Token broker (recommended for production): token-broker/
  • Deployment/security notes: docs/token-broker/SECURITY.md
• Manual QA checklist: docs/TESTING.md

Contributing

PRs welcome. Please run:

npm run lint
npm test

License

MIT — see LICENSE.