BUDDY TV is a Progressive Web App (PWA) designed to stream your favorite TV channels using custom playlists in M3U, JSON, or TXT formats. With a sleek, responsive UI, dark/light theme support, and features like EPG display and channel filtering, it offers a professional streaming experience directly from your browser or as an installable app.
- Playlist Support: Upload M3U, JSON, or TXT playlists via file or URL.
- Channel Management:
- Automatic duplicate removal based on URL and title.
- Filter channels by status (Total, Active, Offline) with clickable stats.
- Search channels by name or group.
- Favorite channels with persistent storage.
- Streaming: Supports HLS (
.m3u8) viahls.jsand native playback for other formats. - EPG: Displays current and next programs with a progress bar (requires EPG data).
- UI/UX:
- Responsive design with a collapsible sidebar.
- Light and dark themes with toggle.
- Fullscreen video mode.
- Custom logo in the header.
- PWA: Installable on desktop/mobile, with offline caching for core assets.
- Local Storage: Persists favorites, upload history, and last playlist.
- Notifications: Welcome message with disclaimer, plus status updates.
- A modern web browser (Chrome, Firefox, Safari, etc.).
- HTTPS hosting for PWA features (e.g., GitHub Pages, Netlify).
- A valid M3U, JSON, or TXT playlist file/URL.
- Clone the Repository:
git clone https://github.com/bugsfreeweb/BuddyTV-Pub.git cd BuddyTV-Pub
-
Replace Placeholders:
- Update
your-usernamein the clone URL with your GitHub username. - Replace screenshot placeholders with actual images (e.g., upload to GitHub or an image host).
- Add your name in the Acknowledgments section.
- Update
-
Screenshots:
- Take screenshots of the app (main interface, upload modal, etc.) and upload them to the repo or a hosting service like Imgur.
-
License:
- If you want a license, create a
LICENSEfile (e.g., MIT License text) and link it in the README.
- If you want a license, create a
-
Hosting:
- Mention your deployed URL (e.g.,
https://your_user_name.github.io/BuddyTV-Pub) if applicable.
- Mention your deployed URL (e.g.,
- Create a new repository on GitHub (e.g.,
BuddyTV-Pub). - Initialize locally:
git init git add . git commit -m "Initial commit" git remote add origin https://github.com/bugsfreeweb/BuddyTV-Pub.git git push -u origin main
- HLS.js (v1.5.13) - Loaded via CDN for HLS streaming.
- Google Fonts (Inter, Playfair Display) - For typography.
- No additional installations are required beyond the included files.
- Edit Styles: Modify styles.css for UI changes.
- Add Features: Update script.js (e.g., new playlist formats, UI enhancements).
- Test Locally: Use a local server and browser DevTools.
BUDDY TV does not host or provide any content. Users must supply their own playlists. The developers are not responsible for the legality, quality, or availability of the streamed content. Use responsibly and ensure compliance with local laws.
- Fork the repository.
- Create a feature branch (git checkout -b feature-name).
- Commit changes (git commit -m "Add feature").
- Push to the branch (git push origin feature-name).
- Open a Pull Request.
This project is licensed under the MIT License - see the file for details.



