Add configurable night light, smooth gamma transitions, and shell controls. Update documentation and panel tests, and fix portal test startup synchronization.
Publish the guides from this repository to the GitHub Wiki. Organize them into Usage, Configuration and Development, with 15 separate configuration topics and redirects for the former website guide URLs.
Add a tabbed-windows guide covering grouping, switching tabs and taking windows out. Document the scrolling indicator's defaults and limits, and link the guide from the README, shortcuts and IPC pages. Update from main, including the latest tabbed-layout changes.
Separate Activities setup, configuration and publishing documentation. Review the guide prose with the unslop skill, keeping existing examples and heading links. The wiki workflow uses GitHub's built-in token to publish documentation changes on main.
Validation:
- 20 documentation tests pass, including README links and Activities/tab-indicator field coverage.
- The publisher builds 46 wiki pages; the site build and Python syntax checks pass.
- All 115 code examples from main are preserved.
- The Python suite passes: 90 tests passed and 31 opt-in integration tests skipped, with the system GI module available.
Add named keyboard shortcut maps with an Escape exit and a panel indicator. Keep press/release ownership across transitions, validate remapped Escape keys, and cancel stale repeats and focus previews.
Give the indicator ownership of the panel while a mode is active. Close popovers, collapse Morph, and keep Live Activities data current without resizing the hidden panel. Document configuration and transition behavior.
Validation: 1,519 workspace Rust tests passed; 70 Python tests passed. Workspace build, formatting, Clippy, and Settings configuration validation passed. Opt-in native desktop checks were not rerun because Weston is absent.
Related: #5.
* Add Live Activities as configurable bar items
* Fix activity owner monitoring and Morph list interactions
* Keep activity rows stable during updates and tighten their layout
* Use subtle theme tint for activity cards
* Tighten activity title and progress spacing
* Use theme accent for active progress rings
* Fit compact activities to measured titles and badge
* Expose Live Activities display controls in Settings
* Open activity terminals and streamline the Morph header
* Give Morph continuous icons and prioritize workspace navigation
* Show activity progress inside its ring
* Inset activity progress rings and strengthen their stroke
* Fix activity lifecycle, command output handling and list navigation
* Reduce activity update work and harden publisher lifetimes
* Set up Live Activities for the detected user shell during installation
* Document Activities setup, daily use and troubleshooting
* Preserve Morph idle width across empty activity updates
* Fix dimming flicker, hide inactive music tab and consolidate Activities docs
* Fix panel clearance across styles and match previews to theme settings
* Prevent panel blur from repainting neighboring islands
---------
Co-authored-by: Samuel Onoja <[email protected]>
Invalid configuration currently prevents login. Ferese now starts with built-in defaults and shows a notification when the shell is ready, leaving the file untouched. Loading and validation belong to the config module, while the theme module resolves appearance. Validation remains strict, and failed live reloads keep the active settings.
The native Morph regression checks the animated input region and idle frame scheduling while its backing surface stays allocated.
Validation: workspace and Python tests, formatting, Clippy, release build, and isolated Wayland startup/reload and panel-motion tests. Native CI includes the startup regression.
Related: #28.
Panel appearance now applies to the whole panel, with seven styles: Floating, Capsules, Notch, Edge to edge, Fused islands, Adaptive and Morph.
- Share composition, geometry, and motion through the renderer-independent `ferese-panel` crate, including native materials, input regions, and Settings previews.
- Add the Morph hub with media, calendar, notifications, controls, workspace previews, hover feedback, and attached mode. Keep recording and low-battery status visible and respect window clearance.
- Cache workspace preview geometry, draw thumbnails directly, centralize Morph transitions, and keep rendering settings local to each shell instance.
- Put Record Screen in the Morph header and show the display control only when an external monitor is connected. Update panel documentation, the desktop screenshot, and native check style names.
Local validation included 660 compositor tests, 191 shell tests, isolated preview-cache checks, GPU Morph captures at 1×/1.25×/1.5×, formatting, and Clippy with warnings denied. The final header change passed all 23 Morph tests. Release workflow jobs are skipped for this PR.
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.
* Package Ferese for Fedora and Arch releases
* Build release packages alongside workspace checks
* Include dependency licenses and software GPU test drivers
* Limit package checks to release PRs and fix Arch Cargo dependency
* Prepare Ferese 0.1.0-beta
* Release config locks before closing inherited file descriptions
* Install the lock PAM policy for native release checks
* Include xauth in distribution package test dependencies
* Regenerate Arch Git package metadata
* Run package checks with an explicit UTC timezone
* Remove unused bundled fonts and accept installed license receipts
* Format the system font test helper
* Load an installed font for headless text rendering checks
* Isolate package test runtimes and reap container child processes
* Coordinate config writes and gate releases on desktop validation
* Use toolkit rc.2 with painting and session lock fixes
* Ignore retired desktop widget settings in existing configs
Pin the Iced/libcosmic candidate that paints contour interiors directly and reduces rectangular clipping work. Keep WGPU as the default and update all consumers consistently.
Repeated panel updates rebuilt unchanged controls and SVG artwork, cloned composition data, and kept unused workspace icon resources. This reuses controls when their layout stays the same, bounds the SVG cache, removes temporary layout allocations, and releases icon resources when apps close or the workspace style changes.
Rapidly closing a modal could also leave a native surface behind when its asynchronous creation finished after the close. Late openings now get destroyed when their owner is gone. Ferese uses the published `ferese-v0.1.2` Iced/libcosmic fixes so a temporary software buffer/viewport size mismatch retries the frame instead of crashing.
Two runs per version of the same workspace/overview/reload workload measured **26% fewer allocated bytes and 23% fewer allocation calls**. A separate 1,800-cycle notification/modal stress run retained about **40 MiB less shell memory**, including shared-buffer retention falling from 28.2 MiB to 272 KiB. These are measured workload results, not an overall desktop speedup claim.
Validation:
- 1,350 workspace tests passed, including GPU Settings text rendering (50 optional tests ignored); formatting and Clippy passed.
- Native continuous/island panel tests passed rapid notification resizing, modal cancellation, and live material/input-region changes.
- A Wayland lifetime trace confirmed all 280 created modal surfaces were destroyed; longer DHAT traces and Intel GPU memory measurements were checked separately.
- All installation binaries rebuilt and the installation bundle passed inventory and checksum verification.
* Integrate panel composition, adaptive sizing, and overflow
* Add instance editing controls to panel settings
* Add panel group editing and measured composition preview
* Reorganize panel settings and add drag-and-drop item editing
* Simplify panel settings and place inspectors beside the editor
* Refine Panel & Shell settings, previews, and panel rendering
* Organize settings navigation and modernize packaged panel config
* Support top and bottom panels and refine shell surfaces
Add edge-aware settings, previews, popup placement, notifications, margins, and corner rendering. Preserve translucency in notification and dialog controls, and tighten spacing around the clock and display-mode icon.
* Add workspace styles and fix Settings text rendering
* Make panel allocation independent of measurement order
* Normalize panel item settings and visibility
* Move shell geometry into each panel
* Add independent group surfaces and finalize panel configuration
* Keep panel fit checks and restoration consistent with allocation
* Reject unknown panel item options and namespace metadata
* Reject invalid shell startup configuration and remove old radius fields
* Discover workspace application icons in a background task
* Remove the panel architecture document and improve reference prose
* Let panel media fill available space and improve Settings scrolling
* Preserve panel labels across clipped GPU rendering
* Use matching alpine lake wallpapers for light and dark modes
* Fix panel accessibility and popup lifecycle
Apply Reduce Transparency to panel opacity in the shell, compositor, and
Settings preview. Reject unknown theme tokens before snapshot substitution
and validate the current geometry fields in both consumers.
Dismiss popovers and workspace tooltips after panel layout changes. Handle
bar pointer exits directly and recover workspace hover after reentry without
repeated motion updates. Cover the transitions with regression tests and
update the wallpaper dimensions check for the bundled lake defaults.
* Use tagged Ferese toolkit fixes
* Fix center-only panel spacing and headless text rendering
* Bundle native 4K abstract wallpapers for both appearances
* Dismiss workspace tooltips before captured pointer dispatch
* Verify installed JPEG wallpapers when replacing a release
Retain window IDs, urgency and floating state in shell snapshots. Decode known flags from raw bitfields so future bits do not erase existing state.
Add exact-ID activation, close and overview selection helpers, with snapshot and wire-level regression coverage.
Resize full and fixed columns from their resolved width. Preserve active rows during removal and source widths during extraction, satisfy feasible row minima without changing weights, and keep vertical resize usable for large stacks.
Propagate viewport-coupled width cycles across every row from a common presentation motion. Cover client holds, forecasts, reversal and reduced motion with regression tests.
Keep surviving outputs on their applied CRTCs when enabling another display. Reserve nested IPC directories with explicit private permissions and cover session umasks.
Separate compositor checks from release-only workspace checks, provide test runtime prerequisites, and correct the reload test's initial revision assumption.
Bound IPC transport deadlines while preserving portal leases, supervise desktop helper and agent recovery, and reserve final floating window geometry during placement.
Stabilize CLI output and isolated tests, expand workspace CI, resolve formatting and lint failures, and bundle the MIT license with installer compatibility.
* save dev state
* fix xwayland-satellite supervisor lifecycle, readiness and cleanup
* remove wayland scanner protocol generated files
* default xwayland enabled with path
* remove jargons
* address x11 review: park unconfirmed cleanup, never signal a reaped group, fix storm test and notify dir mode
* fix resize tests: never build Size values from negative dimensions
* add min-width/min-height window rules that replace client minimum sizes
* rename effective_size_constraints to effective_minimum_size and minor cleanups
Samuel Onoja