Confused on how to stream HTTP without HTSP access, through reverse proxy.

Backin69 · 2025-07-27T16:05:02+00:00

Hi All, So my original plan of using a reverse proxy to stream both a HD and a mobile stream have become a bit confusing. I'm going to leave HTSP alone for...

DeltaMikeCharlie

Maybe this could be helpful. It's on a different topic, but some parts could still be applicable.

https://docs.tvheadend.org/documentation/https-access-via-reverse-proxy

Backin69

ukn_unknown

Appreciate the suggestions. I actually already have a VPN on that machine, so could access it that way. However the proxy is more than just an access related requirement, it's fulfilling other needs as well.

DeltaMikeCharlie

I actually came across that last night, and that has actually resolved issues with downloading the XMLTV and M3U files!

However, I still ahven't found a player other than Sparkle that support HTTPS auth, so I'm still stuck!

Summary after all my fumbling about:
I actually have what I need to work, working. However to actually use it, I need to find an Android player that supports HTTPS and one of TVHeadends provided formats like the M3U file over HTTPS.

The only player that has worked so far is Sparkle and that's just not suitable for touch screen devices.

DeltaMikeCharlie

Backin69 Sparkle and that's just not suitable for touch screen devices.

Have you tried Kodi with 'touch mode' enabled on the Estuary skin?

The pvr.hts addon is used to connect to TVH. It has a connection HTTPS option.

Backin69

DeltaMikeCharlie

Unfortunatly from the GIT from pvr.hts:

"kodi-pvr/pvr.hts: Kodi's Tvheadend HTSP client addon"

Anything that has been designed for TVHeadend specifically is going to use the HTSP port, not the HTTP(S) port.

DeltaMikeCharlie

Backin69 Anything that has been designed for TVHeadend specifically is going to use the HTSP port, not the HTTP(S) port.

Backin69

DeltaMikeCharlie

Yup, so that's https for log in on the http port and will allow you to download the epg etc, it will still use HTSP for the video stream when you try to play it.

Backin69

I've actually managed to get the m3u downloading from a web browser without tripping auth and using:

https://USERNAME:PASSWORD@TVHeadend.URL:9981

However I don't know if that's the browser allowing that or if it's being passed back in plain text...

Backin69

Just to correct that since I can't seem to edit it. I meant to write:

https://USERNAME:PASSWORD@TVHeadend.URL:9981/playlist/channels.m3u

Now. I've gotten a bit further in that I can generate an m3u with this. The next issue is that it's missing the actual domain string and I can't seem to find where to change it... So in the M3u the channels are missing the domain like so:
https:///stream/channelid/32020664?profile=MobileStream

I know someone is going to point me towards this:


The public-facing host name, port number and path returned by TVH within documents such as an M3U can also be modified.  As TVH only recognises the X-Forwarded-Host:header when the Host:header is not present, it is recommended that only the Host:header be modified by the proxy in for following format:

Host: <External host>[:<External port>][/<External path>]```

However I don't really understand what it's saying.

Backin69

Well the formatting on that got fairly messed up.

The proxy server is *ALREADY telling TVHeadend that it needs to return a HTTPs link. What it needs is the host ONLY to be added. I was trying to do both.

Tony Wagner

On iOS/tvOS, you can use TvhClient. It can ignore HTSP and stream over HTTP. (There’s an Android app with the same name but it is unrelated and appears to require HTSP).

Tony Wagner

If you want to avoid having your username/password in the URL, you can generate a persistent auth token instead.

Then just add it as a parameter in your URL. This is how I stream a channel with it:
https://my.domain.name/tvheadend/stream/channelid/1234567890?profile=pass&auth=mypersistentauthtoken

Backin69

Tony Wagner

THat's actually a great bit of advice Tony thanks.

I'm nearly there with the proxy stuff. I'm just stuck on getting the header to TVH right so it sends back the correct URL on the M3U. I'll say I'll get it.

Backin69

I actually have the m3u file being generate now correctly by tv headend and the log in working.
HOWEVER. I didn't think that of course the stream link doesn't have the username and password.

Must see if TVheadend can add the persistent log in to the m3u.

Backin69

Oh I have it! You just add in auth before the chanels part of the playlist request!!! Nice.

DeltaMikeCharlie

Backin69 Oh I have it!

Wonderful news. When you have a moment, would you consider making a post that consolidates and summarises all of the proxy settings and URL tweaks in your solution? This could be helpful to future users.

Backin69

DeltaMikeCharlie

I detest people who don't don't write down what fixed a problem in forums, but in this case I'll probably do more harm than good as I was chopping and changing everything to make this work, so I'll just put down some bullet points on streaming over HTTP and ignoring HTSP over a HTTP reverse proxy.
Might be some use to some people.

Your reverse proxy needs to set the "x-forwarded-for:" thingy in the header to HTTPS if it supports it. Most do this by default.
You need to set your reverse proxy to send the "HOST" variable in the header. This is the link where you'll find the TV headend "base" URL. This gets passed back to TVHeadend so it can format the playlist M3U correctly.
When getting the M3U, most simple IPTV players do not support HTTP auth. We can bypass this by adding the username and password into the URL for grabbing the stream.
Putting in /auth/ as part of the api call for the M3U file will tell TVHeadend to put an auth token at the end of all your stream links, meaning your user:pass link will only be used initially (you can probably bypass this with an auth token, but these expire).
To request the full channel list, the URL is in this format:
USERNAME:PASSWORD@MyProxyURL.com/playlist/auth/channels.m3u
Similarly the EPG data in XML format is:
USERNAME:PASSWORD@MyProxyURL.com/xmltv/channels
Don't even bother trying to get a player working on a device until you have the above passing you back the correct M3U file for playing a stream. Verify it on a computer with VLC or something. You should be able to copy the link out of the M3U file and just play it directly.
When looking for a player, just ignore any that are specifically made for TVHeadend. These ALL use the HTSP port which will not work over a HTTP proxy. I've only had this all working an hour, so I can't say if I'll stick with it, but Dream player IPTV is working fine. (note: NOT Dream Player TVHeadend).

If I think of any other general pitfalls I fell through I'll post them here. I would write a full guide, but as I said, I fumbled through this so much I feel I'd get too much wrong.

Thanks for everyones help!