GUVCVIEW(1)

📦
version 2.2.2 · 3 versions
, in alpine 3.24, arch rolling, debian trixie, epel 9, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 GUVCVIEW 💖

okay bestie, so guvcview is the manual page for the GTK+ base UVC Viewer, and it lives in section 1 of the manual (general commands, aka the "type it in your terminal" zone). It's giving camera-app energy and honestly? iconic. 🎀

✨ SYNOPSIS ✨

guvcview

that's it. that's the whole thing. no cap. 💅

🦋 DESCRIPTION 🦋

So like, guvcview is this application for capturing and viewing video from devices that the Linux kernel video4linux2 interface supports. That's the whole vibe. If your webcam shows up to v4l2, bestie, it's showing up here. 🎥✨

🌸 USAGE 🌸

guvcview [options...]

you run it, you can sprinkle options on it, slay. 🫶

👑 OPTIONS 👑

okay here's the full lineup, and no I did not skip any of them, I would never do that to you:

  • -h, --help — Prints the help. Your little "what do I do" button. 💖
  • -v, --version — Prints the version. Identity check. ✨
  • -w, --verbosity=LEVEL — Sets the Verbosity level. default is 0. crank it up if you want the tea. ☕
  • -d, --device=AUDIO_DEVICE — Sets the device name. default is /dev/video0. yes, it's called AUDIO_DEVICE in the option, and yes, the default is a video device — that's just how it is, we don't question the ancestors. 🙈
  • -c, --capture=METHOD — Sets the capture method. the options are read or mmap, and mmap is the default. 🧚
  • -b, --disable_libv4l2 — Disables calls to libv4l2. bye bestie. 👋
  • -x, --resolution=WIDTHxHEIGHT — Requests a resolution, like e.g 640x480. main character framing. 🔥
  • -f, --format=FOURCC — Requests a format, like e.g MJPG. 🎞️
  • -F, --fps=FPS_NUM[/FPS_DENOM] — Requests fps. like e.g. 25, or 7/3, or .... frames per second, but make it a ratio if you're feeling fancy. ⭐
  • -r, --render=RENDER_API — Selects the render API. like e.g none, sdl, sfml. 🌈
  • -m, --render_window=RENDER_WINDOW_FLAGS — Sets the render window flags. like e.g none, full, max, or WIDTHxHEIGHT. 👑
  • -a, --audio=AUDIO_API — Selects the audio API. like e.g none, port, pulse. 🔊
  • -k, --audio_device=audio_device — Selects the audio device index for the selected api, ranging 0..N. 🎤
  • -g, --gui=GUI_API — Selects the GUI API. like e.g none, gtk3, qt6. 💅
  • -o, --audio_codec=codecAudio — Audio codec. your choices are pcm mp2 mp3 aac ac3 vorb. 🎧
  • -u, --video_codec=codec — Video codec. your choices are raw mjpg mpeg flv1 wmv1 mpg2 mp43 dx50 h264 vp80 theo. the whole alphabet of formats fr fr. 🎬
  • -p, --profile=filename — Loads a control profile. 💜
  • -j, --video=filename — filename for captured video). yes the closing paren is part of the lore, we keep it. 😭
  • -i, --image=filename — filename for captured image). same deal, paren and all. 📸
  • -y, --video_timer=TIME_IN_SEC — Time (double) in sec. for video capture). 🕐
  • -t, --photo_timer=TIME_IN_SEC — Time (double) in sec. between captured photos). ⏳
  • -n, --photo_total=total — Total number of captured photos). 🍓
  • -e, --exit_on_term — Exits the app after video or image capture ends. it said goodbye first, very polite. 🚪
  • -z, --control_panel — Starts in control panel mode. sliders and switches, the whole aesthetic. 🎛️
ngl bestie, a couple of these descriptions end in a stray ) in the original page. I kept them exactly as they are because the rule is every detail stays, and I do not make the rules, I just follow them flawlessly. 💖

🎀 AUTHOR 🎀

This manual page was written by Paulo Assis <pj.assis@gmail.com>, for the Debian GNU/Linux system (but may be used by others). shoutout to Paulo, absolute legend. 🫶

and that's the whole page bestie!! this version is from May 2024, and it's the GUVCVIEW(1) page from the General Commands Manual — go forth and capture some video, you've got this. 💖✨🎀🦋🌸💅🫶😭🔥👑🌈⭐💀🙈🍓🧚💜

📦 where this page comes from