Slicer CLI Arguments

Reference for the command-line arguments that control how the Slicer ingests and processes on-demand content. Pass these arguments when running the Slicer from the command line. To add content, see Add VOD Content.

Options

Option	Description	Example
`-addtrack`	Adds the audio from the specified file as an alternate audio track for the specified beam. Syntax: `-addtrack BeamID ext:ExternalID TrackDescription`	`-addtrack b123 ext:me3 Event3`
`-apikey`	Required. Requires Slicer version 17111500 or higher. Sets the secret API key through which the Slicer authenticates to the CMS. Bypass this requirement by setting the SLICER_USER and the SLICER_APIKEY environment variables. This API key should correspond to the user defined by the `-u` command line parameter. Syntax:`-apikey APIKey`	`-apikey abcDEFghiJKLmnoPQRtuvWXYz123ABCdefGHIJKL`
`-atrack`	Sets the source audio to the specified audio track. Syntax: `-atrack AudioTrack#`	`-atrack 3`
`-atmos_pass_through`	Replaces the Dolby 5.1 subtrack with the Dolby Digital Plus Atmos track from the asset being sliced.	`-dolby -atmos_pass_through`
`-audiodesc`	Defines a description for the audio track. Typically, this description indicates the track's language. Syntax: `-audiodesc Description`	`-audiodesc English`
`-autoexpire`	Sets the asset's retention period. The asset is automatically deleted after the specified time expires. Syntax: `-autoexpire Hours`	`-autoexpire 3`
`-break`	Inserts an ad break for each specified time range. Syntax: `-break StartTime-StopTime` (Single Ad Break) or `-break StartTime1-StopTime1,StartTime2-StopTime2,StartTimeN-StopTimeN` (Multiple Ad Breaks)	`-break 10.1-30.58,105-151.332`
`-bug`	Overlays an image on the video at the specified start time for the given duration. Syntax: `-bug PNGFile=StartTime,Duration`	`-bug logo3.png=5000,20000`
`cc#_desc`	Defines a description for the closed captioning channel defined by this setting's name. Syntax: `cc#_desc: Closed Captioning Channel Description`	`cc1_desc: English`
`cc#_lang`	Identifies the language associated with the closed captioning channel defined by this setting's name. Syntax: `cc#_lang: Closed Captioning Channel Language`	`cc1_lang: en`
`-cleardash`	Generates unencrypted DASH slices when slicing an asset.	`-cleardash`
`-d`	Assigns a name to the asset generated from the source media.	`-d "Marketing Event A"`
`-dolby`	Adds a Dolby 5.1 subtrack to the audio track.	`-dolby`
`-drm_mode`	Determines the level of security applied to a CMS asset generated by the Slicer. Syntax: `-drm_mode Mode`	`-drm_mode studio`
`-dvs`	Flags the current audio track as a DVS track.	`-dvs`
`-encwait`	Forces the Slicer to wait until encoding completes before allowing it to quit.	`-encwait`
`-extid`	Assigns an external ID to the asset generated from the source media.	`-extid "MarketingEvent123"`
`-fadein`	Fades audio and/or video in from the specified start time. Syntax: `-fadein MediaType=StartTime,Duration`	`-fadein audio=-5000,5000`
`-fadeout`	Fades audio and/or video out from the specified start time. Syntax: `-fadeout MediaType=StartTime,Duration`	`-fadeout audio=-5000,5000`
`-forceAR`	Forces the output to use the specified aspect ratio (in pixels). Syntax: `-forceAR Width:Height`	`-forceAR 640:480`
`-gain`	Overrides the calculated gain/attenuation with the specified value. Syntax: `-gain Decibel`	`-gain 2`
`-idpath`	Writes the asset's GUID to the specified path.	`-idpath /Users/joe/library/latest.txt`
`-lang`	Sets the audio track's language using the codes defined in RFC 5646. Syntax: `-lang LanguageCode`	`-lang en-US`
`-layout`	Sets the audio layout for downmixed audio channels.	`-layout dolby`
`-libraries`	Adds an asset to one or more shared libraries. Syntax: `-libraries LibraryName` or `-libraries LibraryGUID` or `-libraries Library1,Library2,LibraryN`	`-libraries Marketing`
`-meta`	Adds metadata to the asset. Syntax: `-meta Field=Value`	`-meta Description="Marketing Video"`
`-meta.file`	Adds the metadata fields defined in a JSON file to the asset. Syntax: `-meta.file JSONFile`	`-meta.file MarketingFields.json`
`-meta.int`	Adds metadata containing an integer value to the asset. Syntax: `-meta.int Field=Integer`	`-meta.int Rating=9`
`-mix`	Customizes how an audio subtrack is mixed. Syntax: `-mix 'Audio Codec=Channel LayoutChannel=Source Track:Source Channel@Level,...`	`-mix 'dolby=5.1 L=0:0,R=0:1,...'`
`-mixatracks`	Mixes multiple audio tracks together into a single track. Syntax: `-mixatracks Track=Channel,Track=Channel,...`	`-mixatracks 0=L,1=R`
`-nexttrack`	Closes the mix definition for the current audio track.	`-nexttrack`
`-nielsen`	Enables scanning for Nielsen audio watermarks. Syntax: `-nielsen 1`	`-nielsen 1`
`-nielsen_ad_mode`	Sets the Nielsen Breakout Code. Syntax: `-nielsen_ad_mode NielsenBreakoutCode`	`-nielsen_ad_mode 03`
`-output_ttml`	Outputs a fragmented TTML.	`-output_ttml`
`-p`	Deprecated. Please use the `apikey` option or the `SLICER_APIKEY` environment variable instead.	`-p 1@D208PneG63f`
`-poster`	Generates a poster image from the video frame corresponding to the specified time. Syntax: `-poster Time`	`-poster 5000`
`-poster_montage`	Generates a montage of stills from the video frames corresponding to the specified times. Syntax: `-poster_montage Time1,Time2,...`	`-poster_montage 5000,10000,...`
`-poster_frame`	Extracts an image from the video frame at the specified time, but does not create an asset. Syntax: `-poster_frame Time`	`-poster_frame 5000`
`-prev_assetid`	Registers the asset being created as the new version of the specified existing asset. Syntax: `-prev_assetid AssetGUID`	`-prev_assetid "{12345678-1234-1234-1234-123456789012}"`
`-prev_trackid`	Registers the audio track being created as the new version of the specified existing track. Syntax: `-prev_trackid AudioTrackGUID`	`-prev_trackid "{12345678-1234-1234-1234-123456789012}"`
`-proxy`	Uploads the file specified by the proxy path as the asset's proxy. Syntax: `-proxy ProxyPath`	`-proxy /path/to/proxy.mp4`
`-s3`	Registers the asset as an Amazon S3 upload.	`-s3`
`-skip`	Skips the video or audio encoding step, relying on the encoded data from the previous slicing operation.	`-skip`
`-split`	Divides the output asset into multiple files, each with the specified duration (in seconds). Syntax: `-split Duration`	`-split 600`
`-split_in`	Generates individual output files corresponding to the specified input file segments. Syntax: `-split_in Start1-End1,Start2-End2,...`	`-split_in 0:0-0:30,0:40-1:00`
`-srt`	Imports a .srt subtitle file into the generated asset. Syntax: `-srt SRTFile`	`-srt /path/to/file.srt`
`-stereodownmix`	Downmixes the input audio to stereo, regardless of the source's original channel layout.	`-stereodownmix`
`-thumb`	Generates a thumbnail image from the video frame corresponding to the specified time. Syntax: `-thumb Time`	`-thumb 5000`
`-trim_in`	Removes video and audio from the start of the media, up to the specified time. Syntax: `-trim_in StartTime`	`-trim_in 5000`
`-trim_out`	Removes video and audio from the end of the media, starting at the specified time. Syntax: `-trim_out StopTime`	`-trim_out 5000`
`-u`	Required. Specifies the username through which the Slicer authenticates to the CMS. Syntax:`-u Username`	`-u Exampleuser`
`-v`	Assigns the asset version. Syntax: `-v AssetVersion`	`-v 2.3`
`-volnorm`	Normalizes the volume level across all input channels.	`-volnorm`
`-wav`	Extracts the audio data from the specified asset and saves it as a .wav file. Syntax: `-wav Filename.wav`	`-wav output.wav`
`-x`	Deprecated. Please use the `extid` option instead.	`-x "MarketingEvent123"`