This will generate an m3u8 playlist and xmltv file for pluto TV.
Only node 16 and above is supported. This script may run with other versions, but it may not.
configuration is read from config.json in the current working directory
edit the config.json file to provide an output directory for the m3u8 and xml file
edit the config.json file and provide a new (unique) UUID
edit the config.json file and provide a region key and a geo located IP address to automatically generate an m3u8 and xml file for that region
Note: before running npm install
you need to cd
to the pluto_tv_scraper
directory (the directory with this README.md
file in it.
npm install
npm install -g plutotv-scraper
Note: before running npm install -g .
you need to cd
to the pluto_tv_scraper
directory (the directory with this README.md
file in it.
This can be installed globally using the following command:
npm install -g .
Installing will create a command called plutotv-scraper
that can be executed on the command line.
Note: take notice of the final .
(indicating to npm to globall install the current package, and not globally install the dependencies)
Note: before running node ./index.js
you need to cd
to the pluto_tv_scraper
directory (the directory with this README.md
file in it.
node ./index.js
OR running globally
Note: if installed globally, there's no need to cd
to the pluto_tv_scraper
directory. As long as your system (npm) is set up correctly, the plutotv-scraper
command will be found within the PATH
plutotv-scraper --help
Options:
--config <configfile> : Provide the location to the configuration file
--mapping <region,IP> : Provide a region and IP address to process instead of the mapping
--outdir <outdir> : Provide the destination directory
--clientid <clientid> : Provide a client id
--all : Merge all regions into a single playlist and epg
--chno <num> : Start channel numbering at the provided value, spans all regions
--group [genre|country] : Specify the grouping within the playlist (default is "genre")
--regionalize : Append the country code to the channel id
--exclude-groups <regex> : Exclude the groups that match the regular expression
--exclude-channels <regex> : Exclude the channels that match the regular expression
--port <num> : Start a small web server to serve the generated files
--refresh <seconds> : Automatically refetch the files at the provided interval
--unique-clientid : Generate a unique id for each client requesting the playlist via
the inbuilt server
--random-clientid : Generate a random id for each request of the playlist via the
inbuilt server
--x-tvg-url <url> : Specify a custom x-tvg-url value in the EXTM3U header
--help : Display this help
Note:
--x-tvg-url
ends with a /
, the corresponding xml filename will be appended.There is now a feature where the generate files can be served up using a built in web server. The web server mode is invoked by providing the --port <num>
commandline option. Note that in this mode, the files are not generated.
This mode will continue to read the config.json from the current working directory, unless the --config
option is provided.
If the command to generate the files utilises the --config
option, it is wise to also include it when launching in server mode. eg:
If the scripts are generated with:
node ./index.js --config /some/config.json
The server mode should be invoked with:
node ./index.js --config /some/config.json --port 8080
The server mode can do two other things:
--unique-clientid
option to generate a new clientID (based on the callers IP address) to ensure multiple clients have different client IDs.--refresh <seconds>
option, which will refecth the playlists and xml files the files at (at least) one hour intervalsThe --exclude-groups
option utilizes regular expression matching to determine what groups should be excluded. Some examples of regular expressions:
Note: do take note of the single quotes, they're required to ensure the shell does not do any expansion of wildcards
--exclude-groups "^Local News$"
This regular expression will remove all the channels that are in the group 'Local News'.
--exclude-groups "Español"
This regular expression will remove all the channels that are in groups with 'Español' in the name.
--exclude-groups "^(Local News|En Español)$"
This regular expression will remove all the channels that are in the groups 'Local News' or 'En Español'.
--exclude-groups "(News|Español)"
This regular expression will remove all the channels that are in groups with 'News' or 'Español' in the name.
Mozilla developer documents provide good documentation on regular expressions in javascript. The document can be found here: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_expressions
npm install
node ./index.js
node ./index.js --help
It appears that command.exe does not utilise single quotes as "a single argument". As such, regular expressions must be enclosed in double quotes ("). This is especially true if the regular expresion conains the PIPE (|).