# Adding Websites to TMDB to VOD Using HeadlessVidX

## Introduction

Located in `/HeadlessVidX_sitelists`, there are two files containing a list of url's:

- `movies.txt`
- `series.txt`

As indicated by their names, these files are for movies and TV shows, respectively. You can add a site by including it in these two files.

## Types of Sites to Add

You can add movie and TV show websites that are structured around TMDB and IMDB IDs. For example:

https://www.essential.wtf/media/tmdb-movie-105

Note the `105` at the end. This is a TMDB ID that can be replaced with the `[[TMDB]]` variable. In order to add a site like this, you would first open the HeadlessVidX folder and follow the Install Instructions.txt. Once the HeadlessVidX server has been installed and is up and running, you can load the 'Website Trainer' in your browser. However, it would be best to visit the 'Traing Guide' first to gain a better understanding on how it works.

After you have trained HeadlessVidX for extracting the videos streams of a website, you would next need to add the url patterns to both movies.txt and series.txt, so that TMDB to VOD can begin sending and requesting links.

On this url, For Movies use:

`https://www.essential.wtf/media/tmdb-movie-[[TMDB]]`

On this url, For TV Series use:

`https://www.essential.wtf/media/tmdb-tv-[[TMDB]]/[[SID]]/[[EID]]`

Now of course the url structuring will be different from site to site. You will need to first, visit the website and examine how they pass the TMDB or IMDB, along with the way the season and episodes codes are used when dynamically loading the page.

For a list of multi-server and single-server websites to check, you can use the following resource:

https://fmhy.net/video

Not all the websites listed on this site will work, since a lot of website owners use anti-bot methods to prevent scraping. However, you can try different variations with HeadlessVidX to try and side step those measures.

## Using Variables

You can use the following variables in the command files. These variables will be replaced with the appropriate values when the site is processed:

`[[DASH-TITLE]] - Strips the non alphanumerical characters of the title and replaces the spaces with dashes (e.g., back-to-the-future).` `[[YEAR]] - Replaced with the release year of a movie or series (e.g., 1985).` `[[TMDB]] - Replaced with The Movie Database ID (e.g., 105 for movies and series).` `[[IMDB]] - Replaced with the IMDB ID (e.g., tt0088763).` `[[SID]] - Replaced with the Season ID (the unique season ID returned by TMDB).` `[[EID]] - Replaced with the Episode ID (the unique episode ID returned by TMDB).` `[[S]] - Replaced with the season number.` `[[E]] - Replaced with the episode number.`

## A Few More Examples

Below are some examples of how the urls should look when adding them to /HeadlessVidX_sitelists

A movies.txt Pattern: `http://example.com/movie/[[TMDB]]` That Would Become: `http://example.com/movie/105`
A movies.txt Pattern: `http://example.com/watch-movie/[[DASH-TITLE]]-[[YEAR]]` That Would Become: `http://example.com/watch-movie/back-to-the-future-1985`
A series.txt Pattern:`http://example.com/show/[[IMDB]]/season/[[S]]/episode/[[E]]` That Would Become: `http://example.com/show/4658/season/2/episode/1`
A series.txt Pattern: `http://example.com/series/[[TMDB]]]/[[SID]]/[[EID]]` That Would Become: `http://example.com/series/4658/14229/338886`