VAVOO PROXY PLUGIN
## Quick Start Guide
-it works with Cloudflare DNS
-it work with or without serviceapp
-it work..... (maybe LOL)
### First-Time Setup
1. **Open the Vavoo Plugin** – The proxy will start automatically
2. **Select a Country** – Choose your desired country (e.g., "Italy")
3. **Press GREEN Button** – Export favorites to Enigma2 bouquets
4. **Return to TV** – Your channels will appear in the channel list!
### Automatic Updates (Recommended)
- Go to **Menu Config** → Enable **"Scheduled Bouquet Update: ON"**
- Choose update interval (5 minutes)
- The proxy will handle everything automatically
### Manual Use
- If auto-update is OFF, simply open the plugin when you want to update
- The proxy starts automatically when plugin opens
- Select country and press GREEN to export
or use plugin for show channel with player (is better)
#################
very simple .. but a lot of work..................
Let me explain better
- I ran my tests with
- serviceapp DEFAULT and EXTEPLAYER: ALL OK.
- Cloudfire DNS 1.1.1.1 - 1.0.0.1 (DNS *GOOGLE NOT WORKING FOR ME)
- in the latest 1.46 update I added
- other CODES to the proxy to keep it alive and forcefully reactivate it if it expires. (But we can only do this when it expires.)
- IF THE PROXY IS NOT READY, YOU CAN'T ENTER THE PLUGIN'S CHANNELS (obviously, you'd then have to turn off the box using the button; it's too slow and the wait would be long (No date items).)
- If the proxy isn't ready and everything is configured correctly, you can restart the box or enigma2.
- The plugin is designed to always have the proxy active (it consumes a bit), but at least you can view the channel list of the exported bouquet or bouquets.
- For this reason, I recommend exporting the bouquets every 5-10 minutes to update the list token. But the proxy also has an autonomous token update system, constantly updating the token automatically.
There are detections even for 30 seconds.
It wasn't easy, and I said so.
But if in the end you don't see anything, your provider is blocking Vavoo and there's nothing you can do ( KiddaC told me his provider is blocking Vavoo. And he had no video, everything (black)
The rest for you users is simple, just a few things to know. In the quick guide I've included,
Post
RE: Vavoo Stream Live - discussion & support
I'll open the source for you.... commings soon I will let you know in this topic..
I hope you all make amends for what you've read these past few days.
A developer, any developer, needs stimulation, while a user, even if it means kissing your ass, only wants results, and if there's no result, he takes it out on the developer (the plugin).
From now on, coffee costs nothing. To anyone...
Thousands of downloads, I don't want a coffee each, maybe not even everyone can do it (I don't think so...),
but…
If you read the Readme carefully, you can also connect from a browser;
there are many commands to view the status, channels, proxies, etc. etc.
Don't mess it up, though; as I said, everyone is responsible for their own knowledge.
That said, I'm retiring. I'm going to dinner and rest; it's been a terrible day.
Here are some of the browser commands:
127.0.0.1, you need to replace it with your box's IP address.
IP_BOX:4323/command
BROWSER COMMANDS / API ENDPOINTS
"""
VAVOO PROXY ENDPOINTS (PROXY_HOST:{PORT})
"""
====================================================================
VAVOO PROXY API HELP
====================================================================
Proxy Base URL:
http://127.0.0.1:4323
All endpoints are accessible locally from:
- Enigma2
- wget
- curl
- VLC
- ffplay
- IPTV players
====================================================================
1. /status - Proxy Status
====================================================================
URL:
http://127.0.0.1:4323/status
Description:
Returns current proxy runtime status.
Includes:
- proxy initialization state
- loaded channels count
- addonSig validity
- addonSig age
- local IP address
- listening port
Example:
wget -qO- http://127.0.0.1:4323/status
Example Response:
{
"initialized": true,
"channels_count": 1250,
"addon_sig_valid": true,
"addon_sig_age": 42,
"local_ip": "192.168.1.10",
"port": 4323
}
====================================================================
2. /health - Health Check
====================================================================
URL:
http://127.0.0.1:4323/health
Description:
Returns detailed health and monitoring information.
Includes:
- overall health status
- token validity
- token TTL
- uptime
- heartbeat age
- local IP
- listening port
Important:
This endpoint is READ-ONLY.
It does NOT restart or refresh the proxy.
Example:
wget -qO- http://127.0.0.1:4323/health
====================================================================
3. /countries - Available Countries
====================================================================
URL:
http://127.0.0.1:4323/countries
Description:
Returns all unique countries available in the catalog.
Excluded:
- empty country names
- "default"
Example:
wget -qO- http://127.0.0.1:4323/countries
Example Response:
[
"France",
"Germany",
"Italy",
"Spain"
]
====================================================================
4. /channels?country=CountryName - Channels By Country
====================================================================
URL:
http://127.0.0.1:4323/channels?country=Italy
Description:
Returns all channels matching the specified country.
Each channel contains:
- id
- name
- logo
- country
- local playback URL
Notes:
- country matching is case-insensitive
- country names should be URL encoded
Example:
wget -qO- "http://127.0.0.1:4323/channels?country=Italy"
Example Response:
[
{
"id": "abc123",
"name": "RAI 1",
"url": "http://192.168.1.10:4323/vavoo?channel=abc123",
"logo": "https://logo.png",
"country": "Italy"
}
]
====================================================================
5. /catalog - Full Catalog
====================================================================
URL:
http://127.0.0.1:4323/catalog
Description:
Returns the complete filtered catalog currently loaded
in memory.
Contains:
- all channels
- metadata
- original stream information
Example:
wget -qO- http://127.0.0.1:4323/catalog
====================================================================
6. /vavoo?channel=ChannelID - Stream Redirect
====================================================================
URL:
http://127.0.0.1:4323/vavoo?channel=abc123
Description:
Resolves the upstream stream URL and immediately returns
a HTTP 302 redirect.
Optimized for:
- Enigma2 IPTV bouquets
- VLC
- ffplay
- gstplayer
- exteplayer3
- serviceapp
Behavior:
Client receives direct upstream stream URL.
Example:
wget -S -O /dev/null "http://127.0.0.1:4323/vavoo?channel=abc123"
Expected Response:
HTTP/1.1 302 Found
====================================================================
7. /stream?ref=ServiceReference - Direct Stream Proxy
====================================================================
URL:
http://127.0.0.1:4323/stream?ref=1%3A0%3A1%3A...
Description:
Streams MPEG-TS content directly through the proxy
instead of redirecting the client.
Features:
- upstream buffering
- keep-alive
- timeout monitoring
- chunked streaming
- disabled caching
Workflow:
1. Decode service reference
2. Map reference to channel ID
3. Resolve upstream stream
4. Proxy TS stream to client
Recommended for:
- Enigma2 service references
- local TS proxying
- IPTV middleware
- transcoding pipelines
Example:
ffplay "http://127.0.0.1:4323/stream?ref=1%3A0%3A1%3A..."
====================================================================
8. /refresh_token - Refresh addonSig
====================================================================
URL:
http://127.0.0.1:4323/refresh_token
Description:
Forces addonSig token refresh.
Returns:
- success
- error
Example:
wget -qO- http://127.0.0.1:4323/refresh_token
Example Response:
{
"status": "success",
"message": "Token refreshed"
}
====================================================================
9. /epg/<country>.xml - EPG Redirect
====================================================================
URL:
http://127.0.0.1:4323/epg/it.xml
Description:
Redirects to XMLTV EPG file hosted on GitHub.
Examples:
/epg/it.xml
/epg/fr.xml
/epg/de.xml
Response:
HTTP 302 Redirect
Example:
wget -O epg.xml "http://127.0.0.1:4323/epg/it.xml"
====================================================================
10. /shutdown - Graceful Shutdown
====================================================================
URL:
http://127.0.0.1:4323/shutdown
Description:
Gracefully shuts down the proxy server.
Behavior:
- stops HTTP server
- closes sockets
- stops proxy threads
- sets global stop event
Example:
wget -qO- http://127.0.0.1:4323/shutdown
====================================================================
USEFUL ENIGMA2 TEST COMMANDS
====================================================================
Check proxy status:
wget -qO- http://127.0.0.1:4323/status
Check health:
wget -qO- http://127.0.0.1:4323/health
List countries:
wget -qO- http://127.0.0.1:4323/countries
Get Italy channels:
wget -qO- "http://127.0.0.1:4323/channels?country=Italy"
Check redirect:
wget -S -O /dev/null "http://127.0.0.1:4323/vavoo?channel=abc123"
Check listening port:
netstat -lntp | grep 4323
or:
ss -lntp | grep 4323
====================================================================
"""
Display More
"""
eg:
192.168.1.78:4323/status
pasted-from-clipboard.png
192.168.1.78:4323/catalog
pasted-from-clipboard.png
192.168.1.78:4323/countries
pasted-from-clipboard.png
192.168.1.78:4323/channels?country=Italy
pasted-from-clipboard.png
192.168.1.78:4323/refresh_token
{
"status": "success",
"message": "Token refreshed"
}
192.168.1.78:4323/health
{
"status": "healthy",
"initialized": true,
"channels_count": 8703,
"token":
{
"valid": true,
"age": 144,
"ttl": 456,
"needs_refresh": false,
"expires_in": "456s"
},
"system":
{
"uptime": 163,
"heartbeat": 11,
"port": 4323,
"local_ip": "192.168.1.78"
},
"timestamp": 1769800102.87517,
"message": "Proxy is running normally"
}
Display More
192.168.1.78:4323/shutdown
it's better to restart the box every now and then... that would be much better.
'text': self.refresh_proxy,
If shutdown RESTART BOX for now..
