DASHCAST(1)

NAME
DashCast - MPEG-4 Systems Framework and Software Development Kit

SYNOPSIS
DashCast [options]

OPTIONS

  General options

-log-file filename
    set output log file. Also works with -lf

-logs LOGS
    set log tools and levels, formatted as a ':'-separated list of toolX[:toolZ]@levelX

-conf filename
    set the configuration file name (default: dashcast.conf)

-switch-source filename
    set the configuration file name for source switching

  Live options

-live
    system is live and input is a camera

-live-media
    system is live and input is a media file

-no-loop
    system does not loop on the input media file when live

-dynamic-ast
    changes segment availability start time at each MPD generation (old behaviour but not allowed in most profiles)

-insert-utc
    inserts UTC clock at the start of each segment

  Source options

-npts
    use frame counting for timestamps (not error-free) instead of source timing (default)

-av string
    set the source name for a multiplexed audio and video input. If this option is present, neither '-a' nor '-v' shall be present.

-v string
    set the source name for a video input. If input is from a webcam, use "/dev/video[x]" where x is the video device number. If input is the screen video, use ":0.0+[x],[y]" which captures from upper-left at x,y. If input is from stdin, use "pipe:".

-vf string
    set the input video format. To capture from a webcam, set video4linux2. To capture the screen, set x11grab.

-v4l2f inv4l2f
    inv4l2f is the input format for webcam acquisition. It can be mjpeg, yuyv422, etc.

-pixf FMT
    set the input pixel format

-vfr N
    force the input video framerate

-vres WxH
    force the video resolution (e.g. 640x480)

-vcrop XxY
    crop the source video from X pixels left and Y pixels top. Must be used with -vres.

-a string
    set the source name for an audio input. If input is from microphone, use "plughw:[x],[y]" where x is the card number and y is the device number

-af string
    set the input audio format

  Output options

-vcodec string
    set the output video codec (default: h264)

-vcustom string
    send custom parameters directly to the video encoder

-gdr
    use Gradual Decoder Refresh feature for video encoding (h264 codec only)

-gop
    specify GOP size in frames - default is framerate (1 sec gop)

-low-delay
    specify that low delay settings should be used (no B-frames, fast encoding)

-acodec string
    set the output audio codec (default: aac)

-acustom string
    send custom parameters directly to the audio encoder

  DASH options

-seg-dur dur:int
    set the segment duration in millisecond (default value: 1000)

-frag dur:int
    set the fragment duration in millisecond (default value: 1000) (same as -frag-dur)

-seg-marker marker:4cc
    add a marker box named marker at the end of DASH segment

-out outdir:str
    outdir is the output data directory (default: output)

-mpd mpdname:str
    mpdname is the MPD file name (default: dashcast.mpd)

-ast-offset dur:int
    dur is the MPD availabilityStartTime shift in milliseconds (default value: 0)

-mpd-refresh dur:int
    dur is the MPD minimumUpdatePeriod in seconds

-time-shift dur:int
    dur is the MPD TimeShiftBufferDepth in seconds. The default value is 10. Specify -1 to keep all files.

-min-buffer dur:float
    dur is the MPD minBufferTime in seconds (default value: 1.0)

-base-url baseurl:str
    baseurl is the MPD BaseURL

EXAMPLES
DashCast -av test.avi -live-media

DashCast -a test_audio.mp3 -v test_audio.mp4 -live-media

DashCast -vf video4linux2 -vres 1280x720 -vfr 24 -v4l2f mjpeg -v /dev/video0 -af alsa -a plughw:1,0 -live

DashCast -vf x11grab -vres 800x600 -vfr 25 -v :0.0 -live

BUGS and OTHER HELP
For bug reports, more information on BT or XMT-A formats or GPAC TTXT files or ISMACryp, MPEG-4 Systems usage and more help on DashCast please visit the GPAC web site http://www.gpac.io

AUTHORS
Arash Shafiei. Copyright © Telecom ParisTech 2000-2013.

SEE ALSO
GPAC(1), MP4Box(1), MP4Client(1)