HeadlessVidX
How To Use - Website Trainer - Training Guide - GitHub
×

### How To Use HeadlessVidX

HeadlessVidX aims to simplify the task of developing video extractors for streaming websites. It provides an easy-to-use solution for users, regardless of their programming skills, to quickly add video streaming sites to tools such as TMDB TO VOD.

If you want the direct streaming URL to play from within a video player or an `.m3u8` playlist, simply attach the target link to the end of the /play?url= endpoint. The video will be extracted, redirected, and the proxied stream will begin playing.

DaddyLive Example:

The DaddyLive URL of an embedded live stream video is something like https://dlhd.dad/watch.php?id=304. You would then URL-encode that address and append it to the end of /play?url=, so the full URL would look like:

`https%3A%2F%2Fdlhd.dad%2Fwatch.php%3Fid%3D304`

When this URL is requested, HeadlessVidX opens a browser, bypasses JavaScript encryption, captures the actual video URL, and proxies the stream with the required headers. This enables playback in any M3U8 playlist or video player.

Return JSON Data:

Sending a GET request to the /get-video?url= endpoint will return JSON containing the streaming URL along with any required header information for accessing the video stream. This is useful when you are coding or running your own script that proxies video streams.

Just send a GET request to the URL below:

`https%3A%2F%2Fdlhd.dad%2Fstream%2Fstream-303.php`

...and the data returned would look something like:

`{"status":"ok","url":"https://nfsnew.newkso.ru/nfs/premium304/mono.m3u8","Referer":"https://jxoxkplay.xyz/","Origin":"https://jxoxkplay.xyz","User-Agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1","Content-Type":"application/vnd.apple.mpegurl","streamUrl":"http://127.0.0.1:3202/play?url=https%3A%2F%2Fdlhd.dad%2Fwatch.php%3Fid%3D304","proxy":"http://127.0.0.1:3202/proxy?url=https%3A%2F%2Fnfsnew.newkso.ru%2Fnfs%2Fpremium304%2Fmono.m3u8&data=aHR0cHM6Ly9uZnNuZXcubmV3a3NvLnJ1L25mcy9wcmVtaXVtMzA0L21vbm8ubTN1OHxVc2VyLUFnZW50PSJNb3ppbGxhLzUuMCAoaVBob25lOyBDUFUgaVBob25lIE9TIDE4XzUgbGlrZSBNYWMgT1MgWCkgQXBwbGVXZWJLaXQvNjA1LjEuMTUgKEtIVE1MLCBsaWtlIEdlY2tvKSBWZXJzaW9uLzE4LjUgTW9iaWxlLzE1RTE0OCBTYWZhcmkvNjA0LjEifFJlZmVyZXI9Imh0dHBzOi8vanhveGtwbGF5Lnh5ei8ifE9yaWdpbj0iaHR0cHM6Ly9qeG94a3BsYXkueHl6Ig%3D%3D"}`

This JSON will contain the link to the video file and some of the headers that were used when HeadlessVidX accessed it.

### Why does the JSON return an error?

Some websites, especially video streaming websites, go to extreme measures to protect people from accessing their streams. However, you can still try to get around these measures by clicking on the Website Trainer and creating a site definition for HeadlessVidX to use when accessing a video URL on that site.

### What are the pros?

HeadlessVidX, as a headless browser, can execute the necessary JavaScript to access video streams. This capability is particularly important when website owners employ advanced encryption methods to safeguard their streams.

It also eliminates the need to spend hours developing custom functions and extractors for each website. Its versatility allows it to handle a wide variety of video websites right out of the box.

### What are the cons?

Even though it’s headless, it is still browser-based, so the response time can be slower than direct web requests, as it requires rendering and executing JavaScript.

Headless browsers also consume more system resources, such as CPU and memory, compared to traditional web requests.