Frontend changes: - Add advanced mode toggle switch for cron expressions - Show cron expression input with helpful examples when enabled - Display format hints: "minute hour day month weekday" - Provide common examples (daily, weekly, every 6 hours, etc.) - Conditionally render simple or advanced scheduling UI - Support switching between simple and advanced modes Backend changes: - Add cron_expression to schedule settings (SETTING_KEYS, DEFAULTS) - Update get_schedule_settings to include cron_expression - Update update_schedule_settings to handle cron_expression - Extend _sync_periodic_task to parse and use cron expressions - Parse 5-part cron format: minute hour day_of_month month_of_year day_of_week - Create CrontabSchedule from cron expression or simple frequency - Add validation and error handling for invalid cron expressions This addresses maintainer feedback for "custom scheduler (cron style) for more control". Users can now schedule backups with full cron flexibility beyond daily/weekly. |
||
|---|---|---|
| .github | ||
| .idea | ||
| apps | ||
| core | ||
| dispatcharr | ||
| docker | ||
| frontend | ||
| scripts | ||
| .dockerignore | ||
| .gitattributes | ||
| .gitignore | ||
| 1.png | ||
| 2.png | ||
| 3.png | ||
| 4.png | ||
| 5.png | ||
| CHANGELOG.md | ||
| debian_install.sh | ||
| fixtures.json | ||
| LICENSE | ||
| manage.py | ||
| Plugins.md | ||
| README.md | ||
| requirements.txt | ||
| version.py | ||
🎬 Dispatcharr — Your Ultimate IPTV & Stream Management Companion
📖 What is Dispatcharr?
Dispatcharr is an open-source powerhouse for managing IPTV streams and EPG data with elegance and control.
Born from necessity and built with passion, it started as a personal project by OkinawaBoss and evolved with contributions from legends like dekzter, SergeantPanda and Bucatini.
Think of Dispatcharr as the *arr family’s IPTV cousin — simple, smart, and designed for streamers who want reliability and flexibility.
🧪 What’s New in Beta
Dispatcharr has officially entered BETA, bringing powerful new features and improvements across the board:
✨ Proxy Streaming Engine — Optimize bandwidth, reduce provider connections, and increase stream reliability
📊 Real-Time Stats Dashboard — Live insights into stream health and client activity
🧠 EPG Auto-Match — Match program data to channels automatically
⚙️ Streamlink + FFmpeg Support — Flexible backend options for streaming and recording
🎬 VOD Management — Full Video on Demand support with movies and TV series
🧼 UI & UX Enhancements — Smoother, faster, more responsive interface
🛁 Output Compatibility — HDHomeRun, M3U, and XMLTV EPG support for Plex, Jellyfin, and more
✨ Why You'll Love Dispatcharr
✅ Full IPTV Control — Import, organize, proxy, and monitor IPTV streams on your own terms
✅ Smart Playlist Handling — M3U import, filtering, grouping, and failover support
✅ VOD Content Management — Organize movies and TV series with metadata and streaming
✅ Reliable EPG Integration — Match and manage TV guide data with ease
✅ Clean & Responsive Interface — Modern design that gets out of your way
✅ Fully Self-Hosted — Total control, zero reliance on third-party services
Screenshots
🚀 Get Started in Minutes
🐳 Quick Start with Docker (Recommended)
docker pull ghcr.io/dispatcharr/dispatcharr:latest
docker run -d \
-p 9191:9191 \
--name dispatcharr \
-v dispatcharr_data:/data \
ghcr.io/dispatcharr/dispatcharr:latest
Customize ports and volumes to fit your setup.
🐳 Docker Compose Options
| Use Case | File | Description |
|---|---|---|
| All-in-One Deployment | docker-compose.aio.yml | ⭐ Recommended! A simple, all-in-one solution — everything runs in a single container for quick setup. |
| Modular Deployment | docker-compose.yml | Separate containers for Dispatcharr, Celery, and Postgres — perfect if you want more granular control. |
| Development Environment | docker-compose.dev.yml | Developer-friendly setup with pre-configured ports and settings for contributing and testing. |
⚒️ Building from Source (For the Adventurous)
⚠️ Warning: Not officially supported — but if you're here, you know what you're doing!
If you are running a Debian based operating system you can install using the debian_install.sh script. If you are on another operating system and come up with a script let us know! We would love to add it here!
🤝 Want to Contribute?
We welcome PRs, issues, ideas, and suggestions!
Here’s how you can join the party:
- Follow our coding style and best practices.
- Be respectful, helpful, and open-minded.
- Respect the CC BY-NC-SA license.
Whether it’s writing docs, squashing bugs, or building new features, your contribution matters! 🙌
📚 Roadmap & Documentation
- 📚 Roadmap: Coming soon!
- 📖 Documentation: Dispatcharr Docs
❤️ Shoutouts
A huge thank you to all the incredible open-source projects and libraries that power Dispatcharr. We stand on the shoulders of giants!
⚖️ License
Dispatcharr is licensed under CC BY-NC-SA 4.0:
- BY: Give credit where credit’s due.
- NC: No commercial use.
- SA: Share alike if you remix.
For full license details, see LICENSE.
✉️ Connect With Us
Have a question? Want to suggest a feature? Just want to say hi?
➡️ Open an issue or reach out on Discord.