Watch with confidence. Community-powered, AI-enhanced trigger warnings for your favorite streaming platforms.
Trigger Warnings is a free, open-source browser extension that provides real-time, community-sourced trigger warnings for streaming platforms like Netflix, Hulu, Disney+, Prime Video, YouTube, and more. Whether you're sensitive to violence, medical imagery, spiders, or other potentially distressing content, this extension gives you advance notice—so you can watch with peace of mind.
Make streaming accessible and comfortable for everyone by:
- 🤝 Community-driven: Warnings created and validated by real people who care
- 🤖 AI-powered: Local computer vision models detect triggers automatically (experimental)
- 🎨 Fully customizable: Choose which warnings matter to you
- 🆓 Free forever: No paywalls, no subscriptions, no tracking
- 🔓 Open source: Built by the community, for the community
Works seamlessly across major streaming services:
- Netflix – Full support with real-time warnings
- Prime Video – Amazon's streaming library
- Hulu – All your favorite shows
- Disney+ – Family-friendly with custom warnings
- Max (HBO Max) – Premium content
- Peacock – NBC's streaming platform
- YouTube – Community-sourced video warnings
- Pre-watch summaries: See all warnings before you start
- Live indicators: Discrete on-screen alerts during playback
- Customizable timing: Warnings appear exactly when you need them
- Skip ahead option: Jump past triggering scenes instantly
- Democratic voting: Upvote/downvote warnings for accuracy
- Quality control: Bad warnings get filtered out automatically
- Contribution system: Add warnings for content you've watched
- Transparent moderation: Community-driven guidelines
- Computer vision models: TensorFlow.js-powered detection
- Privacy-first: All processing happens on your device
- Audio analysis: Detects auditory triggers (e.g., retching sounds)
- Visual recognition: Identifies spiders, medical imagery, and more
- No data leaves your browser: Your viewing history stays private
- Trigger profiles: Multiple sensitivity profiles (work-safe, full warnings, etc.)
- Category selection: Enable only the warnings you need
- Visual customization: Adjust indicator size, position, and style
- Notification preferences: Choose how you want to be alerted
- Visit the Chrome Web Store (coming soon)
- Click "Add to Chrome"
- Click the extension icon and configure your preferences
- Visit Firefox Add-ons (coming soon)
- Click "Add to Firefox"
- Configure your trigger preferences
# Clone the repository
git clone https://github.com/mitchlabeetch/Trigger_Warnings.git
cd Trigger_Warnings
# Install dependencies
npm install
# Build for Chrome
npm run build:chrome
# Build for Firefox
npm run build:firefoxThen load the dist/chrome or dist/firefox folder as an unpacked extension in your browser.
📖 Detailed instructions: See docs/INSTALLATION.md
- User Guide – How to use the extension effectively
- Installation Guide – Platform-specific setup instructions
- FAQ – Answers to common questions
- Contributing Guide – How to contribute to the project
- Architecture Overview – System design and components
- Development Setup – Local development workflow
- API Documentation – Backend integration guide
- Adding Providers – Support new streaming platforms
- Computer Vision – AI/ML detection system
- Community Moderation – Voting and consensus
- Roadmap – Future features and plans
We welcome contributions from developers, designers, writers, and community moderators! Whether you want to:
- 🐛 Fix bugs or improve code
- 🎨 Design better UI/UX
- 📝 Write documentation or translations
- 🗳️ Add trigger warnings for content
- 🧪 Test on different platforms
Please read our Contributing Guide to get started.
- Add warnings: Use the extension to tag triggers in shows you've watched
- Vote on accuracy: Help validate community-submitted warnings
- Report issues: Found a bug? Open an issue
- Code contributions: Check out our good first issues
- Translate: Help make the extension accessible in more languages
- Frontend: TypeScript, Svelte 4, Tailwind CSS
- Build: Vite, vite-plugin-web-extension
- Backend: Supabase (PostgreSQL, real-time subscriptions)
- AI/ML: TensorFlow.js, Transformers.js, CLIP models
- Testing: Vitest, ESLint, Prettier
- Browser APIs: Manifest V3 (Chrome), Manifest V2 (Firefox)
- No tracking: We don't collect browsing history or personal data
- Local processing: AI detection runs entirely in your browser
- Open source: Audit our code anytime—transparency first
- Secure backend: Supabase with row-level security policies
- Anonymous voting: No personal info required to contribute warnings
Read more: SECURITY.md
- Multi-platform provider system
- Real-time warning display
- Community voting mechanism
- Basic UI/UX with Svelte
- Supabase integration
- Computer vision detection (audio + visual)
- Enhanced trigger categories
- Mobile browser support
- Localization (i18n)
- User reputation system
- Content creator partnerships
- API for third-party integrations
- Browser-native notifications
- Advanced filtering (by episode, season, etc.)
Full roadmap: docs/ROADMAP.md
This project is licensed under the MIT License – see the LICENSE file for details.
TL;DR: You can use, modify, and distribute this software freely. Just include the original license and copyright notice.
- Contributors: Thank you to everyone who has submitted warnings, voted, or contributed code
- Streaming platforms: For providing content that brings people together
- Open-source community: Built on the shoulders of giants (Svelte, Vite, Supabase, TensorFlow.js)
- Accessibility advocates: For inspiring this project and making the web more inclusive
- GitHub Issues: Report bugs or request features
- Discussions: Join conversations
- Email: support@triggerwarnings.app (coming soon)
This extension is a community effort and may not catch every triggering scene. Warnings are:
- Submitted by volunteers (not professionals)
- Based on subjective experiences
- Continuously improved through voting
Please use responsibly and trust your own judgment. If you're unsure about content, consider researching it independently or watching with a trusted person.
Made with ❤️ by the community, for the community
⭐ Star us on GitHub • 🐦 Follow on Twitter • 📧 Subscribe to Updates