JioTV Go 🌟

Introducing JioTV Go: Your gateway to streaming Live TV channels on the web and IPTV! 📺🌐 Say goodbye to the JioTV App, as this project lets you enjoy JioTV's offerings hassle-free. Currently in the development stage, it's designed purely for educational exploration.

Ready to dive in? Download the latest binary for your operating system from here, and explore the API endpoints to start your JioTV Go adventure! 🚀📡🔥

Give us 🌟 on GitHub.

Join the community on Telegram:

JioTV Go 🌟

Usage Guide 🚀

Using JioTV Go Natively

Start your journey by downloading the latest binary for your operating system from the releases page.
For Linux/Unix users, grant executable permissions to the downloaded binary. Use the command chmod +x jiotv_go-..., replacing jiotv_go-... with the actual binary name you've downloaded.
Run the binary with ./jiotv_go-....
Fire up your favorite web browser and visit http://localhost:5001.
To access JioTV content, click on the Login button and enter your credentials.
Choose from a variety of channels and embark on your live TV adventure!
If you're an IPTV enthusiast, you can access the M3U playlist by visiting http://localhost:5001/playlist.m3u.

Android Users, We've Got You Covered!

Dive into the Android world by first downloading Termux.
Open Termux and execute the command DEBIAN_FRONTEND=noninteractive pkg update -y && pkg upgrade -y && pkg install curl openssl -y.
Download our android script by running curl -Lo jiotv_go.sh https://raw.githubusercontent.com/rabilrbl/jiotv_go/main/android.sh.
Grant executable permissions to the script with chmod +x jiotv_go.sh.
Execute the install script with ./jiotv_go.sh install. The script will automatically download the latest binary for your device and install it.
Start the server with ./jiotv_go.sh run.
Open your web browser and visit http://localhost:5001.
To update to latest version, run ./jiotv_go.sh update.

Docker Enthusiasts, Here's Your Shortcut!

If you're a Docker enthusiast, begin by installing Docker.

Run the command

docker run -p 5001:5001 -v ./.jiotv_go/secrets:/app/secrets ghcr.io/rabilrbl/jiotv_go

Open your web browser and visit http://localhost:5001.

To update to latest version, run

docker pull ghcr.io/rabilrbl/jiotv_go:latest

Optional Customizations

Want to specify a custom port or host? No problem! Simply pass host:port or :port as an argument to the binary like this: ./jiotv_go "host:port". If you are using android script, you can pass the port as an argument to the script like this: ./jiotv_go.sh run "host:port".
Disable TS Handler by setting the environment variable JIOTV_DISABLE_TS_HANDLER=true before running the binary. By disabling TS Handler, TS video requests will be served directly from JioTV servers instead of being served through the JioTV Go server. This will reduce the load on the server and will also reduce the latency. This is useful on low-end devices where the server is not able to handle the load and the video playback is laggy/buffering. But remember not to set this variable in remote servers or when using proxy as JioTV servers will block the requests due to different IP address.
If you prefer a specific path or folder for your credentials.json, set the environment variable JIOTV_CREDENTIALS_PATH=/path before running the binary.

EPG (Electronic Program Guide)

To enable EPG, set the environment variable JIOTV_EPG=true before running the binary. This will generate an EPG file at /epg.xml.gz which can be used in IPTV players. M3U playlist will contain the link to this EPG file automatically. You can also access the EPG file at http://localhost:5001/epg.xml.gz.
If enabled, the EPG file is scheduled to be updated at random time during midnight.

Proxy 🌐

If you want to use a proxy, set the environment variable JIOTV_PROXY before running the binary.

Example:

Socks5 Proxy export JIOTV_PROXY="socks5://user:pass@host:port"
All other Proxy export JIOTV_PROXY="user:pass@host:port"

Remote Deployment Made Easy

In cases where remote server permissions prevent the creation of the jiotv_credentials_v2.json file, follow these steps:

On your local machine, log in to JioTV Go to generate your jiotv_credentials_v2.json.
Configure the following environment variables on your remote server:
- JIOTV_SSO_TOKEN - The ssoToken from credentials file.
- JIOTV_CRM - The crm from credentials file.
- JIOTV_UNIQUE_ID - The uniqueId from credentials file.

With these environment variables set, the credentials.json will be bypassed, and your JioTV Go deployment will proceed smoothly. Enjoy the journey!

Explore JioTV Go's Paths and Endpoints 🌐

Web Paths

/: The gateway to the Home Page, where your JioTV Go adventure begins.
/play/:channel_id: Dive into the world of specific channels with ID channel_id.
/playlist.m3u: Instantly obtain an M3U playlist for IPTV. (Redirects to /channels?type=m3u for your convenience.) Add ?q={resolution} resolution: low, medium, high to get the playlist for specific resolution.
/player/:channel_id: Immerse yourself with the default player (Flowplayer) for Channel channel_id.
/clappr/:channel_id: Experience the magic of the Clappr player for Channel channel_id.

API Endpoints

/login/sendOTP: Request an OTP to log in to JioTV.
/login/verifyOTP: Verify the OTP and log in to JioTV.
/channels: Discover the complete list of available channels.
/channels?type=m3u: Effortlessly acquire an M3U playlist for IPTV.
/live/:channel_id: Tune in to live TV with the specified channel ID.

Sneak Peek with Screenshots 📷

Home Page

Player Page

Login Dialog

Playing Live TV on VLC Media Player

Ready to Contribute? Let's Dive into Development! 🚀

JioTV Go is powered by Golang, so let's get started! Here's how to set up and run the server:

Set JIOTV_DEBUG=true to enable automatic reloading on templates changes in views folder and to enable debug logs in console/terminal.

First, make sure you have Golang installed on your system.
Install the necessary dependencies using:
```
go mod download
```
Finally, fire up the server with:
```
go run ./cmd/jiotv_go
```

That's it! You're now all set to explore and contribute to JioTV Go. Happy coding! 🖥️👩‍💻👨‍💻

Customize the Look with TailwindCSS 🎨

At JioTV Go, we use the versatile TailwindCSS to style our project. If you're eager to make some style enhancements, here's how you can do it:

Ensure you have NodeJS installed on your system.
Open a new terminal window and navigate to the project's root directory.
Install the necessary dependencies by running:
```
  npm install
```
To keep TailwindCSS up to date with your changes in real-time, run the following command:
```
npm run watch
```
Once you're satisfied with your style modifications, it's time to build the minified CSS file:
```
npm run build
```

Building JioTV Go from Source 🛠️

Building JioTV Go from source is a breeze! Follow these simple steps:

Open your terminal and navigate to the project's root directory.
Run the following command to build JioTV Go:
```
go build ./cmd/jiotv_go
```

Let's Make JioTV Go Better Together! 🤝

Report Bugs

Found a pesky bug? No worries! Please help us improve JioTV Go by creating an issue here. Be sure to include detailed steps to reproduce the bug, describe the expected behavior, and, if possible, attach screenshots. Your feedback is invaluable!

Ready to Contribute? Join the Journey! 🚀

We wholeheartedly welcome your contributions. If you have ideas, fixes, or enhancements in mind, don't hesitate to create a pull request with your changes. For significant alterations, start by creating an issue to discuss your plans with us. Together, we can make JioTV Go even more incredible.

License: Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)

Embrace the Spirit of Free Software! JioTV Go is open-source and free to use. We're committed to keeping it accessible to everyone. If you come across any unauthorized attempts to sell this project, please report them to me so we can take swift action. Your support is essential in safeguarding our project's values. 🙌📜💼

spacex97 / jiotv_go Goto Github PK

jiotv_go's Introduction