UVCDYNCTRL(1)

πŸ“¦ version 0.2.4, in ubuntu jammy

πŸ’– UVCDYNCTRL β€” the libwebcam command line tool, bestie edition πŸ’–

okay so. this is uvcdynctrl, version 0.2.3, from the libwebcam gang. it's a command line tool. it does camera stuff. sit down, hydrate, and let's get into it 🫢


✨ SYNOPSIS ✨

uvcdynctrl [OPTIONS]... [VALUES]...

that's it. that's the whole shape of it. options, then values, go off πŸ‘‘


🌸 DESCRIPTION 🌸

uvcdynctrl 0.2.3 β€” she manages dynamic controls in uvcvideo. that's the whole gig. dynamic controls. in uvcvideo. iconic honestly.

here's everything she can do, one flag at a time, no skips, no cuts πŸŽ€


πŸ’… OPTIONS πŸ’…

  • -h, --help β€” prints the full help and then dips out. full help, bestie, not a lil summary. then exit. πŸ¦‹
  • -V, --version β€” prints the version and exits. short and sweet, respect.
  • -l, --list β€” lists all the available cameras. look at all your lil guys πŸ‘€
  • -i, --import=filename β€” imports dynamic controls from an XML file. yes, XML. it's giving vintage but she works. πŸ’Ύ
  • -a, --addctrl=vid β€” imports dynamic controls for vid from the default location. it knows where they live, don't worry.
  • -v, --verbose β€” turns on verbose output. default is off, so she's quiet unless you ask her to spill. πŸ™ˆ
  • -d, --device=devicename β€” picks which device to use. default is video0. if you have one camera, this is already handled, you're welcome. πŸ“·
  • -c, --clist β€” lists the available controls. the whole menu, laid out. slay.
  • -g, --get=control β€” grabs the current value of a control. reading era.
  • -G, --get_raw=unit_id:selector β€” grabs the current raw control value. raw as in raw raw. πŸ”₯
  • -s, --set=control β€” sets a new control value. and listen, for negative values you gotta do it like this:
-s 'My Control' -- -42

the -- is doing the heavy lifting there, don't skip it. πŸ’€

  • -S, --set_raw=unit_id:selector β€” sets a new raw control value. the value is a hex string of the control size, and by default it's little endian. wanna flip it? slap a '(BE)' prefix on the front and she'll read it big endian instead. like so:
-S 13:1 0x01100c

or:

-S 13:1 '(BE)0x0c1001'

hex girlies rise 🌈

  • -f, --formats β€” lists the available frame formats. resolution vibes, fps vibes, all of it.
  • -W, --save=filename β€” saves the device controls state to a file. little snapshot, little memory, cute. πŸŽ€
  • -L, --load=filename β€” loads the device controls state from a file. the glow-up restore point. ✨

πŸ‘‘ SEE ALSO πŸ‘‘

the full documentation for uvcdynctrl is maintained as a Texinfo manual. so if info and uvcdynctrl are both properly installed at your site, this:

info uvcdynctrl

should hand you the complete manual. no cap. go read it, iykyk πŸ’œ


real talk: if you're out here poking raw control values with -S and -G, know what you're doing first. hex strings, unit ids, selectors β€” that's main character energy but also it's your hardware. be cute, be careful. 🫢

and that's the page, bestie!! πŸ¦‹ this is from uvcdynctrl 0.2.3, dated Aug 2013, page 7 of the manual. old but gold, fr fr. mwah πŸ’‹

πŸ“¦ where this page comes from