🎉 Add getOpenWindows and focusWindow methods

Author: Schneegans

changelog.md

@@ -14,9 +14,14 @@ Security   - in case of vulnerabilities.
 
 This changelog uses [semantic versioning](https://semver.org) and follows the rules of [Keep a Changelog](http://keepachangelog.com/).
 
-## [unreleased]
+## [KWin Integration 0.2.0](https://github.com/kando-menu/kwin-integration/releases/tag/v0.2.0)
 
-**Release Date:** TBD
+**Release Date:** 2026-06-17
+
+### :tada: Added
+
+- A method to list all open windows, which is used by the "Focus Window" action to find the window to focus. This method retrieves the stacking order of windows from KWin and returns their titles and classes.
+- A method to focus a window by its title and class. This method iterates through the open windows and activates the one that matches the given title and class.
 
 ## [KWin Integration 0.1.0](https://github.com/kando-menu/kwin-integration/releases/tag/v0.1.0)
 

src/dbus/KandoIntegrationAdaptor.cpp

@@ -17,4 +17,13 @@ KandoIntegrationAdaptor::KandoIntegrationAdaptor(KandoKWinIntegrationPlugin* plu
 
 QVariantMap KandoIntegrationAdaptor::GetWMInfo() const { return mPlugin->getWMInfo(); }
 
+QVariantList KandoIntegrationAdaptor::GetOpenWindows() const {
+  return mPlugin->getOpenWindows();
+}
+
+bool KandoIntegrationAdaptor::FocusWindow(const QString& windowName,
+                                          const QString& appName) const {
+  return mPlugin->focusWindow(windowName, appName);
+}
+
 QString KandoIntegrationAdaptor::Ping() const { return QStringLiteral("pong"); }

src/dbus/KandoIntegrationAdaptor.h

@@ -12,6 +12,8 @@
 
 #include <QDBusAbstractAdaptor>
 #include <QObject>
+#include <QString>
+#include <QVariantList>
 #include <QVariantMap>
 
 class KandoKWinIntegrationPlugin;
@@ -25,6 +27,8 @@ class KandoIntegrationAdaptor : public QDBusAbstractAdaptor {
 
  public Q_SLOTS:
   QVariantMap GetWMInfo() const;
+  QVariantList GetOpenWindows() const;
+  bool FocusWindow(const QString& windowName, const QString& appName) const;
   QString Ping() const;
 
  private:

src/plugin/KandoKWinIntegrationPlugin.cpp

@@ -11,6 +11,7 @@
 #include "KandoKWinIntegrationPlugin.h"
 
 #include <effect/effecthandler.h>
+#include <effect/effectwindow.h>
 
 #include <QDBusConnection>
 #include <QDBusError>
@@ -69,3 +70,46 @@ QVariantMap KandoKWinIntegrationPlugin::getWMInfo() const {
     {QStringLiteral("workAreaHeight"), qRound(workArea.height())},
   };
 }
+
+QVariantList KandoKWinIntegrationPlugin::getOpenWindows() const {
+  QVariantList windows;
+
+  for (const auto* window : KWin::effects->stackingOrder()) {
+    if (!window || window->isDeleted() || !window->isManaged() ||
+        window->isSpecialWindow() || window->isSkipSwitcher()) {
+      continue;
+    }
+
+    const auto windowName = window->caption();
+    const auto appName    = window->windowClass();
+
+    if (windowName.isEmpty() && appName.isEmpty()) {
+      continue;
+    }
+
+    windows.push_back(QVariantList{windowName, appName});
+  }
+
+  return windows;
+}
+
+bool KandoKWinIntegrationPlugin::focusWindow(const QString& windowName,
+                                             const QString& appName) const {
+  const auto windows = KWin::effects->stackingOrder();
+
+  // Iterate top-most first so we focus the window the user most likely expects.
+  for (auto it = windows.rbegin(); it != windows.rend(); ++it) {
+    auto* window = *it;
+
+    if (!window || window->isDeleted() || !window->isManaged()) {
+      continue;
+    }
+
+    if (window->caption() == windowName && window->windowClass() == appName) {
+      KWin::effects->activateWindow(window);
+      return true;
+    }
+  }
+
+  return false;
+}

src/plugin/KandoKWinIntegrationPlugin.h

@@ -12,6 +12,7 @@
 
 #include <effect/effect.h>
 
+#include <QVariantList>
 #include <QVariantMap>
 
 #include "input/PointerInput.h"
@@ -26,6 +27,8 @@ class KandoKWinIntegrationPlugin : public KWin::Effect {
   ~KandoKWinIntegrationPlugin() override;
 
   QVariantMap getWMInfo() const;
+  QVariantList getOpenWindows() const;
+  bool focusWindow(const QString& windowName, const QString& appName) const;
 
  private:
   KandoIntegrationAdaptor* mAdaptor;