fusuma-plugin-appmatcher 0.11.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbc93e3e0a8b5fb94642dc58a9b790fca024187e4d47af726b10662b352bd4ba
-  data.tar.gz: 77a6db018f3b2507618672d09ffc20609264ec2c514bffb996fae3b9ffa336ea
+  metadata.gz: 1eb7a30939beb5781398de99a315a6382beb4d8183e9f87fa076c560a6d2497e
+  data.tar.gz: e198858920d58779268878849b14fe35a57ad3b4fb9c90c973d1347acf65e791
 SHA512:
-  metadata.gz: 7b068878e2526e441fb7943f8e7b730d9fdfaa48ef710fb22bf917d1516e0143c2997bad952a0a9488633749e5125960d41982af99d899ba398369a2b20c05aa
-  data.tar.gz: 875ac50f1ecabd943d4591d01c7241e0a729381eb251427d945d61740d22a358b4a43d9d74dc0187cee0f20383ee82aaadad98d0713d67b62acdfe153c26bb17
+  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/version.rb

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

data/lib/fusuma/plugin/appmatcher.rb

@@ -6,6 +6,7 @@ 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
@@ -33,6 +34,16 @@ module Fusuma
             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
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fusuma-plugin-appmatcher
 version: !ruby/object:Gem::Version
-  version: 0.11.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,6 +68,7 @@ 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