fusuma-plugin-appmatcher 0.10.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01dac2dad9fcdf720ae85a3d640e1f41d22b34cff26f688b8eb05ecff25ed354
-  data.tar.gz: 1bf60e0762ce6ea974de6006c7c8bba37eb596d64655905db14e1072b4a4a48e
+  metadata.gz: 1eb7a30939beb5781398de99a315a6382beb4d8183e9f87fa076c560a6d2497e
+  data.tar.gz: e198858920d58779268878849b14fe35a57ad3b4fb9c90c973d1347acf65e791
 SHA512:
-  metadata.gz: ce5c29f65ae143c0d345cae02082345e5f32fcf3b5ba18ad711ce0c9da6b205f8895a9636c733971e0ce060529b921876d414d1295b4e79e46f584a4a6f13f8c
-  data.tar.gz: 468eab88d695b833d383d04088111cd7656fab4ee6921cef081737f8170b110e377780012e099bb1d95acc788d4bef9b583f53993a50f8ba69aed75ebbaace53
+  metadata.gz: fdce434ee079f9dc5ac2c258e7f5748ee4add701a7eb36d49a90ef9922046f12e8340240ba46d6750b6c6b83ed92b57ef9a0a9f1cc8473715a965bb884754d4d
+  data.tar.gz: 1633f89b6c50380ab6bf1acd31253f60b96d252f554c5630e23c0b6fd318d63ebd827602fb6414b48f8af6f9dd21ea373c8ef741592e93b2912c1bea74777490

data/README.md

@@ -3,7 +3,7 @@
 [Fusuma](https://github.com/iberianpig/fusuma) plugin configure app-specific gestures
 
 * Switch gesture mappings by detecting active application.
-* Support X11, Ubuntu-Wayland
+* Support X11, GNOME Wayland, Hyprland, COSMIC
 
 
 ## Installation
@@ -27,6 +27,14 @@ $ fusuma-appmatcher --install-gnome-extension
 
 Restart your session(logout/login), then activate Appmatcher on gnome-extensions-app
 
+### Install cos-cli for COSMIC Desktop
+
+On POP!_OS COSMIC, fusuma-plugin-appmatcher uses [cos-cli](https://github.com/estin/cos-cli) (a third-party CLI) to read active window state from the cosmic-comp Wayland compositor.
+
+```sh
+$ cargo install --git https://github.com/estin/cos-cli
+```
+
 ## List Running Application names
 
 `$ fusuma-appmatcher -l` prints Running Application names.
@@ -97,10 +105,71 @@ swipe:
       sendkey: 'LEFTSHIFT+LEFTCTRL+W'
 ```
 
+## Multiple Applications (OR condition)
+
+**Requires fusuma v3.12.0 or later**
+
+You can specify multiple applications using array format. The gesture will be triggered when **any** of the listed applications is active.
+
+```yaml
+---
+context:
+  application:
+    - Google-chrome
+    - Firefox
+swipe:
+  3:
+    left:
+      sendkey: 'LEFTALT+RIGHT'
+    right:
+      sendkey: 'LEFTALT+LEFT'
+    up:
+      sendkey: 'LEFTCTRL+T'
+    down:
+      sendkey: 'LEFTCTRL+W'
+```
+
+## Combining with Other Context Plugins (AND condition)
+
+**Requires fusuma v3.12.0 or later**
+
+You can combine `application` with other context conditions. When multiple keys are specified under `context:`, **all** conditions must be satisfied (AND logic).
+
+For example, with [fusuma-plugin-thumbsense](https://github.com/iberianpig/fusuma-plugin-thumbsense):
+
+```yaml
+---
+context:
+  thumbsense: true
+  application:
+    - Alacritty
+    - Gnome-terminal
+swipe:
+  3:
+    up:
+      sendkey: 'LEFTSHIFT+LEFTCTRL+T'
+    down:
+      sendkey: 'LEFTSHIFT+LEFTCTRL+W'
+```
+
+In this example, the gesture is only triggered when:
+1. Thumbsense mode is active (finger is touching the touchpad)
+2. AND the active application is either Alacritty or Gnome-terminal
+
+This AND logic works with any context plugin that provides context conditions
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/iberianpig/fusuma-plugin-appmatcher. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
+### Help Wanted: Support for Other Wayland Compositors
+
+Currently, this plugin supports X11, GNOME Wayland, Hyprland, and COSMIC. We'd love to expand support to other Wayland compositors (Sway, KDE Plasma, wlroots-based compositors, etc.).
+
+If you're using an unsupported compositor:
+- Please [open an issue](https://github.com/iberianpig/fusuma-plugin-appmatcher/issues) to let us know
+- Help with testing and feedback is greatly appreciated
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/fusuma/plugin/appmatcher/cosmic.rb

@@ -0,0 +1,133 @@
+# frozen_string_literal: true
+
+require "open3"
+require "json"
+require_relative "user_switcher"
+require "fusuma/multi_logger"
+require "fusuma/custom_process"
+
+module Fusuma
+  module Plugin
+    module Appmatcher
+      # Search Active Window's Name for COSMIC desktop via cos-cli (third-party).
+      # cos-cli must be installed separately:
+      #   cargo install --git https://github.com/estin/cos-cli
+      class Cosmic
+        include UserSwitcher
+
+        attr_reader :reader, :writer
+
+        # Search PATH in pure Ruby: the external `which` command is not
+        # installed on minimal systems (e.g. Arch containers).
+        # @return [Boolean]
+        def self.available?
+          ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |dir|
+            path = File.join(dir, "cos-cli")
+            File.executable?(path) && !File.directory?(path)
+          end
+        end
+
+        def initialize
+          @reader, @writer = IO.pipe
+        end
+
+        def watch_start
+          as_user(proctitle: self.class.name.underscore) do |_user|
+            @reader.close
+            register_on_application_changed(Matcher.new)
+          end
+        end
+
+        private
+
+        def register_on_application_changed(matcher)
+          @writer.puts(matcher.active_application || "NOT FOUND")
+          matcher.on_active_application_changed { |name| notify(name) }
+        end
+
+        def notify(name)
+          @writer.puts(name)
+        rescue Errno::EPIPE
+          exit 0
+        rescue => e
+          MultiLogger.error e.message
+          exit 1
+        end
+
+        class Matcher
+          # @return [String, nil]
+          def active_application
+            extract_activated_app_id(fetch_info)
+          end
+
+          # @return [Array<String>]
+          def running_applications
+            state = fetch_info
+            return [] unless state
+            (state["apps"] || []).map { |a| a["app_id"] }.compact.uniq
+          end
+
+          # Sentinel value distinct from nil, so the first iteration always
+          # yields (otherwise initial nil == nil would skip yielding NOT FOUND).
+          UNSET = Object.new.freeze
+          private_constant :UNSET
+
+          def on_active_application_changed
+            last = UNSET
+            subscribe_state_change do |state|
+              app_id = extract_activated_app_id(state)
+              next if app_id == last
+              last = app_id
+              yield(app_id || "NOT FOUND")
+            end
+          rescue => e
+            MultiLogger.error "Cosmic subscription error: #{e.message}"
+            sleep 1
+            retry
+          end
+
+          private
+
+          # @return [Hash, nil]
+          def fetch_info
+            stdout, _stderr, status = Open3.capture3("cos-cli", "info", "--json")
+            return nil unless status.success? && !stdout.empty?
+            JSON.parse(stdout)
+          rescue JSON::ParserError, Errno::ENOENT
+            nil
+          end
+
+          # @param state [Hash, nil]
+          # @return [String, nil]
+          def extract_activated_app_id(state)
+            return nil unless state
+            apps = state["apps"] || []
+            focused = apps.find { |a| (a["state"] || []).include?("activated") }
+            focused && focused["app_id"]
+          end
+
+          def subscribe_state_change
+            # cos-cli serve is a stdio JSON-RPC server and exits on stdin EOF,
+            # so keep stdin open while reading notifications.
+            Open3.popen3("cos-cli", "serve") do |_stdin, stdout, stderr, _wait_thr|
+              stdout.each_line do |line|
+                msg = JSON.parse(line)
+                next unless msg["method"] == "state_change"
+                state = msg.dig("params", "state")
+                yield state if state
+              rescue JSON::ParserError => e
+                MultiLogger.warn "Failed to parse cos-cli message: #{e.message}"
+              end
+              # A clean serve exit must not stop the watcher silently:
+              # raise so on_active_application_changed resubscribes via retry.
+              raise "cos-cli serve exited: #{stderr.read}"
+            end
+          rescue Errno::ENOENT
+            MultiLogger.error "cos-cli command not found. Install with: cargo install --git https://github.com/estin/cos-cli"
+            raise
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fusuma/plugin/appmatcher/hyprland.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require "socket"
+require "json"
+require_relative "user_switcher"
+require "fusuma/multi_logger"
+require "fusuma/custom_process"
+
+module Fusuma
+  module Plugin
+    module Appmatcher
+      # Search Active Window's Name for Hyprland
+      class Hyprland
+        include UserSwitcher
+
+        attr_reader :reader, :writer
+
+        def initialize
+          @reader, @writer = IO.pipe
+        end
+
+        # fork process and watch signal
+        # @return [Integer] Process id
+        def watch_start
+          as_user(proctitle: self.class.name.underscore) do |_user|
+            @reader.close
+            register_on_application_changed(Matcher.new)
+          end
+        end
+
+        private
+
+        def register_on_application_changed(matcher)
+          @writer.puts(matcher.active_application || "NOT FOUND")
+
+          matcher.on_active_application_changed do |name|
+            notify(name)
+          end
+        end
+
+        def notify(name)
+          @writer.puts(name)
+        rescue Errno::EPIPE
+          exit 0
+        rescue => e
+          MultiLogger.error e.message
+          exit 1
+        end
+
+        # Look up application name using hyprctl
+        class Matcher
+          ACTIVEWINDOW_EVENT = "activewindow"
+
+          # @return [Array<String>]
+          def running_applications
+            output = `hyprctl clients -j 2>/dev/null`
+            return [] if output.empty?
+            JSON.parse(output).map { |c| c["class"] }.compact.uniq
+          rescue JSON::ParserError
+            []
+          end
+
+          # @return [String, nil]
+          def active_application
+            output = `hyprctl -j activewindow 2>/dev/null`
+            return nil if output.empty? || output.strip == "{}"
+            JSON.parse(output)["class"]
+          rescue JSON::ParserError
+            nil
+          end
+
+          def on_active_application_changed
+            socket = connect_to_socket2
+            return unless socket
+
+            loop do
+              line = socket.gets
+              break unless line
+
+              event, data = line.chomp.split(">>", 2)
+              next unless event == ACTIVEWINDOW_EVENT
+
+              window_class, _window_title = data.split(",", 2)
+              yield(window_class.to_s.empty? ? "NOT FOUND" : window_class)
+            end
+          rescue Errno::ECONNRESET, Errno::EPIPE, IOError
+            # socket disconnected
+          ensure
+            socket&.close
+          end
+
+          private
+
+          # @return [String, nil]
+          def find_socket_path
+            instance_sig = ENV["HYPRLAND_INSTANCE_SIGNATURE"]
+            return nil unless instance_sig
+
+            xdg_runtime = ENV.fetch("XDG_RUNTIME_DIR", "/tmp")
+            [
+              File.join(xdg_runtime, "hypr", instance_sig, ".socket2.sock"),
+              File.join("/tmp", "hypr", instance_sig, ".socket2.sock")
+            ].find { |p| File.exist?(p) }
+          end
+
+          # @return [UNIXSocket, nil]
+          def connect_to_socket2
+            path = find_socket_path
+            return nil unless path
+            UNIXSocket.new(path)
+          rescue Errno::ENOENT, Errno::ECONNREFUSED
+            nil
+          end
+        end
+      end
+    end
+  end
+end

data/lib/fusuma/plugin/appmatcher/version.rb

@@ -3,7 +3,7 @@
 module Fusuma
   module Plugin
     module Appmatcher
-      VERSION = "0.10.0"
+      VERSION = "0.12.0"
     end
   end
 end

data/lib/fusuma/plugin/appmatcher.rb

@@ -5,6 +5,8 @@ require "fusuma/plugin/appmatcher/version"
 require "fusuma/plugin/appmatcher/x11"
 require "fusuma/plugin/appmatcher/gnome_extension"
 require "fusuma/plugin/appmatcher/gnome_extensions/installer"
+require "fusuma/plugin/appmatcher/hyprland"
+require "fusuma/plugin/appmatcher/cosmic"
 require "fusuma/plugin/appmatcher/unsupported_backend"
 
 module Fusuma
@@ -30,6 +32,18 @@ module Fusuma
               MultiLogger.warn "$ fusuma-appmatcher --install-gnome-extension"
               MultiLogger.warn ""
             end
+          when /Hyprland/i
+            return Hyprland if hyprland_available?
+          when /COSMIC/i
+            if Cosmic.available?
+              return Cosmic
+            else
+              MultiLogger.warn "cos-cli command not found"
+              MultiLogger.warn "Please install cos-cli to use appmatcher with COSMIC desktop:"
+              MultiLogger.warn ""
+              MultiLogger.warn "  $ cargo install --git https://github.com/estin/cos-cli"
+              MultiLogger.warn ""
+            end
           end
         end
 
@@ -44,6 +58,17 @@ module Fusuma
       def xdg_current_desktop
         ENV.fetch("ORIGINAL_XDG_CURRENT_DESKTOP", ENV.fetch("XDG_CURRENT_DESKTOP", ""))
       end
+
+      def hyprland_available?
+        instance_sig = ENV["HYPRLAND_INSTANCE_SIGNATURE"]
+        return false unless instance_sig
+
+        xdg_runtime = ENV.fetch("XDG_RUNTIME_DIR", "/tmp")
+        [
+          File.join(xdg_runtime, "hypr", instance_sig, ".socket2.sock"),
+          File.join("/tmp", "hypr", instance_sig, ".socket2.sock")
+        ].any? { |p| File.exist?(p) }
+      end
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusuma-plugin-appmatcher
 version: !ruby/object:Gem::Version
-  version: 0.10.0
+  version: 0.12.0
 platform: ruby
 authors:
 - iberianpig
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-20 00:00:00.000000000 Z
+date: 2026-06-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rexml
@@ -68,12 +68,14 @@ files:
 - exe/fusuma-appmatcher
 - fusuma-plugin-appmatcher.gemspec
 - lib/fusuma/plugin/appmatcher.rb
+- lib/fusuma/plugin/appmatcher/cosmic.rb
 - lib/fusuma/plugin/appmatcher/gnome_extension.rb
 - lib/fusuma/plugin/appmatcher/gnome_extensions/appmatcher45@iberianpig.dev/extension.js
 - lib/fusuma/plugin/appmatcher/gnome_extensions/appmatcher45@iberianpig.dev/metadata.json
 - lib/fusuma/plugin/appmatcher/gnome_extensions/appmatcher@iberianpig.dev/extension.js
 - lib/fusuma/plugin/appmatcher/gnome_extensions/appmatcher@iberianpig.dev/metadata.json
 - lib/fusuma/plugin/appmatcher/gnome_extensions/installer.rb
+- lib/fusuma/plugin/appmatcher/hyprland.rb
 - lib/fusuma/plugin/appmatcher/unsupported_backend.rb
 - lib/fusuma/plugin/appmatcher/user_switcher.rb
 - lib/fusuma/plugin/appmatcher/version.rb