Update org.gnome.shell.extensions.simple-tiling.domoel.gschema.xml

.gitignore

@@ -0,0 +1,6 @@
+# GNOME Shell Extension specific
+schemas/gschemas.compiled
+
+# Common temporary files
+*~
+*.swp

README.md

@@ -1,11 +1,17 @@
-# Simple Tiling
+
+<h1 align="center">
+Simple Tiling 
+</span>
+<h4 align="center">
+<span style="display:inline-flex; align-items:center; gap:12px;">
+A lightweight, opinionated, and automatic tiling window manager for GNOME Shell 3.38.
+</span>
+<p>
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 ![GNOME Shell Version](https://img.shields.io/badge/GNOME%20Shell-3.38-blue)
 
-A lightweight, opinionated, and automatic tiling window manager for GNOME Shell 3.38.
-
-<img width="2560" height="1440" alt="Simple-Tiling" src="https://github.com/user-attachments/assets/18fcbb34-3e0e-45b8-abe1-0e752b8d970c" />
+<img width="2560" height="1440" alt="Simple Tiling v4" src="https://github.com/user-attachments/assets/b080483e-40fe-4ea2-b0dd-56fcb587f9b8" />
 
 ## Introduction
 
@@ -17,13 +23,16 @@ This extension was built from the ground up to be stable and performant on **GNO
 
 * **Automatic Tiling:** Windows are automatically arranged into a master and stack layout without any manual intervention.
 * **Master & Fibonacci Stack Layout:** The first window becomes the "master," occupying the left half of the screen. All subsequent windows form a "stack" on the right half, which is tiled using a space-efficient Fibonacci-style algorithm.
+* **Configurable New Window Behavior:** Choose whether new windows open as the new master or are appended to the end of the stack.
 * **Tiling Lock:** The layout is strict by default. If you manually move a window with the mouse and drop it in an empty space, it will automatically "snap back" to its designated tile position, preserving the integrity of the layout.
 * **Interactive Window Swapping:**
     * **Drag & Drop:** Swap any two windows by simply dragging one and dropping it over the other.
     * **Keyboard Shortcuts:** A full set of keyboard shortcuts allows you to swap the focused window with the master or with its nearest neighbor in any direction (left, right, up, down).
-* **Configurable Gaps:** Easily configure inner and outer gaps by editing variables directly in the `extension.js` code to achieve your desired aesthetic.
+* **Interactive Window Focus Switcher:** Change the current window focus with a set of customizable keyboard shortcuts in every direction.
+* **Simple Settings Panel:** A simple settings panel within the gnome extension manager menu to adjust key bindings and window gaps / margins.
 * **External Exception List:** Use a simple `exceptions.txt` file to list applications (by their `WM_CLASS`) that should be ignored by the tiling manager.
 * **Smart Pop-up Handling:** Windows on the exception list, as well as dialogs and other pop-ups, are automatically centered and kept "always on top" for a smooth workflow.
+* **Configurable Tiling Window Delays:** Easily configure the tiling window delays if you have race condition issues by editing variables directly in the `extension.js`.
 
 ## Requirements
 
@@ -57,7 +66,7 @@ Use the [GNOME Shell Extensions website](https://extensions.gnome.org/extension/
 
 #### Keyboard Shortcuts
 
-All keyboard shortcuts can be configured through the standard GNOME Settings panel:
+All keyboard shortcuts can be configured through the Settings panel of Simple Tiling (which can be found in the Gnome Extesion Application):
 1.  Open **Settings**.
 2.  Navigate to **Keyboard** -> **View and Customize Shortcuts**.
 3.  Scroll down to the **Custom Shortcuts** section at the bottom.
@@ -74,3 +83,30 @@ To prevent an application from being tiled, you can add its `WM_CLASS` to the `e
 To find an application's `WM_CLASS`, open a terminal and run the command `xprop WM_CLASS`. Your cursor will turn into a crosshair. Click on the window of the application you want to exclude. 
 
 An Example of an exceptions.txt can be found in the repo.
+
+Ignored applications will be opened screen centered and kept above all other windows. These applications can be moved across the screen in floating mode.
+
+#### Adjusting inner and/or outer Window Gaps / Margins
+
+You can adjust the window gap margins (inner gaps between windows, outer gaps horizontal as well as vertical) in the Settings panel of Simple Tiling (which can be found in the Gnome Extension Application).
+
+#### Configurable New Window Behavior
+
+A toogle setting allows you to control the behavior for newly opened windows. You can choose to either have them become the new master window (pushing the old master into the stack) or have them appended to the stack as the last window (Default).
+
+#### Adjusting Tiling Window Delays
+
+If you have race condition issues between mutter (Gnome WM) and the Simple Tiling extension, you can adjust the window delay settings (both for tiling windows as well as for centered application from the exceptions list) directly in the extensions.js (~/.local/share/gnome-shell/extensions/simple-tiling@domoel/extension.js). You will find the parameter at line 17 & 18. Defaults to "20" for General Tiling Window Delay and "5" for centered Apps on the Exception List.
+
+## Future Development
+
+This extension was built to solve a specific need. However, future enhancements could include:
+* Multi-monitor support.
+* Support for newer Gnome shells
+* Additional layout algorithms.
+* A more detailed settings panel to configure other options via a GUI.
+
+## License
+
+This project is licensed under the MIT License - see the `LICENSE` file for details.
+

extension.js

@@ -1,9 +1,11 @@
-// Simple-Tiling – GNOME Shell 3.38 (X11) - Version 1.0
-// Features: Fibonacci-Stack-Layout (50/50) · Tiling-Lock · Drag- & Keyboard-Swap
-// Pop-ups: zentriert + Always-on-Top + Exception-List
-// © 2025 domoel – MIT
+// ---------------------------------------------------- //
+// Simple-Tiling – GNOME Shell 3.38 (X11) - Version 4   //
+// © 2025 domoel – MIT                                  //
+// ---------------------------------------------------- //
 
-// Global Imports
+// ---------------------------------------------------- //
+// Global Imports                                       //
+// ---------------------------------------------------- //
 const Main = imports.ui.main;
 const Meta = imports.gi.Meta;
 const Shell = imports.gi.Shell;
@@ -12,13 +14,29 @@ const Gio = imports.gi.Gio;
 const GLib = imports.gi.GLib;
 const ExtensionUtils = imports.misc.extensionUtils;
 const ByteArray = imports.byteArray;
+const TILING_DELAY_MS = 20; // Change Tiling Window Delay
+const CENTERING_DELAY_MS = 5; // Change Centered Window Delay
 
 const Me = ExtensionUtils.getCurrentExtension();
-const SCHEMA_NAME = 'org.gnome.shell.extensions.simple-tiling.domoel';
-const WM_SCHEMA = 'org.gnome.desktop.wm.keybindings';
+const SCHEMA_NAME = "org.gnome.shell.extensions.simple-tiling.domoel";
+const WM_SCHEMA = "org.gnome.desktop.wm.keybindings";
 
-// InteractionHandler
-// Verwaltung aller Nutzerinteraktionen (Maus & Tastatur)
+const KEYBINDINGS = {
+    "swap-master-window": (self) => self._swapWithMaster(),
+    "swap-left-window":   (self) => self._swapInDirection("left"),
+    "swap-right-window":  (self) => self._swapInDirection("right"),
+    "swap-up-window":     (self) => self._swapInDirection("up"),
+    "swap-down-window":   (self) => self._swapInDirection("down"),
+
+    "focus-left":         (self) => self._focusInDirection("left"),
+    "focus-right":        (self) => self._focusInDirection("right"),
+    "focus-up":           (self) => self._focusInDirection("up"),
+    "focus-down":         (self) => self._focusInDirection("down"),
+};
+
+// ---------------------------------------------------- //
+// InteractionHandler                                   //
+// ---------------------------------------------------- //
 class InteractionHandler {
     constructor(tiler) {
         this.tiler = tiler;
@@ -28,70 +46,103 @@ class InteractionHandler {
         this._savedWmShortcuts = {};
         this._grabOpIds = [];
         this._settingsChangedId = null;
-
         this._onSettingsChanged = this._onSettingsChanged.bind(this);
         this._prepareWmShortcuts();
     }
 
     enable() {
         if (this._wmKeysToDisable.length) {
-            this._wmKeysToDisable.forEach(key => this._wmSettings.set_value(key, new GLib.Variant('as', [])));
+            this._wmKeysToDisable.forEach((key) =>
+                this._wmSettings.set_value(key, new GLib.Variant("as", []))
+            );
         }
         this._bindAllShortcuts();
-        this._settingsChangedId = this._settings.connect('changed', this._onSettingsChanged);
-        this._grabOpIds.push(global.display.connect('grab-op-begin', (display, screen, window) => {
-            if (this.tiler.windows.includes(window)) { this.tiler.grabbedWindow = window; }
-        }));
-        this._grabOpIds.push(global.display.connect('grab-op-end', this._onGrabEnd.bind(this)));
+        this._settingsChangedId = this._settings.connect(
+            "changed",
+            this._onSettingsChanged
+        );
+        this._grabOpIds.push(
+            global.display.connect(
+                "grab-op-begin",
+                (display, screen, window) => {
+                    if (this.tiler.windows.includes(window)) {
+                        this.tiler.grabbedWindow = window;
+                    }
+                }
+            )
+        );
+        this._grabOpIds.push(
+            global.display.connect("grab-op-end", this._onGrabEnd.bind(this))
+        );
     }
 
     disable() {
         if (this._wmKeysToDisable.length) {
-            this._wmKeysToDisable.forEach(key => this._wmSettings.set_value(key, this._savedWmShortcuts[key]));
+            this._wmKeysToDisable.forEach((key) =>
+                this._wmSettings.set_value(key, this._savedWmShortcuts[key])
+            );
         }
         this._unbindAllShortcuts();
         if (this._settingsChangedId) {
             this._settings.disconnect(this._settingsChangedId);
             this._settingsChangedId = null;
         }
-        this._grabOpIds.forEach(id => global.display.disconnect(id));
+        this._grabOpIds.forEach((id) => global.display.disconnect(id));
     }
 
-    _bind(key, callback) {
-        Main.wm.addKeybinding(key, this._settings, Meta.KeyBindingFlags.NONE, Shell.ActionMode.NORMAL, callback.bind(this));
-    }
+   _bind(key, callback) {
+       Main.wm.addKeybinding(key, this._settings, Meta.KeyBindingFlags.NONE, Shell.ActionMode.NORMAL,
+           () => callback(this));
+   }
 
-    _bindAllShortcuts() {
-        this._bind('swap-master-window', this._swapWithMaster);
-        this._bind('swap-left-window', () => this._swapInDirection('left'));
-        this._bind('swap-right-window', () => this._swapInDirection('right'));
-        this._bind('swap-up-window', () => this._swapInDirection('up'));
-        this._bind('swap-down-window', () => this._swapInDirection('down'));
-    }
-
-    _unbindAllShortcuts() {
-        ['swap-master-window', 'swap-left-window', 'swap-right-window', 'swap-up-window', 'swap-down-window']
-            .forEach(key => Main.wm.removeKeybinding(key));
-    }
+   _bindAllShortcuts() {
+       for (const [key, handler] of Object.entries(KEYBINDINGS)) {
+           this._bind(key, handler);
+       }
+   }
+   _unbindAllShortcuts() {
+       for (const key in KEYBINDINGS) {
+           Main.wm.removeKeybinding(key);
+       }
+   }
 
     _onSettingsChanged() {
         this._unbindAllShortcuts();
         this._bindAllShortcuts();
     }
-
     _prepareWmShortcuts() {
         const schema = this._wmSettings.settings_schema;
         const keys = [];
-        if (schema.has_key('toggle-tiled-left')) keys.push('toggle-tiled-left', 'toggle-tiled-right');
-        else if (schema.has_key('tile-left')) keys.push('tile-left', 'tile-right');
-        if (schema.has_key('toggle-maximized')) keys.push('toggle-maximized');
+        if (schema.has_key("toggle-tiled-left"))
+            keys.push("toggle-tiled-left", "toggle-tiled-right");
+        else if (schema.has_key("tile-left"))
+            keys.push("tile-left", "tile-right");
+        if (schema.has_key("toggle-maximized")) keys.push("toggle-maximized");
         else {
-            if (schema.has_key('maximize')) keys.push('maximize');
-            if (schema.has_key('unmaximize')) keys.push('unmaximize');
+            if (schema.has_key("maximize")) keys.push("maximize");
+            if (schema.has_key("unmaximize")) keys.push("unmaximize");
         }
         if (keys.length) {
             this._wmKeysToDisable = keys;
-            keys.forEach(key => this._savedWmShortcuts[key] = this.tiler.wmSettings.get_value(key));
+            keys.forEach(
+                (key) =>
+                    (this._savedWmShortcuts[
+                        key
+                    ] = this._wmSettings.get_value(key))
+            );
+        }
+    }
+
+    _focusInDirection(direction) {
+        const sourceWindow = global.display.get_focus_window();
+        if (!sourceWindow || !this.tiler.windows.includes(sourceWindow)) return;
+
+        const targetWindow = this._findTargetInDirection(
+            sourceWindow,
+            direction
+        );
+        if (targetWindow) {
+            targetWindow.activate(global.get_current_time());
         }
     }
 
@@ -102,7 +153,10 @@ class InteractionHandler {
         if (!focusedWindow || !windows.includes(focusedWindow)) return;
         const focusedIndex = windows.indexOf(focusedWindow);
         if (focusedIndex > 0) {
-            [windows[0], windows[focusedIndex]] = [windows[focusedIndex], windows[0]];
+            [windows[0], windows[focusedIndex]] = [
+                windows[focusedIndex],
+                windows[0],
+            ];
         } else if (focusedIndex === 0) {
             [windows[0], windows[1]] = [windows[1], windows[0]];
         }
@@ -115,14 +169,21 @@ class InteractionHandler {
         if (!sourceWindow || !this.tiler.windows.includes(sourceWindow)) return;
         let targetWindow = null;
         const sourceIndex = this.tiler.windows.indexOf(sourceWindow);
-        if (sourceIndex === 0 && direction === 'right' && this.tiler.windows.length > 1) {
+        if (
+            sourceIndex === 0 &&
+            direction === "right" &&
+            this.tiler.windows.length > 1
+        ) {
             targetWindow = this.tiler.windows[1];
         } else {
             targetWindow = this._findTargetInDirection(sourceWindow, direction);
         }
         if (!targetWindow) return;
         const targetIndex = this.tiler.windows.indexOf(targetWindow);
-        [this.tiler.windows[sourceIndex], this.tiler.windows[targetIndex]] = [this.tiler.windows[targetIndex], this.tiler.windows[sourceIndex]];
+        [this.tiler.windows[sourceIndex], this.tiler.windows[targetIndex]] = [
+            this.tiler.windows[targetIndex],
+            this.tiler.windows[sourceIndex],
+        ];
         this.tiler.tileNow();
         sourceWindow.activate(global.get_current_time());
     }
@@ -134,10 +195,18 @@ class InteractionHandler {
             if (win === source) continue;
             const targetRect = win.get_frame_rect();
             switch (direction) {
-                case 'left':  if (targetRect.x < sourceRect.x) candidates.push(win); break;
-                case 'right': if (targetRect.x > sourceRect.x) candidates.push(win); break;
-                case 'up':    if (targetRect.y < sourceRect.y) candidates.push(win); break;
-                case 'down':  if (targetRect.y > sourceRect.y) candidates.push(win); break;
+                case "left":
+                    if (targetRect.x < sourceRect.x) candidates.push(win);
+                    break;
+                case "right":
+                    if (targetRect.x > sourceRect.x) candidates.push(win);
+                    break;
+                case "up":
+                    if (targetRect.y < sourceRect.y) candidates.push(win);
+                    break;
+                case "down":
+                    if (targetRect.y > sourceRect.y) candidates.push(win);
+                    break;
             }
         }
         if (candidates.length === 0) return null;
@@ -146,7 +215,7 @@ class InteractionHandler {
         for (const win of candidates) {
             const targetRect = win.get_frame_rect();
             let deviation;
-            if (direction === 'left' || direction === 'right') {
+            if (direction === "left" || direction === "right") {
                 deviation = Math.abs(sourceRect.y - targetRect.y);
             } else {
                 deviation = Math.abs(sourceRect.x - targetRect.x);
@@ -166,7 +235,13 @@ class InteractionHandler {
         if (targetWindow) {
             const sourceIndex = this.tiler.windows.indexOf(grabbedWindow);
             const targetIndex = this.tiler.windows.indexOf(targetWindow);
-            [this.tiler.windows[sourceIndex], this.tiler.windows[targetIndex]] = [this.tiler.windows[targetIndex], this.tiler.windows[sourceIndex]];
+            [
+                this.tiler.windows[sourceIndex],
+                this.tiler.windows[targetIndex],
+            ] = [
+                this.tiler.windows[targetIndex],
+                this.tiler.windows[sourceIndex],
+            ];
         }
         this.tiler.queueTile();
         this.tiler.grabbedWindow = null;
@@ -174,13 +249,27 @@ class InteractionHandler {
 
     _findTargetUnderPointer(excludeWindow) {
         let [pointerX, pointerY] = global.get_pointer();
-        let windows = global.get_window_actors().map(actor => actor.meta_window).filter(win => {
-            if (!win || win === excludeWindow || !this.tiler.windows.includes(win)) return false;
-            let frame = win.get_frame_rect();
-            return pointerX >= frame.x && pointerX < frame.x + frame.width &&
-                   pointerY >= frame.y && pointerY < frame.y + frame.height;
-        });
-        if (windows.length > 0) { return windows[windows.length - 1]; }
+        let windows = global
+            .get_window_actors()
+            .map((actor) => actor.meta_window)
+            .filter((win) => {
+                if (
+                    !win ||
+                    win === excludeWindow ||
+                    !this.tiler.windows.includes(win)
+                )
+                    return false;
+                let frame = win.get_frame_rect();
+                return (
+                    pointerX >= frame.x &&
+                    pointerX < frame.x + frame.width &&
+                    pointerY >= frame.y &&
+                    pointerY < frame.y + frame.height
+                );
+            });
+        if (windows.length > 0) {
+            return windows[windows.length - 1];
+        }
 
         let bestTarget = null;
         let maxOverlap = 0;
@@ -188,8 +277,20 @@ class InteractionHandler {
         for (const win of this.tiler.windows) {
             if (win === excludeWindow) continue;
             const targetFrame = win.get_frame_rect();
-            const overlapX = Math.max(0, Math.min(sourceFrame.x + sourceFrame.width, targetFrame.x + targetFrame.width) - Math.max(sourceFrame.x, targetFrame.x));
-            const overlapY = Math.max(0, Math.min(sourceFrame.y + sourceFrame.height, targetFrame.y + targetFrame.height) - Math.max(sourceFrame.y, targetFrame.y));
+            const overlapX = Math.max(
+                0,
+                Math.min(
+                    sourceFrame.x + sourceFrame.width,
+                    targetFrame.x + targetFrame.width
+                ) - Math.max(sourceFrame.x, targetFrame.x)
+            );
+            const overlapY = Math.max(
+                0,
+                Math.min(
+                    sourceFrame.y + sourceFrame.height,
+                    targetFrame.y + targetFrame.height
+                ) - Math.max(sourceFrame.y, targetFrame.y)
+            );
             const overlapArea = overlapX * overlapY;
             if (overlapArea > maxOverlap) {
                 maxOverlap = overlapArea;
@@ -200,84 +301,134 @@ class InteractionHandler {
     }
 }
 
-
-// Tiler
-// Die Hauptklasse für die Tiling-Logik.
+// ---------------------------------------------------- //
+// Tiler                                                //
+// Main Classes for Tiling Logic                        //
+// ---------------------------------------------------- //
 class Tiler {
     constructor() {
         this.windows = [];
         this.grabbedWindow = null;
-        this.wmSettings = new Gio.Settings({ schema: WM_SCHEMA });
+        this._settings = ExtensionUtils.getSettings(SCHEMA_NAME);
         this._signalIds = new Map();
         this._tileInProgress = false;
 
-        // Layout-Konfiguration
-        this._innerGap = 10;
-        this._outerGapVertical = 5;
-        this._outerGapHorizontal = 10;
+        this._innerGap = this._settings.get_int("inner-gap");
+        this._outerGapVertical = this._settings.get_int("outer-gap-vertical");
+        this._outerGapHorizontal = this._settings.get_int(
+            "outer-gap-horizontal"
+        );
 
-        // Delay-Zeiten für das Tiling und Exception Windows
-        this._tilingDelay = 20;
-        this._centeringDelay = 5;
+        this._tilingDelay = TILING_DELAY_MS;
+        this._centeringDelay = CENTERING_DELAY_MS;
 
         this._exceptions = [];
         this._interactionHandler = new InteractionHandler(this);
 
         this._onWindowAdded = this._onWindowAdded.bind(this);
         this._onWindowRemoved = this._onWindowRemoved.bind(this);
-        this._onActiveWorkspaceChanged = this._onActiveWorkspaceChanged.bind(this);
-        this._onWindowMinimizedStateChanged = this._onWindowMinimizedStateChanged.bind(this);
+        this._onActiveWorkspaceChanged = this._onActiveWorkspaceChanged.bind(
+            this
+        );
+        this._onWindowMinimizedStateChanged = this._onWindowMinimizedStateChanged.bind(
+            this
+        );
+        this._onSettingsChanged = this._onSettingsChanged.bind(this);
     }
 
     enable() {
         this._loadExceptions();
         const workspaceManager = global.workspace_manager;
-        this._signalIds.set('workspace-changed', { object: workspaceManager, id: workspaceManager.connect('active-workspace-changed', this._onActiveWorkspaceChanged) });
+        this._signalIds.set("workspace-changed", {
+            object: workspaceManager,
+            id: workspaceManager.connect(
+                "active-workspace-changed",
+                this._onActiveWorkspaceChanged
+            ),
+        });
         this._connectToWorkspace();
         this._interactionHandler.enable();
+        this._signalIds.set("settings-changed", {
+            object: this._settings,
+            id: this._settings.connect("changed", this._onSettingsChanged),
+        });
     }
 
     disable() {
         this._interactionHandler.disable();
         this._disconnectFromWorkspace();
         for (const [, signal] of this._signalIds) {
-            try { signal.object.disconnect(signal.id); } catch(e) {}
+            try {
+                signal.object.disconnect(signal.id);
+            } catch (e) {}
         }
         this._signalIds.clear();
         this.windows = [];
     }
 
+    _onSettingsChanged() {
+        this._innerGap = this._settings.get_int("inner-gap");
+        this._outerGapVertical = this._settings.get_int("outer-gap-vertical");
+        this._outerGapHorizontal = this._settings.get_int(
+            "outer-gap-horizontal"
+        );
+        this.queueTile();
+    }
+
     _loadExceptions() {
-        const file = Gio.file_new_for_path(Me.path + '/exceptions.txt');
-        if (!file.query_exists(null)) { this._exceptions = []; return; }
+        const file = Gio.file_new_for_path(Me.path + "/exceptions.txt");
+        if (!file.query_exists(null)) {
+            this._exceptions = [];
+            return;
+        }
         const [ok, data] = file.load_contents(null);
-        this._exceptions = ok ? ByteArray.toString(data).split('\n')
-            .map(l => l.trim()).filter(l => l && !l.startsWith('#'))
-            .map(l => l.toLowerCase()) : [];
+        this._exceptions = ok
+            ? ByteArray.toString(data)
+                  .split("\n")
+                  .map((l) => l.trim())
+                  .filter((l) => l && !l.startsWith("#"))
+                  .map((l) => l.toLowerCase())
+            : [];
     }
 
     _isException(win) {
-        return !!win && this._exceptions.includes((win.get_wm_class() || '').toLowerCase());
+        return (
+            !!win &&
+            this._exceptions.includes((win.get_wm_class() || "").toLowerCase())
+        );
     }
 
     _isTileable(win) {
-        return win && !win.minimized && !this._isException(win) && win.get_window_type() === Meta.WindowType.NORMAL;
+        return (
+            win &&
+            !win.minimized &&
+            !this._isException(win) &&
+            win.get_window_type() === Meta.WindowType.NORMAL
+        );
     }
 
     _centerWindow(win) {
         Mainloop.timeout_add(this._centeringDelay, () => {
             if (!win || !win.get_display()) return GLib.SOURCE_REMOVE;
-            if (win.get_maximized()) { win.unmaximize(Meta.MaximizeFlags.BOTH); }
+            if (win.get_maximized()) {
+                win.unmaximize(Meta.MaximizeFlags.BOTH);
+            }
             const monitorIndex = win.get_monitor();
-            const workArea = Main.layoutManager.getWorkAreaForMonitor(monitorIndex);
+            const workArea = Main.layoutManager.getWorkAreaForMonitor(
+                monitorIndex
+            );
             const frame = win.get_frame_rect();
-            win.move_frame(true,
+            win.move_frame(
+                true,
                 workArea.x + Math.floor((workArea.width - frame.width) / 2),
-                workArea.y + Math.floor((workArea.height - frame.height) / 2));
+                workArea.y + Math.floor((workArea.height - frame.height) / 2)
+            );
             Mainloop.idle_add(() => {
                 if (win.get_display()) {
-                    if (typeof win.set_keep_above === 'function') win.set_keep_above(true);
-                    else if (typeof win.make_above === 'function') win.make_above();
+                    if (typeof win.set_keep_above === "function")
+                        win.set_keep_above(true);
+                    else if (typeof win.make_above === "function")
+                        win.make_above();
                 }
                 return GLib.SOURCE_REMOVE;
             });
@@ -298,11 +449,33 @@ class Tiler {
         }
 
         if (this._isTileable(win)) {
-            this.windows.push(win);
+            if (this._settings.get_string("new-window-behavior") === "master") {
+                this.windows.unshift(win);
+            } else {
+                this.windows.push(win);
+            }
+
             const id = win.get_id();
-            this._signalIds.set(`unmanaged-${id}`, { object: win, id: win.connect('unmanaged', () => this._onWindowRemoved(null, win)) });
-            this._signalIds.set(`size-changed-${id}`, { object: win, id: win.connect('size-changed', () => { if (!this.grabbedWindow) this.queueTile(); }) });
-            this._signalIds.set(`minimized-${id}`, { object: win, id: win.connect('notify::minimized', this._onWindowMinimizedStateChanged) });
+            this._signalIds.set(`unmanaged-${id}`, {
+                object: win,
+                id: win.connect("unmanaged", () =>
+                    this._onWindowRemoved(null, win)
+                ),
+            });
+            this._signalIds.set(`size-changed-${id}`, {
+                object: win,
+                id: win.connect("size-changed", () => {
+                    if (!this.grabbedWindow) this.queueTile();
+                }),
+            });
+            this._signalIds.set(`minimized-${id}`, {
+                object: win,
+                id: win.connect(
+                    "notify::minimized",
+                    this._onWindowMinimizedStateChanged
+                ),
+            });
+
             this.queueTile();
         }
     }
@@ -313,11 +486,13 @@ class Tiler {
             this.windows.splice(index, 1);
         }
 
-        ['unmanaged', 'size-changed', 'minimized'].forEach(prefix => {
+        ["unmanaged", "size-changed", "minimized"].forEach((prefix) => {
             const key = `${prefix}-${win.get_id()}`;
             if (this._signalIds.has(key)) {
                 const { object, id } = this._signalIds.get(key);
-                try { object.disconnect(id); } catch(e) {}
+                try {
+                    object.disconnect(id);
+                } catch (e) {}
                 this._signalIds.delete(key);
             }
         });
@@ -331,19 +506,29 @@ class Tiler {
 
     _connectToWorkspace() {
         const workspace = global.workspace_manager.get_active_workspace();
-        workspace.list_windows().forEach(win => this._onWindowAdded(workspace, win));
-        this._signalIds.set('window-added', { object: workspace, id: workspace.connect('window-added', this._onWindowAdded) });
-        this._signalIds.set('window-removed', { object: workspace, id: workspace.connect('window-removed', this._onWindowRemoved) });
+        workspace
+            .list_windows()
+            .forEach((win) => this._onWindowAdded(workspace, win));
+        this._signalIds.set("window-added", {
+            object: workspace,
+            id: workspace.connect("window-added", this._onWindowAdded),
+        });
+        this._signalIds.set("window-removed", {
+            object: workspace,
+            id: workspace.connect("window-removed", this._onWindowRemoved),
+        });
         this.queueTile();
     }
 
     _disconnectFromWorkspace() {
-        this.windows.slice().forEach(win => this._onWindowRemoved(null, win));
+        this.windows.slice().forEach((win) => this._onWindowRemoved(null, win));
 
-        ['window-added', 'window-removed'].forEach(key => {
+        ["window-added", "window-removed"].forEach((key) => {
             if (this._signalIds.has(key)) {
                 const { object, id } = this._signalIds.get(key);
-                try { object.disconnect(id); } catch(e) {}
+                try {
+                    object.disconnect(id);
+                } catch (e) {}
                 this._signalIds.delete(key);
             }
         });
@@ -368,7 +553,13 @@ class Tiler {
     _splitLayout(windows, area) {
         if (windows.length === 0) return;
         if (windows.length === 1) {
-            windows[0].move_resize_frame(true, area.x, area.y, area.width, area.height);
+            windows[0].move_resize_frame(
+                true,
+                area.x,
+                area.y,
+                area.width,
+                area.height
+            );
             return;
         }
 
@@ -379,12 +570,32 @@ class Tiler {
 
         if (area.width > area.height) {
             const primaryWidth = Math.floor(area.width / 2) - gap;
-            primaryArea = { x: area.x, y: area.y, width: primaryWidth, height: area.height };
-            secondaryArea = { x: area.x + primaryWidth + this._innerGap, y: area.y, width: area.width - primaryWidth - this._innerGap, height: area.height };
+            primaryArea = {
+                x: area.x,
+                y: area.y,
+                width: primaryWidth,
+                height: area.height,
+            };
+            secondaryArea = {
+                x: area.x + primaryWidth + this._innerGap,
+                y: area.y,
+                width: area.width - primaryWidth - this._innerGap,
+                height: area.height,
+            };
         } else {
             const primaryHeight = Math.floor(area.height / 2) - gap;
-            primaryArea = { x: area.x, y: area.y, width: area.width, height: primaryHeight };
-            secondaryArea = { x: area.x, y: area.y + primaryHeight + this._innerGap, width: area.width, height: area.height - primaryHeight - this._innerGap };
+            primaryArea = {
+                x: area.x,
+                y: area.y,
+                width: area.width,
+                height: primaryHeight,
+            };
+            secondaryArea = {
+                x: area.x,
+                y: area.y + primaryHeight + this._innerGap,
+                width: area.width,
+                height: area.height - primaryHeight - this._innerGap,
+            };
         }
 
         this._splitLayout(primaryWindows, primaryArea);
@@ -392,39 +603,57 @@ class Tiler {
     }
 
     _tileWindows() {
-        const windowsToTile = this.windows.filter(win => !win.minimized);
+        const windowsToTile = this.windows.filter((win) => !win.minimized);
         if (windowsToTile.length === 0) return;
         const monitor = Main.layoutManager.primaryMonitor;
-        const workArea = Main.layoutManager.getWorkAreaForMonitor(monitor.index);
+        const workArea = Main.layoutManager.getWorkAreaForMonitor(
+            monitor.index
+        );
         const innerArea = {
             x: workArea.x + this._outerGapHorizontal,
             y: workArea.y + this._outerGapVertical,
             width: workArea.width - 2 * this._outerGapHorizontal,
-            height: workArea.height - 2 * this._outerGapVertical
+            height: workArea.height - 2 * this._outerGapVertical,
         };
 
-        windowsToTile.forEach(win => { if (win.get_maximized()) win.unmaximize(Meta.MaximizeFlags.BOTH); });
+        windowsToTile.forEach((win) => {
+            if (win.get_maximized()) win.unmaximize(Meta.MaximizeFlags.BOTH);
+        });
 
         if (windowsToTile.length === 1) {
-            windowsToTile[0].move_resize_frame(true, innerArea.x, innerArea.y, innerArea.width, innerArea.height);
+            windowsToTile[0].move_resize_frame(
+                true,
+                innerArea.x,
+                innerArea.y,
+                innerArea.width,
+                innerArea.height
+            );
             return;
         }
 
         const gap = Math.floor(this._innerGap / 2);
         const masterWidth = Math.floor(innerArea.width / 2) - gap;
         const master = windowsToTile[0];
-        master.move_resize_frame(true, innerArea.x, innerArea.y, masterWidth, innerArea.height);
+        master.move_resize_frame(
+            true,
+            innerArea.x,
+            innerArea.y,
+            masterWidth,
+            innerArea.height
+        );
         const stackArea = {
             x: innerArea.x + masterWidth + this._innerGap,
             y: innerArea.y,
             width: innerArea.width - masterWidth - this._innerGap,
-            height: innerArea.height
+            height: innerArea.height,
         };
         this._splitLayout(windowsToTile.slice(1), stackArea);
     }
 }
 
-// Extension Wrapper
+// ---------------------------------------------------- //
+// Extension Wrapper                                    //
+// ---------------------------------------------------- //
 class SimpleTilingExtension {
     constructor() {
         this.tiler = null;

metadata.json

@@ -2,7 +2,7 @@
   "uuid": "simple-tiling@domoel",
   "name": "Simple Tiling",
   "description": "A Simple Tiling Extension for Gnome Shell 3.38.",
-  "version": 1,
+  "version": 4,
   "shell-version": [ "3.38" ],
   "settings-schema": "org.gnome.shell.extensions.simple-tiling.domoel",
   "preferences_ui": "prefs.js",

prefs.js

@@ -1,108 +1,271 @@
-// Settings Menu for Simple-Tiling
+// ------------------------------------------------------ //
+// Extension Settings Menu for Simple Tiling - Version 4  //
+// © 2025 domoel – MIT                                    //
+// ------------------------------------------------------ //
 
-'use strict';
+// ---------------------------------------------------- //
+// Global Imports                                       //
+// ---------------------------------------------------- //
+"use strict";
 
-const { Gtk, GObject } = imports.gi;
+const { Gtk, GObject, Gio } = imports.gi;
 const ExtensionUtils = imports.misc.extensionUtils;
 
-const COLUMN_ID = 0;       // z.B. 'swap-master-window'
-const COLUMN_DESC = 1;     // z.B. 'Master-Fenster tauschen'
-const COLUMN_KEY = 2;      // Der Key-Code (eine Zahl)
-const COLUMN_MODS = 3;     // Die Modifier-Maske (eine Zahl)
+const SCHEMA_NAME = "org.gnome.shell.extensions.simple-tiling.domoel";
+
+// ---------------------------------------------------- //
+// Definition of Row Model                              //
+// ---------------------------------------------------- //
+const COLUMN_ID = 0;
+const COLUMN_DESC = 1;
+const COLUMN_KEY = 2;
+const COLUMN_MODS = 3;
 
 function init() {}
 
 function buildPrefsWidget() {
-    const settings = ExtensionUtils.getSettings('org.gnome.shell.extensions.simple-tiling.domoel');
+    const settings = ExtensionUtils.getSettings(SCHEMA_NAME);
 
     const prefsWidget = new Gtk.Box({
         orientation: Gtk.Orientation.VERTICAL,
-        margin: 20,
-        spacing: 12,
-        visible: true
+        margin_top: 20,
+        margin_bottom: 20,
+        margin_start: 20,
+        margin_end: 20,
+        spacing: 18,
+        visible: true,
     });
 
-    const title = new Gtk.Label({
-        label: '<b>Tastenkürzel für Simple-Tiling</b>',
+    // ---------------------------------------------------- //
+    // Section for Keybindings                              //
+    // ---------------------------------------------------- //
+    const keysTitle = new Gtk.Label({
+        label: "<b>Tastenkürzel</b>",
         use_markup: true,
         halign: Gtk.Align.START,
-        visible: true
+        visible: true,
     });
-    prefsWidget.add(title);
+    const keysFrame = new Gtk.Frame({
+        label_widget: keysTitle,
+        shadow_type: Gtk.ShadowType.NONE,
+        visible: true,
+    });
+    let keysBox = new Gtk.Box({
+        orientation: Gtk.Orientation.VERTICAL,
+        margin: 12,
+        spacing: 6,
+        visible: true,
+    });
+    keysFrame.add(keysBox);
 
     let store = new Gtk.ListStore();
     store.set_column_types([
-        GObject.TYPE_STRING, // COLUMN_ID
-        GObject.TYPE_STRING, // COLUMN_DESC
-        GObject.TYPE_INT,    // COLUMN_KEY
-        GObject.TYPE_INT,    // COLUMN_MODS
+        GObject.TYPE_STRING,
+        GObject.TYPE_STRING,
+        GObject.TYPE_INT,
+        GObject.TYPE_INT,
     ]);
 
-    addKeybinding(store, settings, 'swap-master-window', 'Master-Fenster tauschen');
-    addKeybinding(store, settings, 'swap-left-window', 'Fenster nach links tauschen');
-    addKeybinding(store, settings, 'swap-right-window', 'Fenster nach rechts tauschen');
-    addKeybinding(store, settings, 'swap-up-window', 'Fenster nach oben tauschen');
-    addKeybinding(store, settings, 'swap-down-window', 'Fenster nach unten tauschen');
+    addKeybinding(
+        store,
+        settings,
+        "swap-master-window",
+        "Master-Fenster tauschen"
+    );
+    addKeybinding(
+        store,
+        settings,
+        "swap-left-window",
+        "Fenster nach links tauschen"
+    );
+    addKeybinding(
+        store,
+        settings,
+        "swap-right-window",
+        "Fenster nach rechts tauschen"
+    );
+    addKeybinding(
+        store,
+        settings,
+        "swap-up-window",
+        "Fenster nach oben tauschen"
+    );
+    addKeybinding(
+        store,
+        settings,
+        "swap-down-window",
+        "Fenster nach unten tauschen"
+    );
+
+    addKeybinding(store, settings, "focus-left", "Fokus nach links wechseln");
+    addKeybinding(store, settings, "focus-right", "Fokus nach rechts wechseln");
+    addKeybinding(store, settings, "focus-up", "Fokus nach oben wechseln");
+    addKeybinding(store, settings, "focus-down", "Fokus nach unten wechseln");
 
     let treeView = new Gtk.TreeView({
         model: store,
         headers_visible: false,
         hexpand: true,
-        visible: true
+        visible: true,
     });
+    keysBox.add(treeView);
 
     let descRenderer = new Gtk.CellRendererText();
     let descColumn = new Gtk.TreeViewColumn({ expand: true });
     descColumn.pack_start(descRenderer, true);
-    descColumn.add_attribute(descRenderer, 'text', COLUMN_DESC);
+    descColumn.add_attribute(descRenderer, "text", COLUMN_DESC);
     treeView.append_column(descColumn);
 
     let accelRenderer = new Gtk.CellRendererAccel({
-        'accel-mode': Gtk.CellRendererAccelMode.GTK,
-        'editable': true
+        "accel-mode": Gtk.CellRendererAccelMode.GTK,
+        editable: true,
     });
     let accelColumn = new Gtk.TreeViewColumn();
     accelColumn.pack_end(accelRenderer, false);
-    accelColumn.add_attribute(accelRenderer, 'accel-key', COLUMN_KEY);
-    accelColumn.add_attribute(accelRenderer, 'accel-mods', COLUMN_MODS);
+    accelColumn.add_attribute(accelRenderer, "accel-key", COLUMN_KEY);
+    accelColumn.add_attribute(accelRenderer, "accel-mods", COLUMN_MODS);
     treeView.append_column(accelColumn);
 
-    prefsWidget.add(treeView);
-
-    accelRenderer.connect('accel-edited', (renderer, path_string, key, mods, hw_code) => {
-        let [ok, iter] = store.get_iter_from_string(path_string);
-        if (!ok) return;
-
-        store.set(iter, [COLUMN_KEY, COLUMN_MODS], [key, mods]);
-
-        let id = store.get_value(iter, COLUMN_ID);
-        let accelString = Gtk.accelerator_name(key, mods);
-        settings.set_strv(id, [accelString]);
+    accelRenderer.connect("accel-edited", (r, path, key, mods) => {
+        let [ok, iter] = store.get_iter_from_string(path);
+        if (ok) {
+            store.set(iter, [COLUMN_KEY, COLUMN_MODS], [key, mods]);
+            settings.set_strv(store.get_value(iter, COLUMN_ID), [
+                Gtk.accelerator_name(key, mods),
+            ]);
+        }
     });
 
-    accelRenderer.connect('accel-cleared', (renderer, path_string) => {
-        let [ok, iter] = store.get_iter_from_string(path_string);
-        if (!ok) return;
-
-        store.set(iter, [COLUMN_KEY, COLUMN_MODS], [0, 0]);
-        let id = store.get_value(iter, COLUMN_ID);
-        settings.set_strv(id, []);
+    accelRenderer.connect("accel-cleared", (r, path) => {
+        let [ok, iter] = store.get_iter_from_string(path);
+        if (ok) {
+            store.set(iter, [COLUMN_KEY, COLUMN_MODS], [0, 0]);
+            settings.set_strv(store.get_value(iter, COLUMN_ID), []);
+        }
     });
 
+    prefsWidget.add(keysFrame);
+
+    // ---------------------------------------------------- //
+    // Section for Window Gaps                              //
+    // ---------------------------------------------------- //
+    const gapsTitle = new Gtk.Label({
+        label: "<b>Fensterabstände (Gaps)</b>",
+        use_markup: true,
+        halign: Gtk.Align.START,
+        visible: true,
+    });
+    const gapsFrame = new Gtk.Frame({
+        label_widget: gapsTitle,
+        shadow_type: Gtk.ShadowType.NONE,
+        visible: true,
+    });
+    const gapsGrid = new Gtk.Grid({
+        margin: 12,
+        column_spacing: 12,
+        row_spacing: 12,
+        visible: true,
+    });
+    gapsFrame.add(gapsGrid);
+
+    addSpinButtonRow(gapsGrid, settings, "Innerer Abstand", "inner-gap", 0);
+    addSpinButtonRow(
+        gapsGrid,
+        settings,
+        "Äußerer Abstand (horizontal)",
+        "outer-gap-horizontal",
+        1
+    );
+    addSpinButtonRow(
+        gapsGrid,
+        settings,
+        "Äußerer Abstand (vertikal)",
+        "outer-gap-vertical",
+        2
+    );
+
+    prefsWidget.add(gapsFrame);
+
+    // ---------------------------------------------------- //
+    // Section for Window Behavior (Master vs. Stack)       //
+    // ---------------------------------------------------- //
+    const behaviorTitle = new Gtk.Label({
+        label: "<b>Fensterverhalten</b>",
+        use_markup: true,
+        halign: Gtk.Align.START,
+        visible: true,
+    });
+    const behaviorFrame = new Gtk.Frame({
+        label_widget: behaviorTitle,
+        shadow_type: Gtk.ShadowType.NONE,
+        visible: true,
+    });
+    const behaviorGrid = new Gtk.Grid({
+        margin: 12,
+        column_spacing: 12,
+        row_spacing: 12,
+        visible: true,
+    });
+    behaviorFrame.add(behaviorGrid);
+    addComboBoxRow(
+        behaviorGrid,
+        settings,
+        "Neues Fenster öffnen als",
+        "new-window-behavior",
+        0
+    );
+    prefsWidget.add(behaviorFrame);
+
     return prefsWidget;
 }
 
-function addKeybinding(model, settings, id, description) {
+function addKeybinding(model, settings, id, desc) {
     let [key, mods] = [0, 0];
-    
     const strv = settings.get_strv(id);
-    if (strv && strv.length > 0 && strv[0]) {
+    if (strv && strv[0]) {
         [key, mods] = Gtk.accelerator_parse(strv[0]);
     }
-
     let iter = model.append();
-    model.set(iter, 
+    model.set(
+        iter,
         [COLUMN_ID, COLUMN_DESC, COLUMN_KEY, COLUMN_MODS],
-        [id, description, key, mods]
+        [id, desc, key, mods]
     );
 }
+function addSpinButtonRow(grid, settings, desc, key, pos) {
+    const label = new Gtk.Label({
+        label: desc,
+        halign: Gtk.Align.START,
+        visible: true,
+    });
+    grid.attach(label, 0, pos, 1, 1);
+    const adj = new Gtk.Adjustment({ lower: 0, upper: 50, step_increment: 1 });
+    const spin = new Gtk.SpinButton({
+        adjustment: adj,
+        climb_rate: 1,
+        digits: 0,
+        halign: Gtk.Align.END,
+        visible: true,
+    });
+    settings.bind(key, spin, "value", Gio.SettingsBindFlags.DEFAULT);
+    grid.attach(spin, 1, pos, 1, 1);
+}
+function addComboBoxRow(grid, settings, desc, key, pos) {
+    const label = new Gtk.Label({
+        label: desc,
+        halign: Gtk.Align.START,
+        visible: true,
+    });
+    grid.attach(label, 0, pos, 1, 1);
+    const combo = new Gtk.ComboBoxText({
+        visible: true,
+        halign: Gtk.Align.END,
+    });
+    combo.append("stack", "Stack-Fenster (Standard)");
+    combo.append("master", "Master-Fenster");
+    combo.set_active_id(settings.get_string(key));
+    combo.connect("changed", () => {
+        settings.set_string(key, combo.get_active_id());
+    });
+    grid.attach(combo, 1, pos, 1, 1);
+}

schemas/org.gnome.shell.extensions.simple-tiling.domoel.gschema.xml

@@ -1,33 +1,62 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <schemalist>
-  <schema id="org.gnome.shell.extensions.simple-tiling.domoel"
-          path="/org/gnome/shell/extensions/simple-tiling-domoel/">
+  <schema id="org.gnome.shell.extensions.simple-tiling.domoel" path="/org/gnome/shell/extensions/simple-tiling-domoel/">
     
-    <!-- Master ↔ Stack -->
     <key name="swap-master-window" type="as">
-      <default>['&lt;Super&gt;Return']</default>
-      <summary>Tauscht Master-Fenster mit dem fokussierten Fenster</summary>
+      <default><![CDATA[['<Super>Return']]]></default>
+      <summary>Tauscht das fokussierte Fenster mit dem Master.</summary>
     </key>
-
-    <!-- Richtungs-Swaps -->
     <key name="swap-left-window" type="as">
-      <default>['&lt;Super&gt;Left']</default>
-      <summary>Tauscht mit linkem Nachbarfenster</summary>
+      <default><![CDATA[['<Super>Left']]]></default>
+      <summary>Tauscht das Fenster mit dem linken Nachbarn.</summary>
     </key>
-
     <key name="swap-right-window" type="as">
-      <default>['&lt;Super&gt;Right']</default>
-      <summary>Tauscht mit rechtem Nachbarfenster</summary>
+      <default><![CDATA[['<Super>Right']]]></default>
+      <summary>Tauscht das Fenster mit dem rechten Nachbarn.</summary>
     </key>
-
     <key name="swap-up-window" type="as">
-      <default>['&lt;Super&gt;Up']</default>
-      <summary>Tauscht mit oberem Nachbarfenster</summary>
+      <default><![CDATA[['<Super>Up']]]></default>
+      <summary>Tauscht das Fenster mit dem oberen Nachbarn.</summary>
+    </key>
+    <key name="swap-down-window" type="as">
+      <default><![CDATA[['<Super>Down']]]></default>
+      <summary>Tauscht das Fenster mit dem unteren Nachbarn.</summary>
     </key>
     
-    <key name="swap-down-window" type="as">
-      <default>['&lt;Super&gt;Down']</default>
-      <summary>Tauscht mit unterem Nachbarfenster</summary>
+    <key name="focus-up" type="as">
+      <default><![CDATA[['<Alt>k']]]></default>
+      <summary>Fokus zum oberen Fenster wechseln.</summary>
+    </key>
+    <key name="focus-down" type="as">
+      <default><![CDATA[['<Alt>j']]]></default>
+      <summary>Fokus zum unteren Fenster wechseln.</summary>
+    </key>
+    <key name="focus-left" type="as">
+      <default><![CDATA[['<Alt>h']]]></default>
+      <summary>Fokus zum linken Fenster wechseln.</summary>
+    </key>
+    <key name="focus-right" type="as">
+      <default><![CDATA[['<Alt>l']]]></default>
+      <summary>Fokus zum rechten Fenster wechseln.</summary>
+    </key>
+
+    <key name="inner-gap" type="i">
+      <default>10</default>
+      <summary>Der Abstand zwischen den Fenstern in Pixeln.</summary>
+    </key>
+    <key name="outer-gap-vertical" type="i">
+      <default>5</default>
+      <summary>Der Abstand zum oberen und unteren Bildschirmrand.</summary>
+    </key>
+    <key name="outer-gap-horizontal" type="i">
+      <default>10</default>
+      <summary>Der Abstand zum linken und rechten Bildschirmrand.</summary>
+    </key>
+
+    <key name="new-window-behavior" type="s">
+      <default>'stack'</default>
+      <summary>Verhalten für neu geöffnete Fenster.</summary>
+      <description>Legt fest, ob ein neues Fenster als Master oder als Teil des Stacks hinzugefügt wird.</description>
     </key>
     
   </schema>