https://github.com/anistark/crunchythread
Crunchyroll 💬 Reddit
https://github.com/anistark/crunchythread
brave-extension browser-extension chrome-extension crunchyroll discussion forum plugin reddit
Last synced: 3 months ago
JSON representation
Crunchyroll 💬 Reddit
- Host: GitHub
- URL: https://github.com/anistark/crunchythread
- Owner: anistark
- License: other
- Created: 2025-11-06T19:45:41.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-12-31T10:38:33.000Z (6 months ago)
- Last Synced: 2026-03-29T21:08:01.585Z (3 months ago)
- Topics: brave-extension, browser-extension, chrome-extension, crunchyroll, discussion, forum, plugin, reddit
- Language: TypeScript
- Homepage: https://chromewebstore.google.com/detail/crunchythread/faghgokfpnffhpknonlghbogjkaafnil
- Size: 207 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# CrunchyThread
> Watch | React | Discuss
>
> No more hunting for episode threads or missing out on live community reactions.
[](https://x.com/crunchythread)
Supports:
     
**CrunchyThread** is a browser extension that connects anime episodes directly to their respective **Reddit discussion threads** — instantly. Works on Chrome, Firefox, and all Chromium-based browsers.
Currently supports **Crunchyroll**, with modular detectors for other streaming platforms coming soon. When you watch an anime episode, CrunchyThread automatically detects the title and episode number, then finds the **matching Reddit discussion thread** (in the anime's subreddit). Shows the thread title, subreddit, and comment stats (upvotes/comments/time) and links directly to the Reddit thread.
As anime fans, we love the shared experience — the memes, theories, and emotional breakdowns — that follow every episode drop.
But right now, you have to:
1. Watch an episode
2. Open Reddit
3. Manually search for the right thread
**CrunchyThread** makes this frictionless.
It's your one-click bridge from *watching* to *talking*.
## 📥 Installation
### From Chrome Web Store
1. Visit [CrunchyThread on Chrome Web Store](https://chromewebstore.google.com/detail/crunchythread/faghgokfpnffhpknonlghbogjkaafnil)
2. Click "Add to Chrome"
3. Confirm permissions
### From Firefox Add-ons
1. Visit [CrunchyThread on Firefox Add-ons](https://addons.mozilla.org) (coming soon)
2. Click "Add to Firefox"
3. Confirm permissions
### Manual Installation (Developer Version)
#### For Chrome/Chromium Browsers
1. Download the latest `crunchythread-chrome.zip` from [GitHub releases](https://github.com/anistark/crunchythread/releases)
2. Extract the `.zip` file
3. Go to `chrome://extensions/`
4. Enable "Developer mode" (top right)
5. Click "Load unpacked"
6. Select the extracted folder
#### For Firefox
1. Download the latest `crunchythread-firefox.zip` from [GitHub releases](https://github.com/anistark/crunchythread/releases)
2. Extract the `.zip` file
3. Go to `about:debugging#/runtime/this-firefox`
4. Click "Load Temporary Add-on"
5. Select the `manifest.json` from the extracted folder
## 🔌 Extensible Detector Architecture
CrunchyThread uses a modular detector system that makes it easy to add support for new streaming platforms:
### Current Support
- ✅ **Crunchyroll** - Fully supported with multi-layer detection
- ✅ **Generic Fallback** - Works on any website using common meta tags and patterns
### Planned Support (TODO)
- 🔜 **Netflix** - Coming soon
- 🔜 **Hulu** - Coming soon
- 🔜 **Prime Video** - Coming soon
- 🔜 **Disney Hotstar** - Coming soon
### Architecture
Each streaming service has a dedicated detector under `src/content/detectors/services/`. The system automatically selects the right detector based on the current domain, falling back to a generic detector for unsupported platforms.
### Adding a New Detector
To add support for a new streaming service:
1. Create a new detector file: `src/content/detectors/services/[service-name].ts`
2. Extend the `BaseDetector` class from `src/content/detectors/base.ts`
3. Implement the `detect()` method to extract anime title and episode number
4. Register the detector in `src/content/detectors/index.ts`
See the **Crunchyroll detector** for a complete example.
## 🤝 Contributing
We welcome contributions! Here are ways you can help:
### Improve Thread Matching
Help us find better subreddits and improve search accuracy:
1. See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup
2. Update the subreddit list in `data/ANIMESUBREDDITS.yaml`
3. Submit a pull request
### Report Bugs
Found an issue? [Open an issue](https://github.com/anistark/crunchythread/issues) on GitHub with:
- What you were doing
- What went wrong
- Your browser version
### Request Features
Have an idea? [Start a discussion](https://github.com/anistark/crunchythread/discussions) on GitHub.
## 📄 License
Licensed under the **MIT License** — see [LICENSE](./LICENSE) file for details.
## 🔒 Privacy & Permissions
CrunchyThread requests the following permissions:
- **Read Crunchyroll pages** — To detect anime title and episode number
- **Read Reddit pages** — To search for public discussion threads
We **never**:
- Collect or store your personal data
- Require you to log in or authenticate
- Send data anywhere except Reddit's public API
- Store any information on our servers
- Sell or share any information
## ❓ FAQ
**Q: Do I need a Reddit account?**
A: No! CrunchyThread searches Reddit anonymously. No login or account required.
**Q: Is this official?**
A: No, CrunchyThread is an unofficial fan project. It's not affiliated with Crunchyroll or Reddit.
**Q: Does this store my data?**
A: No. The extension only searches public Reddit data using the official Reddit API. We don't collect or store any user information.
**Q: Can I use this on Firefox?**
A: Yes! CrunchyThread is available on Firefox. You can install it from [Firefox Add-ons](https://addons.mozilla.org) (coming soon) or manually load it in developer mode.
**Q: How can I add my favorite anime to the database?**
A: Great question! Check [CONTRIBUTING.md](./CONTRIBUTING.md) for the easy steps.
## 📞 Support
- 🐛 **Report bugs**: [GitHub Issues](https://github.com/anistark/crunchythread/issues)
- 💬 **Ask questions**: [GitHub Discussions](https://github.com/anistark/crunchythread/discussions)
- 🎯 **Request features**: [Feature Requests](https://github.com/anistark/crunchythread/discussions/categories/feature-requests)
Made with 💚 for anime fans