Command Line Interface

Click to Display Table of Contents

Navigation:  Operation > Generating a playlist >

Command Line Interface

Playlist Generator Pro command line parameters

 

You can use the command line interface to automatically generate playlists and save them to a specified location.

 

Usage: PlaylistGeneratorPro.exe -preset=PRESET -out=PLAYLIST [-n=N]

 

Options:

-preset= specifies the preset name (multiple presets can be specified separated by "|")

-out= specifies the file name for saving the generated playlist (use a full path with the extension .m3u8)  (multiple file names, matching the preset number, can be specified separated by "|")

-n= how many playlists need to be generated (default = 1). If used, the -out option need to contain one of the modifiers: %n, %nn or %nnn (see below for more information)

-s= when using "-n", the -s option sets the starting number for playlist naming. Example: -s=5

 

Example: generate a playlist using the MyPreset preset and save it to C:\playlist.m3u8

PlaylistGeneratorPro.exe -preset=MyPreset -out=C:\playlist.m3u8

 

Warning: If the name of a present contains a space, parameters must be encased in quote marks:

PlaylistGeneratorPro.exe "-preset=My Preset" "-out=C:\Folder name\playlist.m3u8"

 

You can use the run command in the scheduler together with the command line interface to generate playlists and save them to a specific folder (for example, on a production machine). Unlike automatic playlist generation, doing that will only save a playlist but will not play it.

 

Example of such a scheduler event (note: there's no need to specify a full path to PlaylistGeneratorPro.exe program):

run PlaylistGeneratorPro.exe -preset=MyPreset -out=C:\playlist.m3u8

 

Generating multiple playlists in one run (-n option)

 

Note: when playlists are generated in batch, they share the same no-repeat buffer, which means it's possible to create several playlists for extended periods of time with no repeated tracks.

 

Example:

PlaylistGeneratorPro.exe -preset=MyPreset -out=C:\playlist_%nn.m3u8 -n=11

 

Warning: If a command is executed in a .bat file, the percent sign must be written twice:

PlaylistGeneratorPro.exe -preset=MyPreset -out=C:\playlist_%%nn.m3u8 -n=11

 

This command will generate 11 playlists and save them under the names:

C:\playlist_00.m3u8

C:\playlist_01.m3u8

C:\playlist_02.m3u8

...

C:\playlist_10.m3u8

 

File name modifiers:

%n - a number with no leading zeros (1, 2, ... 10, ... 100).

%nn - a number padded with one leading zero (01, 02, ..., 10, 100).

%nnn - a number padded with two leading zeroes (001, 002, ..., 010, 100)

 

Generating multiple playlists using multiple presets in one run

 

The following example creates 3 playlists using the Morning, Day and Evening presets and saving them to D:\Playlists\Morning.m3u8, D:\Playlists\Day.m3u8, and D:\Playlists\Evening.m3u8 respectively. This allows to prepare playlists in advance and then start them when needed.

 

Note: when playlists are generated in batch, they share the same no-repeat buffer, which means it's possible to create several playlists for extended periods of time with no repeated tracks.

 

Example:

PlaylistGeneratorPro.exe "-preset=Morning|Day|Evening" "-out=D:\Playlists\Morning.m3u8|Day.m3u8|Evening.m3u8"

 

You can specify the full path for the first playlist only; in this case, all playlists will be saved to the same folder. You can specify the full path for all playlists.