Skip to content

armgit / Filee

Public Imported from GitHub
0

Free, open-source file converter. Convert 263 formats offline by drag & drop — images, PDF, Word, Excel, PowerPoint, HWP/HWPX, video, audio, e-books and archives. No upload, no Office needed.

Merge #367 (native Wayland) into g-waylnd

KnifeLemon9e72852c720e
diff --cc CONTRIBUTING.md
index 0eab0176,59e57088..04f8642d
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@@ -50,11 -50,10 +50,12 @@@ machine that built it. Check a package
Thunar, Nautilus, Nemo and Dolphin. The first enabled keyboard shortcut uses Thunar's native custom action;
close Thunar before changing or pausing that shortcut and reopen it afterwards. Global selected-file queries
and hold gestures are not supported. Wayland can use file actions, the drop zone, watch folders and CLI.
- On KDE Plasma 6 the drag gesture can also run there, experimentally and only with `FILEE_WAYLAND_GESTURES=1`. It needs
- the user in the `input` group (libuiohook's libinput back end) and the KWin script in `installer/linux/kwin`, which
- moves the donut window (titled "Filee Donut") to the cursor. See `installer/linux/INSTALL.txt`.
+ On KDE Plasma 6 and Hyprland, the drag gesture can also run there, experimentally with `FILEE_WAYLAND_GESTURES=1`. It needs
+ the user in the `input` group (libuiohook's libinput back end) and a compositor positioning mechanism (the KWin script in
+ `installer/linux/kwin` or a Hyprland floating window rule). Native Wayland support (`Avalonia.Wayland`) is also available
+ as an opt-in via `FILEE_USE_WAYLAND=1`. See `installer/linux/INSTALL.txt`.
+ On GNOME Wayland, the bundled Shell extension supplies pointer state through a private Unix socket; no input
- group is required. See [docs/GNOME-WAYLAND.md](docs/GNOME-WAYLAND.md) for setup, scope, limitations and tests.
++ group is required. See [docs/GNOME-WAYLAND.md](docs/GNOME-WAYLAND.md) for setup, limits and troubleshooting.
- **macOS:** grant Filee Accessibility permission for gestures and Finder Automation permission for selection.
Keep the development `.app` at a stable path while testing these permissions. Finder integration is a Quick
Action under Services; auto-start uses a per-user LaunchAgent.
diff --cc installer/linux/INSTALL.txt
index c077247e,97a8599a..0e3da65e
--- a/installer/linux/INSTALL.txt
+++ b/installer/linux/INSTALL.txt
@@@ -24,25 -24,10 +24,25 @@@ X11 supports the global gesture toolbar
libxt6). A native Wayland session has additional input restrictions; use the
drop window and file-manager actions, or the experimental setup below.
+GNOME Wayland gestures (experimental, GNOME Shell 45–50): the Linux package
+includes the “Filee donut at the cursor” Shell extension. install.sh installs
+it for the current user on GNOME and requests activation. Open Extensions and
+enable it. If it is missing or still running an older version, sign out and
+sign in again, then start Filee and hold Ctrl while dragging a file in Files.
+No input group, sudo, or FILEE_WAYLAND_GESTURES setting is required on GNOME.
+The Triggers page says when Filee is waiting for the extension. The extension
+provides pointer state over a private local socket and places the menu once
+per opening; Filee respects its configured gestures, Pause and excluded apps.
+It does not collect typed keys. Global selection/hold gestures and Tab/wheel
+flipping during a drag are not supplied by this integration. Disabling the
+extension stops detection; FILEE_WAYLAND_GESTURES=0 opts out on GNOME too.
+Read GNOME-WAYLAND.md in the package (docs/GNOME-WAYLAND.md in the source) for
- troubleshooting, manual checks and the implementation record.
++setup, limits and troubleshooting.
+
- Wayland gesture (experimental, KDE Plasma 6 only, off by default): Filee reads
- the mouse and keyboard from /dev/input through libinput, and a KWin script moves
- the donut to the cursor because Wayland apps cannot place windows. It needs
- libinput, libudev and libwayland-client (libinput10, libudev1 and
+ Wayland gesture (experimental, KDE Plasma 6 and Hyprland, off by default): Filee reads
+ the mouse and keyboard from /dev/input through libinput, and a KWin script or Hyprland
+ window rule places the donut at the cursor because Wayland apps cannot place windows.
+ It needs libinput, libudev and libwayland-client (libinput10, libudev1 and
libwayland-client0 on Ubuntu). To turn it on:
1. Start Filee with FILEE_WAYLAND_GESTURES=1 in its environment, for example
with the line FILEE_WAYLAND_GESTURES=1 in ~/.config/environment.d/filee.conf
diff --cc src/Filee.Platform.Linux/LinuxPlatformServices.cs
index b45dbc94,15135396..c5776644
--- a/src/Filee.Platform.Linux/LinuxPlatformServices.cs
+++ b/src/Filee.Platform.Linux/LinuxPlatformServices.cs
@@@ -21,24 -21,15 +21,27 @@@ public sealed class LinuxPlatformServic
string.Equals(Environment.GetEnvironmentVariable("XDG_SESSION_TYPE"), "wayland", StringComparison.OrdinalIgnoreCase)
|| !string.IsNullOrEmpty(Environment.GetEnvironmentVariable("WAYLAND_DISPLAY"));
+ public static bool IsGnomeWaylandSession => IsWaylandSession
+ && (Environment.GetEnvironmentVariable("XDG_CURRENT_DESKTOP") ?? "").Split(':')
+ .Contains("GNOME", StringComparer.OrdinalIgnoreCase);
+
+ // Enabling the Shell extension opts in; no /dev/input permission or environment setup is needed on GNOME.
+ // Keep KDE's existing libinput opt-in independent. A value of 0 explicitly disables the GNOME bridge too.
+ public static bool UsesGnomePointerBridge => IsGnomeWaylandSession
+ && Environment.GetEnvironmentVariable("FILEE_WAYLAND_GESTURES") != "0";
+
+ public string? GnomePointerProcess { get; set; }
+ public bool GnomePointerIsDesktop { get; set; }
+
- // Wayland gestures (experimental) are opt-in: FILEE_WAYLAND_GESTURES=1 on KDE Plasma. libuiohook's libinput backend
- // reads /dev/input, so /dev/input is only probed once the switch is set, and it works once the user is in the
- // `input` group. Presses carry no position and a mouse only moves relatively there; a KWin script places the donut.
+ // Wayland gestures (experimental) are opt-in: FILEE_WAYLAND_GESTURES=1 on KDE Plasma and Hyprland.
+ // libuiohook's libinput backend reads /dev/input, so /dev/input is only probed once the switch is set,
+ // and it works once the user is in the `input` group. Presses carry no position and a mouse only moves
+ // relatively there; a KWin script or Hyprland window rule places the donut at the cursor.
private static readonly bool WaylandGestures = IsWaylandSession
&& Environment.GetEnvironmentVariable("FILEE_WAYLAND_GESTURES") == "1"
- && (Environment.GetEnvironmentVariable("XDG_CURRENT_DESKTOP") ?? "").Split(':').Contains("KDE", StringComparer.OrdinalIgnoreCase)
+ && WaylandSupport.IsSupportedCompositor(
+ Environment.GetEnvironmentVariable("XDG_CURRENT_DESKTOP"),
+ Environment.GetEnvironmentVariable("HYPRLAND_INSTANCE_SIGNATURE"))
&& CanReadInputDevices();
private static bool CanReadInputDevices()