=============================================================================== Pigeon Cam Control =============================================================================== A lightweight Vala and GTK+ 3 desktop utility designed to manage live camera previews and video recordings using mpv and Video4Linux2 (v4l2). Tailored for monitoring balcony bird life and wildlife feeds. ------------------------------------------------------------------------------- FEATURES ------------------------------------------------------------------------------- * Camera Selection & Auto-Rescan: Automatically detects available V4L2 devices (/dev/video*) with readable device names from sysfs. * Persistent Settings: Automatically saves and restores your preferred camera, output folder, custom filename, and video filter states using GLib KeyFile. * Video Filters: Quick toggles for Horizontal Flip (hflip) and Vertical Flip (vflip) applied live and during recordings via mpv. * Hardware-Accelerated Auto-Compression: Automatically compresses completed recordings in the background using FFmpeg VAAPI hardware acceleration (HEVC/AAC) into _compressed.mp4 files upon stopping a recording. * Live View & Recording: Low-latency live preview and background stream recording powered by mpv. * External Tool Integration: - Open qv4l2 directly for the currently selected camera to adjust hardware exposure, brightness, and focus. - Open guvcview directly for the currently selected camera. - Quick button to open the active recording folder in your default file manager. - Launch SMPlayer directly to review your latest recordings. * Profiles & Custom Configs: Run multiple camera setups simultaneously using independent configuration profiles. ------------------------------------------------------------------------------- REQUIREMENTS ------------------------------------------------------------------------------- Ensure you have the following dependencies installed on your Linux system: * valac (Vala compiler) * gtk+-3.0 * mpv (required for live preview and recording) * ffmpeg with VAAPI support (for automatic background compression) * qv4l2 (optional, for camera property adjustments) * guvcview (optional, for video controls) * smplayer (optional, for playback) ------------------------------------------------------------------------------- COMPILATION & INSTALLATION ------------------------------------------------------------------------------- Compile the application using the included Makefile or directly via valac: make sudo make install ------------------------------------------------------------------------------- CHANGELOG ------------------------------------------------------------------------------- v 1.0.2 * when recording a video, the number is increased in the entry * guvcview now uses "-z" v1.0.1 ------------------------------------------------------------------------------- * Added automatic background video compression: - Triggers automatically upon stopping a recording. - Utilizes FFmpeg VAAPI GPU hardware acceleration (hevc_vaapi, QP 28, AAC). - Saves compressed output with the '_compressed.mp4' suffix in the target folder. * Added dedicated 'guvcview' integration button target to the currently selected camera device (-d /dev/videoX). * Updated 'qv4l2' launcher button to explicitly target the currently selected camera device (-d /dev/videoX). * Added a dedicated 'Folder' button adjacent to SMPlayer launcher to open the current recording directory in the default file manager. v1.0.0 ------------------------------------------------------------------------------- * Initial release of Pigeon Cam Control. * Basic V4L2 camera * Improved multi-camera device detection and profile configuration logic. * Added support for custom config file paths via command line arguments.