EnglishEnglish RussianРусский SpanishEspañol

F.A.Q.

1. My provider has a multiroom feature but gives different playlist URLs for each device.
Can I have one instance of HLS-Proxy to serve multiple devices?

A:

Yes.
If your provider is "cbilling" then HLS-Proxy supports it out of the box.
All you need is to put a playlist for the first device as a playlist source.
You should not add other URLs for other devices.
After starting of channel you should see "Pool" info at http://hls-proxy-ip/status page
If your provider is different - let me know and I will add needed settings for this
(Or you can look at default.json "pooler" setting but I'm not sure that everybody can configure it)
2. Does HLS-Proxy get command line arguments?

A:

Yes. Run "./hls-proxy -help" for detailed info.
3. HLS-Proxy has a newer release. How can I update?

A:

Usually HLS-Proxy updates itself at 4am. You can update it from /status page any time.
You can disable auto update from config.

Manual update:
Stop HLS-Proxy (Linux users which installed HLS-Proxy using "install.sh" script have to run "./install u" command)
Replace hls-proxy binary and default.json
Highly recommended to configure HLS-Proxy using web interface at http://hls-proxy-ip/config
HLS-Proxy saves a custom configuration to local.json file which stores your private settings.
4. I try to watch a channel but HLS-Proxy fails to start with an error "Request failed: Unable to verify first certificate."

A:

You are behind a firewall or traffic scanner which replaces SSL certificate to spy on you.
If you are aware of it then just change "isStrictSSLEnabled" to false in config page.
5. I have a multiroom feature from my IPTV provider.
Without HLS-Proxy I watch two different channels on two devices simultaneously.
Through HLS-Proxy If I start a second channel - first one stops.
What I did wrong?

A:

Probaly, you downloaded a static playist as a file and used it on your devices.
Instead, put a direct link to HLS-Proxy and it will be ok.
6. Does HLS-Proxy support m3u_plus playlist format?

A:

Sure.
7. I configured HLS-Proxy but still have a buffering.

A:

It seems that you configured non-HLS playlist.
To make sure that HLS-Proxy caches your stream:
a) Start any stream on the player
b) Open http://hls-proxy-ip/status page
c) Look if HLS-Proxy shows any working stream there.
If you don't see any then ask your provider for HLS playlist.
Usually, if playlist url contains "output=m3u8" or "output=ts" then just replace it with "output=hls"
8. I have few playlists. What will happen if I put them all to the config?

A:

HLS-Proxy will combine them and as a result you will get one merged playlist.
9. Raspberry: How to REDUCE read/write operations on Raspberry Pi?

A:

Disable syslog:
sudo service rsyslog stop
sudo systemctl disable rsyslog

To revert and enable syslog back:
sudo systemctl enable rsyslog
sudo service rsyslog start
10. I have a playlist of provider which allows me to watch streams on two devices at the same time.
Can I watch three or more streams at the same time using HLS-Proxy?

A:

No. It is your provider limitation and HLS-proxy can't avoid it.
Anyone trying this will be banned.
11. I get 403 (Forbidded). How can I give an access to a public network (WAN)?

A:

By default, HLS-Proxy allows connections from local network only.
I did that to protect most of users that do not interested to have a deal with security issues and illegal access from outside intruders.
Put your external address or domain name or 0.0.0.0 to SERVER.address field in config and configure a port mapping on your router or modem.
After that HLS-Proxy can be accessed by this address.
Another way is to set admin password.
Uninstall HLS-Proxy first: ./install.sh u
Configure: ./hls-proxy -address 0.0.0.0 -port 8080 -pass abcd -save -quit
Install proxy again: ./install.sh
12. Does the software work under OpenWrt?

A:

Yes.
13. Is the software open source?

A:

No.
14. Does HLS-Proxy detect timeshift from a playlist?

A:

Yes. Set "isDetectEPGTimeShiftFromChannelName" value as true
15. How can I add a single stream or few using web user interface?

A:

If you have a configured "editable" playlist then simply copy to clipboard desired section or copy a stream URL to clipboard
After it go to root page of web interface and press Ctrl-V keyboard combination.
16. How do I manage favorite channels list?

A:

You can mark channels as favorite from the root page pressing on the red heart sign on the third column.
Filled heart means that a channel is in favorite list. Outline (or empty) heart is not.
You can manage an order of favorite channels from /config page.
17. Is the app freeware?

A:

Yes.
18. How do I run several instances at the same machine (Linux)?

A:

                1. Unpack hls-proxy.zip to different folder
                2. Run chmod +x install.sh
                3. Rename install.sh to install2.sh running: mv install.sh install2.sh
                4. Configure a different port using
                ./hls-proxy -port <port> -save -quit
                5. Run install2.sh
                6. To uninstall run ./install2.sh u

                For third instance repeat all the steps before. Just use install3.sh instead

                The install script will take an instance number from its file name. So it is important to rename install.sh to install<instance>.sh format
19. How do I configure a stub video for expired users?

A:

                - Create a folder "errors"
                - Put there "expired.m3u" file with a content:

                #EXTM3U
                #EXT-X-VERSION:3
                #EXT-X-TARGETDURATION:10
                #EXT-X-MEDIA-SEQUENCE:1
                #EXTINF:4.0,
                /errors/expired_01.ts
                #EXTINF:4.0,
                /errors/expired_02.ts
                #EXTINF:4.0,
                /errors/expired_03.ts
                #EXTINF:4.0,
                /errors/expired_04.ts
                #EXT-X-ENDLIST

                Put video segments along with m3u file.
                Segment names have to be exactly as you put in m3u file.
                Note: VLC needs 4 segments at least

                Also, you can configure stubs for next cases:
                forbidden.m3u - Invalid token or missing
                invalid.m3u - A content of a stream is not supported
                notfound.m3u - No channel with such stream id.
21. I would like to support this project. Can I donate?

A:

Yes, sure. You're so kind.
- Donate via PayPal.