===============================================================================
                            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
-------------------------------------------------------------------------------

v1.2.0
-------------------------------------------------------------------------------
* 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.1.0
-------------------------------------------------------------------------------
* Improved multi-camera device detection and profile configuration logic.
* Added support for custom config file paths via command line arguments.

v1.0.0
-------------------------------------------------------------------------------
* Initial release of Pigeon Cam Control.
* Basic V4L2 camera