NAME

harvid - video server

SYNOPSIS

harvid [OPTION] [document-root]

DESCRIPTION

harvid - http ardour video server

OPTIONS

-A <cmdlist>, --admin <cmdlist>: space separated list of allowed admin commands. An exclamation-mark before a command disables it. default: 'flush_cache'; available: flush_cache, purge_cache, shutdown
-c <path>, --chroot <path>: change system root - jails server to this path
-C <frames>: set initial frame-cache size (default: 128)
-D, --daemonize: fork into background and detach from TTY
-g <name>, --groupname <name>: assume this user-group
-h, --help: display this help and exit
-F <feat>, --features <feat>: space separated list of optional features. An exclamation-mark before a features disables it. default: 'index'; available: index, seek, flatindex, keepraw
-l <path>, --logfile <path>: specify file for log messages
-M, --memlock: attempt to lock memory (prevent cache paging)
-p <num>, --port <num>: TCP port to listen on (default 1554)
-P <listenaddr>: IP address to listen on (default 0.0.0.0)
-q, --quiet, --silent: inhibit usual output (may be used thrice)
-s, --syslog: send messages to syslog
-t <thread-limit>: set maximum decoder-threads (default: 8)
-T <sec>, --timeout <secs>: set a timeout after which the server will terminate if no new request arrives
-u <name>, --username <name>: server will act as this user
-v, --verbose: print more information (may be used twice)
-V, --version: print version information and exit

The default document-root (if unspecified) is the system root: / or C:\.

If both syslog and logfile are given that last specified option will be used.

--verbose and --quiet are additive. The default is to print warnings and above only. Available log-levels are 'mute', 'critical, 'error', 'warning' and 'info'.

The --features option allows one to enable or disable /seek and /index http-handlers and change their respone: The 'flatindex' option concerns /index&flatindex=1 which recursively indexes all video file. It is disabled by defaults since a recursive search of the default docroot / can takes a very long time. When requesting png or jpeg images harvid decodes a raw RGB frame and then encodes it again. If 'keepraw' feature is enabled, both the raw RGB and encoded image are kept in cache. The default is to invaldate the RGB frame after encoding the image.

EXAMPLES

harvid -A '!flush_cache purge_cache shutdown' -C 256 /tmp/

sudo harvid -c /tmp/ -u nobody -g nogroup /

REPORTING BUGS

Report bugs to <robin@gareus.org> or https://github.com/x42/harvid/issues
Website http://x42.github.com/harvid/

Compiled with Lavf58.45.100 Lavc58.91.100 Lavu56.51.100

COPYRIGHT

December 2022

harvid v0.9.1