Add audio and region recording; make routine CI manual (#25)

The top-bar recorder previously saved a full monitor without sound. It now lets you select a region within one monitor and choose system audio, microphone audio, or both. Audio remains off by default, and recordings with audio are saved as VP8/Opus WebM files. The portal still controls screen access and cancellation; stopping from the bar or ending the video stream finishes the recording, including its audio tracks.

Region selection accounts for fractional display scales and negative monitor coordinates. The picker keeps its action buttons visible while the display list and recording options scroll together. The picker, dependency lists, and recording documentation now explain the available choices and the slurp and audio requirements.

Routine pushes and pull requests no longer start CI runners. Workspace checks and website deployment are manual, while release checks run when requested manually, through a version tag, or through a PR labeled `release`. Publishing still requires a pushed version tag. This also fixes release asset checksums by normalizing RPM filenames before generating the checksum file.

Validated locally with a release build, portal and shell recorder tests, formatting, Clippy, actionlint, packaging tests, and mocked publishing checks. Media tests encoded and decoded cropped video with audio, checked that video termination finishes live audio, and exercised system, microphone, and combined capture against a private PipeWire-Pulse server. Mixed recordings must contain both fixture frequencies, with negative controls for either missing source. The picker was also checked on 800 × 600 and 800 × 400 desktops and opened in a live nested window.

docs/development.md

@@ -15,6 +15,10 @@ Use release builds for performance and animation checks. Preview changes in a
 [nested session](installation.md#preview-and-logs) before testing hardware behavior.
 Keep another desktop available for direct-session recovery.
 
+Run CI manually when a change needs it. Ordinary pushes and pull requests do not
+start build runners, and website deployment is manual. Release tags and pull
+requests labeled `release` run the release checks and package builds.
+
 CI checks formatting, lints and tests across the whole workspace, including the
 shell, settings, portal and CLI. The Fedora workspace job also builds desktop
 binaries and runs installer, session-recovery and private portal-contract checks. The
@@ -73,6 +77,8 @@ Check real encoding and the private InputCapture transport:
 
 ```sh
 cargo test --locked -p xdg-desktop-portal-ferese --bin ferese-record encoder_finishes_a_real_webm -- --ignored
+cargo test --locked -p xdg-desktop-portal-ferese --bin ferese-record encoder_saves_cropped_video_and_mixed_audio_when_stopped -- --ignored
+cargo test --locked -p xdg-desktop-portal-ferese --bin ferese-record video_eos_finishes_live_audio_without_waiting_for_the_user -- --ignored
 cargo test --locked -p ferese input_capture::tests
 cargo test --locked -p xdg-desktop-portal-ferese eis::tests -- --ignored
 ```

docs/installation.md

@@ -25,7 +25,7 @@ sudo dnf install python3 git curl gcc gcc-c++ make cmake pkgconf-pkg-config \
   freetype-devel expat-devel dbus-daemon dbus-tools desktop-file-utils foot pam \
   clang clang-devel pipewire-devel pipewire wireplumber polkit polkit-libs \
   xdg-desktop-portal xdg-desktop-portal-gtk \
-  gstreamer1-devel gstreamer1-plugins-base gstreamer1-plugins-good pipewire-gstreamer
+  gstreamer1-devel gstreamer1-plugins-base gstreamer1-plugins-good pipewire-gstreamer pipewire-pulseaudio slurp
 ```
 
 ### Arch Linux
@@ -35,7 +35,7 @@ sudo pacman -S --needed python base-devel git curl cmake pkgconf wayland libxkbc
   libinput systemd seatd mesa libdrm fontconfig freetype2 expat dbus \
   desktop-file-utils foot pam clang pipewire libpipewire wireplumber polkit \
   xdg-desktop-portal xdg-desktop-portal-gtk \
-  gstreamer gst-plugins-base gst-plugins-good gst-plugin-pipewire
+  gstreamer gst-plugins-base gst-plugins-good gst-plugin-pipewire pipewire-pulse slurp
 ```
 
 ### Debian and Ubuntu
@@ -49,7 +49,7 @@ sudo apt install python3 build-essential git curl cmake pkg-config libwayland-de
   libpipewire-0.3-dev libspa-0.2-dev pipewire wireplumber polkitd libpolkit-agent-1-0 \
   xdg-desktop-portal xdg-desktop-portal-gtk \
   libgstreamer1.0-dev gstreamer1.0-pipewire gstreamer1.0-plugins-base \
-  gstreamer1.0-plugins-good
+  gstreamer1.0-plugins-good pipewire-pulse slurp
 ```
 
 Installation has been tested on Fedora. Package names or versions may differ on

docs/screen-sharing.md

@@ -7,12 +7,17 @@ portal and PipeWire dependencies.
 ## Record from the top bar
 
 1. Click the recording icon.
-2. Select a monitor and click **Share**.
-3. Click the stop square to finish.
+2. Choose a display and an audio source: **Off**, **System sound**, **Microphone**,
+   or **Both**. Audio is off by default; the other choices use
+   your default output or input device from audio settings.
+3. Click **Record** to capture the whole display. For part of it, turn on
+   **Select a region**, click **Select region**, then drag a rectangle inside
+   the chosen display. Press Escape to cancel selection.
+4. Click the stop square to finish.
 
-The recorder saves VP8 WebM files under `Ferese` in your XDG Videos folder, then
-shows the path in a notification. The built-in recorder does not support audio or
-region recording; other recording apps can handle audio separately.
+The recorder saves WebM files with VP8 video and, when selected, Opus audio under
+`Ferese` in your XDG Videos folder, then shows the path in a notification. Region
+recordings cover a rectangle within one display; they cannot span displays.
 If recording fails, a notification reports the error and any unfinished
 `.webm.part` file.
 
@@ -50,7 +55,10 @@ permissions are not saved. Stopping a stream does not erase a saved permission.
 ## Requirements and limits
 
 Install PipeWire, WirePlumber, `xdg-desktop-portal`, and `xdg-desktop-portal-gtk`.
-The built-in recorder also needs GStreamer's PipeWire, base, and good plugins;
+The built-in recorder also needs GStreamer's PipeWire, base, and good plugins.
+Region selection needs `slurp`; audio recording needs PipeWire-Pulse or PulseAudio
+and the GStreamer PulseAudio and Opus plugins. With audio set to Off, the recorder
+does not open an audio device. For distribution package names,
 see the [package lists](installation.md#requirements).
 
 The installer supplies Ferese's portal backend and selects it for screen sharing.