A Dynamic Collection of Shell Scripts with Educational Purpose

Author: felipefacundes

modules_for_scripts/script-wrapper-to-be-used-in-the-same-folder.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Script Wrapper to be used in the same folder
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PREVIEW_SCRIPT="${SCRIPT_DIR}/script-base-to-be-used-in-the-same-folder"

scripts/sway-window-preview

@@ -0,0 +1,163 @@
+#!/usr/bin/env bash
+# License: GPLv3
+# Credits: Felipe Facundes
+
+# Sway Window Switcher in Bash
+# Behavior: native focus right/left + notification of the focused window
+# --list shows all windows via rofi
+
+show_preview=1
+
+# Check dependencies at the start
+check_deps() {
+    local deps=("swaymsg" "jq")
+    if [[ "$1" == "--list" ]] || [[ "${mode:-}" == "list" ]]; then
+        deps+=("rofi")
+    fi
+    
+    for dep in "${deps[@]}"; do
+        if ! command -v "$dep" >/dev/null 2>&1; then
+            echo "Error: $dep not found" >&2
+            exit 1
+        fi
+    done
+}
+
+get_focused_window_info() {
+    # Get information about the currently focused window
+    local tree
+    tree=$(swaymsg -t get_tree 2>/dev/null) || return 1
+
+    local name app_id class_name
+
+    name=$(echo "$tree" | jq -r '
+        .. | select(.focused? == true) |
+        .name // "Untitled" |
+        if . == "" then "Untitled" else . end
+    ' 2>/dev/null)
+
+    app_id=$(echo "$tree" | jq -r '
+        .. | select(.focused? == true) |
+        .app_id // ""
+    ' 2>/dev/null)
+
+    class_name=$(echo "$tree" | jq -r '
+        .. | select(.focused? == true) |
+        .window_properties.class // ""
+    ' 2>/dev/null)
+
+    # Return empty if nothing useful was found
+    [[ -z "$name" ]] && return 1
+    
+    echo "$name|$app_id|$class_name"
+}
+
+switch_window() {
+    local direction="$1"   # "next" or "prev"
+
+    if [[ "$direction" == "next" ]]; then
+        swaymsg focus right >/dev/null 2>&1
+    else
+        swaymsg focus left >/dev/null 2>&1
+    fi
+
+    # Small wait for the focus to update
+    sleep 0.08
+
+    (( show_preview == 0 )) && return
+
+    local info
+    info=$(get_focused_window_info) || return
+
+    IFS='|' read -r name app_id class_name <<< "$info"
+
+    local icon="${app_id:-${class_name:-window}}"
+    local clean_name="${name//$'\n'/ }"
+
+    notify-send \
+        --app-name "Window Switcher" \
+        --icon "$icon" \
+        --expire-time 1400 \
+        --urgency low \
+        "→ $clean_name" >/dev/null 2>&1
+}
+
+show_rofi_list() {
+    local tree
+    tree=$(swaymsg -t get_tree 2>/dev/null) || exit 1
+
+    # Extract all windows with jq - more robust
+    local windows
+    mapfile -t windows < <(echo "$tree" | jq -r '
+        .. | select(.type? == "con" or .type? == "floating_con") |
+        select(.name != null and .name != "") |
+        .name as $n |
+        .app_id as $a |
+        (.window_properties.class // "") as $c |
+        .id as $id |
+        .focused as $f |
+        [$n, ($a // $c // "?"), $id, $f] | @tsv
+    ' 2>/dev/null)
+
+    (( ${#windows[@]} == 0 )) && exit 0
+
+    local rofi_lines=() id_map=()
+    local name app id focused prefix line
+
+    for win in "${windows[@]}"; do
+        IFS=$'\t' read -r name app id focused <<< "$win"
+
+        # Skip unwanted windows (case insensitive)
+        local lower_all="${app,,}${name,,}"
+        [[ "$lower_all" =~ waybar|wofi|rofi|dmenu|swaync|swaylock ]] && continue
+
+        # Clean name
+        name="${name//$'\n'/ }"
+
+        # Prefix based on focus
+        prefix="  "
+        [[ "$focused" == "true" ]] && prefix="● "
+
+        line="${prefix}${name}   <small>(${app})</small>"
+        rofi_lines+=("$line")
+        id_map+=("$id")
+    done
+
+    (( ${#rofi_lines[@]} == 0 )) && exit 0
+
+    local choice
+    choice=$(printf '%s\n' "${rofi_lines[@]}" | rofi -dmenu -i -p "Windows" -format i -no-custom 2>/dev/null)
+
+    if [[ -n "$choice" && "$choice" =~ ^[0-9]+$ && "$choice" -lt ${#rofi_lines[@]} ]]; then
+        local selected_id="${id_map[$choice]}"
+        [[ -n "$selected_id" ]] && swaymsg "[con_id=$selected_id] focus" >/dev/null 2>&1
+    fi
+}
+
+# Parse arguments
+mode=""
+direction="next"  # default
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        --next)     direction="next" ;;
+        --prev)     direction="prev" ;;
+        --list)     mode="list" ;;
+        --disable-preview) show_preview=0 ;;
+        *) 
+            echo "Usage: ${0##*/} [--next] [--prev] [--list] [--disable-preview]" >&2
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+# Check dependencies
+check_deps "${1:-}"
+
+# Execute
+if [[ "$mode" == "list" ]]; then
+    show_rofi_list
+else
+    switch_window "$direction"
+fi

scripts/sway-window-preview-cli.py

@@ -0,0 +1,177 @@
+#!/usr/bin/env python3
+# License: GPLv3
+# Credits: Felipe Facundes
+
+"""
+Sway Window Switcher with notification
+Behaves like sway's focus right / focus left + notification of the focused window
+"""
+import subprocess
+import json
+import sys
+
+
+class SwayFastSwitcher:
+    def __init__(self):
+        self.show_preview = True
+
+    def _get_focused_window_info(self):
+        """Returns information about the currently focused window"""
+        try:
+            tree = json.loads(subprocess.run(
+                ['swaymsg', '-t', 'get_tree'],
+                capture_output=True, text=True, check=True
+            ).stdout)
+
+            def find_focused(node):
+                if not isinstance(node, dict):
+                    return None
+                if node.get('focused'):
+                    name = (node.get('name') or '').strip() or 'Untitled'
+                    app_id = node.get('app_id') or ''
+                    class_name = node.get('window_properties', {}).get('class', '')
+                    return {
+                        'name': name,
+                        'app_id': app_id,
+                        'class': class_name,
+                        'id': node.get('id')
+                    }
+                for key in ['nodes', 'floating_nodes']:
+                    if key in node:
+                        for child in node[key]:
+                            found = find_focused(child)
+                            if found:
+                                return found
+                return None
+
+            return find_focused(tree)
+        except:
+            return None
+
+    def switch_window(self, direction='next'):
+        if direction not in ('next', 'prev'):
+            return
+
+        sway_direction = 'right' if direction == 'next' else 'left'
+
+        # Execute the native sway command
+        subprocess.run(
+            ['swaymsg', 'focus', sway_direction],
+            capture_output=True, check=False
+        )
+
+        # Wait a very short moment for the focus to be updated
+        # (generally 20-80ms is enough)
+        import time
+        time.sleep(0.06)
+
+        # Get information about the window that was just focused
+        info = self._get_focused_window_info()
+        if not info:
+            return
+
+        if self.show_preview:
+            try:
+                icon = info['app_id'] or info['class'] or 'window'
+                subprocess.run([
+                    'notify-send',
+                    '--app-name', 'Window Switcher',
+                    '--icon', icon,
+                    '--expire-time', '1400',
+                    '--urgency', 'low',
+                    f"→ {info['name']}"
+                ], capture_output=True)
+            except:
+                pass
+
+    def show_rofi_list(self):
+        """List ALL windows (all workspaces)"""
+        try:
+            tree = json.loads(subprocess.run(
+                ['swaymsg', '-t', 'get_tree'],
+                capture_output=True, text=True, check=True
+            ).stdout)
+
+            windows = []
+            def collect(node):
+                if not isinstance(node, dict):
+                    return
+                if node.get('type') in ['con', 'floating_con'] and node.get('name'):
+                    name = (node.get('name') or '').strip() or 'Untitled'
+                    app_id = node.get('app_id') or ''
+                    class_name = node.get('window_properties', {}).get('class', '')
+                    skip = ['waybar', 'wofi', 'rofi', 'dmenu', 'swaync', 'swaylock']
+                    if any(p in (app_id + name + class_name).lower() for p in skip):
+                        return
+                    windows.append({
+                        'id': node['id'],
+                        'name': name,
+                        'app': app_id or class_name or '?',
+                        'focused': node.get('focused', False)
+                    })
+                for k in ['nodes', 'floating_nodes']:
+                    if k in node:
+                        for c in node[k]:
+                            collect(c)
+
+            collect(tree)
+
+            if not windows:
+                return
+
+            lines = []
+            id_map = {}
+            for i, w in enumerate(windows):
+                prefix = "● " if w['focused'] else "  "
+                line = f"{prefix}{w['name']}   <small>({w['app']})</small>"
+                lines.append(line)
+                id_map[i] = w['id']
+
+            rofi_input = "\n".join(lines)
+
+            result = subprocess.run(
+                ['rofi', '-dmenu', '-i', '-p', 'Windows', '-format', 'i', '-no-custom'],
+                input=rofi_input, text=True, capture_output=True, check=False
+            )
+
+            if result.returncode == 0 and result.stdout.strip():
+                try:
+                    idx = int(result.stdout.strip())
+                    if idx in id_map:
+                        subprocess.run(
+                            ['swaymsg', f'[con_id={id_map[idx]}]', 'focus'],
+                            capture_output=True
+                        )
+                except:
+                    pass
+
+        except Exception as e:
+            print(f"Error listing windows: {e}", file=sys.stderr)
+
+
+def main():
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Sway Window Switcher")
+    parser.add_argument('--next', action='store_true')
+    parser.add_argument('--prev', action='store_true')
+    parser.add_argument('--list', action='store_true')
+    parser.add_argument('--disable-preview', action='store_true')
+
+    args = parser.parse_args()
+
+    switcher = SwayFastSwitcher()
+
+    if args.disable_preview:
+        switcher.show_preview = False
+
+    if args.list:
+        switcher.show_rofi_list()
+    elif args.prev:
+        switcher.switch_window('prev')
+    else:
+        switcher.switch_window('next')   # default and --next
+
+
+if __name__ == '__main__':
+    main()