HARVID(1)

💖 harvid(1) 💖

okay bestie, gather round, because we're doing harvid(1) — a User Command and honestly? she's iconic. this is the page for the http ardour video server and it is giving main character energy. let's get into it ✨

---

🌸 NAME 🌸

harvid — video server 🎀

---

🦋 SYNOPSIS 🦋

harvid [OPTION] [document-root]

---

✨ DESCRIPTION ✨

harvid — http ardour video server. that's the whole vibe. a little http server whose entire job is serving up video for ardour. no cap 💅

---

👑 OPTIONS 👑

• -A <cmdlist>, --admin <cmdlist> — a space separated list of the admin commands you're allowing. put an exclamation-mark before a command and you've disabled it. default: 'flush_cache'; the available ones are: flush_cache, purge_cache, shutdown. so like, choose your fighters wisely 🫶
• -c <path>, --chroot <path> — changes the system root, i.e. it jails the server to this path. she stays in her lane, literally 🔒
• -C <frames> — sets the initial frame-cache size (default: 128)
• -D, --daemonize — forks into the background and detaches from the TTY. bye bestie, she's going ghost 👻
• -g <name>, --groupname <name> — assume this user-group
• -h, --help — display this help and exit. classic 🎀
• -F <feat>, --features <feat> — space separated list of optional features. exclamation-mark before a feature disables it. default: 'index'; available: index, seek, flatindex, keepraw
• -l <path>, --logfile <path> — specify the file for log messages 📝
• -M, --memlock — attempt to lock memory (prevent cache paging). hold onto it and don't let go 💜
• -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). shhh 🤫
• -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. she's on a timer fr ⏰
• -u <name>, --username <name> — server will act as this user
• -v, --verbose — print more information (may be used twice). she's yapping, respectfully 💬
• -V, --version — print version information and exit

---

okay now the extra lore, don't skip this part bestie, it's important 🫶

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. last one wins, periodt 💅

--verbose and --quiet are additive. The default is to print warnings and above only. Available log-levels are 'mute', 'critical, 'error', 'warning' and 'info'. (yes the quotes are giving chaos, we reproduce them faithfully, we don't fix, we don't touch ✋)

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. highkey do not turn this on casually bestie, that search will eat your afternoon 😭 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 🌈

look at her go:

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 💜

Copyright © GPL 2002-2013, 2022 Robin Gareus <robin@gareus.org>

---

and that's the whole page bestie 🎀 this was harvid v0.9.1, born December 2022, and she ate. mwah 💋✨🦋