JioTV TizenMod
A TizenBrew module that brings JioTV-Go streaming to Samsung Smart TVs with full remote control support and TV-optimized interface.
🚀 Features
- Full TV Remote Support: Navigate using Samsung TV remote with d-pad, color buttons, and number keys
- Optimized UI: Big-screen interface designed specifically for TV viewing
- Live TV Streaming: Access 600+ JioTV channels with multiple quality options
- Smart Navigation: Grid-based channel browsing with fast navigation
- Settings Panel: Configure server URLs and playback preferences
- Error Handling: Robust error handling with user-friendly messages
- Background Service: Optional Node.js service for enhanced functionality
📋 Prerequisites
Before installing JioTV TizenMod, ensure you have:
- Samsung Smart TV (2017+ models with Tizen 3.0+)
- TizenBrew installed and working on your TV
- JioTV-Go server running on your local network
- Network connectivity between TV and JioTV-Go server
🔧 Installation
Method 1: NPM Installation (Recommended)
- Open TizenBrew on your Samsung TV
- Navigate to Module Manager
- Add module using NPM:
jiotv-tizenmod
- Wait for installation to complete
- Launch the module from TizenBrew
Method 2: Manual Installation
Method 3: Local Development
- Clone or download this repository
- Host the files on a local web server
- Add to TizenBrew using the local URL
⚙️ Configuration
Initial Setup
JioTV-Go Server Setup
Ensure your JioTV-Go server is running and accessible:
jiotv_go -host 192.168.0.10 -port 1337
The module will connect to: http://192.168.0.10:1337
🎮 Remote Control Guide
Channel Grid Navigation
| Arrow Keys | Navigate through channels |
| Enter/OK | Play selected channel |
| Red Button | Open Settings |
| Green Button | Search (coming soon) |
| Yellow Button | Refresh channel list |
| Blue Button | Show channel info |
| Numbers 0-9 | Direct channel access (in player) |
| Back/Return | Exit application |
Video Player Controls
| Arrow Up/Down | Change channels |
| Arrow Left/Right | Seek backward/forward |
| Enter/OK | Play/Pause |
| Red Button | Exit player |
| Green Button | Channel up |
| Yellow Button | Channel down |
| Blue Button | Cycle quality (HD/SD/LD) |
| Numbers 0-9 | Direct channel tuning |
| Back/Return | Exit to channel grid |
Settings Panel
| Arrow Up/Down | Navigate settings |
| Enter/OK | Select/Edit setting |
| Back/Return | Cancel and close |
🏗️ Module Structure
jiotv-tizenmod/
├── package.json # Module configuration
├── app/
│ ├── index.html # Main application UI
│ ├── styles.css # TV-optimized styling
│ ├── app.js # Core application logic
│ └── remote-control.js # TV remote handling
├── service/
│ └── service.js # Optional background service
└── README.md # This file
🛠️ Development
Local Development Setup
-
Clone the repository:
git clone https://github.com/your-username/jiotv-tizenmod.git
cd jiotv-tizenmod
-
Install dependencies (for optional service):
npm install
-
Start development server:
python -m http.server 8080
npx serve -p 8080
-
Test in TizenBrew by adding: http://localhost:8080
Building for Production
Publishing to NPM
- Update version in
package.json
- Publish to NPM:
npm publish
📡 API Reference
The module communicates with JioTV-Go server using these endpoints:
Get Channels
GET /channels
Response: Array of channel objects
Get Live Stream
GET /live/{channelId}?quality={quality}
Response: HLS stream URL
Channel Data Format
{
"channel_id": "123",
"channel_name": "Channel Name",
"channel_category_name": "Entertainment",
"channel_language_name": "Hindi",
"logoUrl": "http://server/logo.png"
}
🐛 Troubleshooting
Connection Issues
Problem: "Connection Error" message appears
Solutions:
- Verify JioTV-Go server is running and accessible
- Check network connectivity between TV and server
- Ensure firewall allows connections on port 1337
- Try accessing server URL in TV browser directly
Problem: Channels not loading
Solutions:
- Press Yellow button to refresh channel list
- Check JioTV-Go server logs for errors
- Verify server URL in Settings (Red button)
Video Playback Issues
Problem: Video won't play or shows black screen
Solutions:
- Try different quality settings (Blue button in player)
- Check if HLS streams work in TV browser
- Restart JioTV-Go server
- Check server-side stream generation
Problem: Audio/video sync issues
Solutions:
- Try lower quality setting
- Check network bandwidth
- Restart the TV application
Remote Control Issues
Problem: TV remote not responding
Solutions:
- Ensure TizenBrew is properly installed
- Try restarting the module
- Check if other TizenBrew modules work
- Use Samsung TV remote (not universal remote)
Performance Issues
Problem: App is slow or freezing
Solutions:
- Close other TV applications
- Restart Samsung TV
- Use wired network connection
- Clear TV browser cache
📊 Browser Compatibility
Tested On:
- Samsung Tizen 3.0+ (2017+ TVs)
- Samsung Tizen 4.0+ (2018+ TVs)
- Samsung Tizen 5.0+ (2019+ TVs)
- Samsung Tizen 6.0+ (2020+ TVs)
Required Features:
- HTML5 Video with HLS support
- ES6+ JavaScript support
- CSS Grid and Flexbox
- Fetch API
- Local Storage
🔒 Security & Privacy
- No Data Collection: Module doesn't collect personal data
- Local Network Only: Communicates only with local JioTV-Go server
- Optional Analytics: Anonymous usage stats (if background service enabled)
- Open Source: Full source code available for review
🤝 Contributing
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Test on actual Samsung TV
- Submit a pull request
Development Guidelines:
- Follow existing code style
- Test on multiple TV models if possible
- Ensure TV remote navigation works properly
- Update documentation for new features
📄 License
MIT License - see LICENSE file for details
🙏 Acknowledgments
- JioTV-Go Team: For the excellent JioTV server implementation
- TizenBrew Community: For making Samsung TV homebrew possible
- Samsung: For Tizen TV platform
- Contributors: Everyone who helped improve this project
📞 Support
🔄 Version History
v1.0.0
- Initial release
- Full TV remote support
- Channel grid with filtering
- Video player with quality selection
- Settings panel
- Error handling and recovery
Upcoming Features
- Search functionality
- Favorites management
- EPG (Electronic Program Guide) support
- Picture-in-Picture mode
- Multiple server support
Enjoy watching JioTV on your Samsung Smart TV! 📺✨