Tel-Radio is a high-performance, open-source streaming directory for global TV and Radio stations. Built with a focus on privacy, speed, and a premium "Midnight Navy" aesthetic.
- Boundaryless Entertainment: Access over 30,000+ live channels and radio stations from 150+ countries.
- Privacy First: Zero trackers, no cookies, and no data collection. Just pure streams.
- Modern HLS Engine: Custom-built video player with sub-second stream ignition and real-time buffer tracking.
- Responsive Midnight UI: A refined, dark-mode-only interface optimized for all devices.
- Ad-Free Experience: Enjoy clean content without traditional web advertisement clutter.
- Frontend: React 18 & Tailwind CSS
- Streaming: HLS.js (HTTP Live Streaming)
- Icons: Lucide React
- Routing: React Router 6
- API: Integrated Global IPTV/Radio Directory, But Now Using json Playlist
Follow these steps to get your local development environment running:
-
Clone the repository
git clone [https://github.com/Code-harness/tv-radio-app.git](https://github.com/Code-harness/tv-radio-app.git) cd tv-radio-app -
Install dependencies
npm install
-
Run the application
npm run dev
-
Build for production
npm run build
Our custom player departs from traditional browser controls. It includes:
- Live Edge Buffer Tracking: A real-time line showing stream loading progress.
- 404 Detection: Automatic detection and user notification if a stream link is broken.
- Volume Controls: Integrated custom slider and mute functionality.
We welcome contributions! If you find a broken stream or want to improve the UI:
- Fork the Project.
- Create your Feature Branch (
git checkout -b feature/AmazingFeature). - Commit your Changes (
git commit -m 'Add some AmazingFeature'). - Push to the Branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Developed with ❤️ by CodeHarness.