Prepare stable 0.1.0 release

2026-10-25 16:35:51 +01:00
1 parent e03d491353
commit f21167e1a2
@@ -0,0 +1,60 @@
+# Ferese 0.1.0
+
+Ferese 0.1.0 is our first stable release. It includes the window manager, panel,
+Settings, notifications and lock screen, with one set of appearance settings
+across the desktop.
+
+## Arrange your windows
+
+Choose a layout for each workspace. Scroll through columns of windows, tile them
+to fit the screen, or let them float. You can switch layouts as your work changes
+and group related windows into tabs.
+
+Move and resize windows with the mouse or keyboard. Overview shows your open
+windows and workspaces, and the launcher finds apps, files and commands.
+Display scaling has finer steps for getting text to a comfortable size.
+
+## Change the panel and appearance
+
+Build your panel in Settings. Move controls between groups, put the panel at the
+top or bottom, and choose anything from a full-width bar to separate floating
+controls. Morph keeps the panel in a small hub that opens when you need it.
+
+Pick from six themes with light and dark versions, then adjust the colors,
+wallpaper, transparency and motion. The shell, Settings, menus and lock screen
+follow the same theme. Changes apply as you make them.
+
+The panel can also show command and build progress, music controls, and a focus
+timer with work and break sessions.
+
+## Share and record
+
+Share a window, a display, or one workspace. A shared workspace stays on screen
+for your audience when you switch elsewhere, and leaves out the panel and
+notifications. Sharing ends when you lock the desktop.
+
+Record a display or a selected area from the panel, with optional microphone
+and system audio. The new **Capture status** item shows which apps are sharing.
+With the optional OBS connection set up, it also shows when you're live,
+recording, paused or reconnecting. An OBS preview alone shows **Sharing**.
+
+Your saved panel layout stays as it is. To add the new indicator, open
+**Settings → Panel & Shell → Edit panel → Add item** and choose **Capture status**.
+The [sharing guide](https://github.com/ferese-wm/ferese/blob/v0.1.0/docs/screen-sharing.md#panel-status)
+includes the OBS setup steps.
+
+We removed repeated background checks and work that redraws an unchanged screen.
+Fixes also cover floating windows opening on the wrong monitor and notification
+menus closing when their unread badge clears.
+
+## Install or upgrade
+
+Packages are available below for Fedora 44 and Arch Linux on 64-bit Intel and
+AMD PCs. Other distributions can [build from source](https://github.com/ferese-wm/ferese/blob/v0.1.0/docs/installation.md).
+
+If you're moving from a source installation to a package, follow the
+[package installation guide](https://github.com/ferese-wm/ferese/blob/v0.1.0/docs/packaging.md#install-a-release-package)
+first. Keep your personal configuration, then log out and back in after updating.
+
+Found a problem? [Open an issue](https://github.com/ferese-wm/ferese/issues)
+with what happened, how to reproduce it, and your Ferese version.