garlaunch

# Cache file locations
~/.cache/garlaunch/drun.cache   # Desktop apps frecency
~/.cache/garlaunch/run.cache    # Executables frecency
~/.cache/garlaunch/window.cache # Window switching frecency

# Cache format (TSV)
# id	score	last_access_timestamp
firefox	5.234567	1706900000
code	3.891234	1706899000

garlaunch --mode drun
garlaunchctl show --mode drun

garlaunch --mode run
garlaunchctl show --mode run

garlaunch --mode window
garlaunchctl show --mode window

// Commands sent to gar:
{"command": "get_windows"}
{"command": "focus_window", "args": {"id": 12345678}}

garlaunch --mode script --source /path/to/script
garlaunchctl show --mode script --source ~/.local/bin/my-launcher

{
  "items": [
    {"id": "proj1", "name": "Project Alpha", "description": "~/src/alpha"},
    {"id": "proj2", "name": "Project Beta", "description": "~/src/beta", "icon": "folder"},
    {"id": "proj3", "name": "Project Gamma", "data": {"path": "/home/user/gamma"}}
  ]
}

{
  "selected": {
    "id": "proj1",
    "name": "Project Alpha",
    "description": "~/src/alpha",
    "icon": null,
    "data": null
  }
}

#!/bin/bash
# ~/.local/bin/project-launcher

# Output initial items (one JSON line)
echo '{"items": ['
echo '  {"id": "p1", "name": "Website", "description": "~/src/website"},'
echo '  {"id": "p2", "name": "API Server", "description": "~/src/api"},'
echo '  {"id": "p3", "name": "Mobile App", "description": "~/src/mobile"}'
echo ']}'

# Read selection from stdin
read selection

# Parse selected ID (using jq)
id=$(echo "$selection" | jq -r '.selected.id')

# Return action based on selection
case "$id" in
  p1) echo '{"action": "launch", "command": "code ~/src/website"}' ;;
  p2) echo '{"action": "launch", "command": "code ~/src/api"}' ;;
  p3) echo '{"action": "launch", "command": "code ~/src/mobile"}' ;;
  *)  echo '{"action": "close"}' ;;
esac

#!/usr/bin/env python3
# ~/.local/bin/ssh-launcher

import json
import sys
import os

# Read SSH config for hosts
hosts = []
ssh_config = os.path.expanduser("~/.ssh/config")
if os.path.exists(ssh_config):
    with open(ssh_config) as f:
        for line in f:
            if line.strip().lower().startswith("host "):
                host = line.split()[1]
                if "*" not in host:
                    hosts.append({"id": host, "name": host, "icon": "network-server"})

# Output items
print(json.dumps({"items": hosts}))
sys.stdout.flush()

# Read selection
selection = json.loads(input())
host = selection["selected"]["id"]

# Return launch action
print(json.dumps({
    "action": "launch",
    "command": f"garterm -e ssh {host}"
}))

# Default location
$XDG_RUNTIME_DIR/garlaunch.sock

# Typically resolves to
/run/user/1000/garlaunch.sock

{
  "command": "show",
  "args": {
    "mode": "drun",
    "source": null
  }
}

# Show in default mode
echo '{"command": "show", "args": {"mode": "drun"}}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/garlaunch.sock

# Toggle visibility
echo '{"command": "toggle", "args": {"mode": "drun"}}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/garlaunch.sock

# Query daemon status
echo '{"command": "status"}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/garlaunch.sock

# Hide launcher
echo '{"command": "hide"}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/garlaunch.sock

# If daemon not running:
# garlaunchctl show --mode run
# becomes equivalent to:
garlaunch --mode run

import socket
import json
import os

sock_path = os.path.join(
    os.environ.get("XDG_RUNTIME_DIR", "/tmp"),
    "garlaunch.sock"
)

with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as sock:
    sock.connect(sock_path)

    # Send command
    request = {"command": "show", "args": {"mode": "drun"}}
    sock.send((json.dumps(request) + "\n").encode())

    # Read response
    response = sock.recv(4096).decode()
    print(json.loads(response))

use std::os::unix::net::UnixStream;
use std::io::{Write, BufRead, BufReader};

let socket_path = std::env::var("XDG_RUNTIME_DIR")
    .unwrap_or("/tmp".into()) + "/garlaunch.sock";

let mut stream = UnixStream::connect(&socket_path)?;

// Send request
let request = serde_json::json!({
    "command": "toggle",
    "args": {"mode": "drun"}
});
writeln!(stream, "{}", request)?;

// Read response
let mut reader = BufReader::new(&stream);
let mut response = String::new();
reader.read_line(&mut response)?;

println!("{}", response);

# Check if daemon is running
pgrep -f "garlaunch --daemon"

# Start daemon if needed
garlaunch --daemon &

# Verify socket exists
ls -la $XDG_RUNTIME_DIR/garlaunch.sock

# Test direct launch (bypasses daemon)
garlaunch --mode drun

# Check for X11 display
echo $DISPLAY

# Check if .desktop files exist
ls ~/.local/share/applications/
ls /usr/share/applications/

# Enable debug logging
RUST_LOG=garlaunch=debug garlaunch --mode drun

# Check XDG_DATA_HOME
echo $XDG_DATA_HOME

# Verify desktop file format
cat /usr/share/applications/firefox.desktop | head -20

# Check if gar is running
pgrep gar

# Check gar socket
ls -la $XDG_RUNTIME_DIR/gar.sock

# Test gar IPC directly
echo '{"command": "get_windows"}' | socat - UNIX-CONNECT:$XDG_RUNTIME_DIR/gar.sock

# Enable debug logging
RUST_LOG=garlaunch=debug garlaunch --mode window

# Make script executable
chmod +x ~/.local/bin/my-launcher

# Test script directly
~/.local/bin/my-launcher

# Should output valid JSON like:
# {"items": [{"id": "1", "name": "Test"}]}

# Run with debug logging
RUST_LOG=garlaunch=debug garlaunch --mode script --source ~/.local/bin/my-launcher

# Common issues:
# - Script not executable
# - Invalid JSON output
# - Missing newline after JSON
# - Script reads stdin before outputting items

# Check cache directory
ls -la ~/.cache/garlaunch/

# View frecency data
cat ~/.cache/garlaunch/drun.cache

# Cache should contain lines like:
# id	score	timestamp
# firefox	5.234567	1706900000

# Reset frecency (start fresh)
rm ~/.cache/garlaunch/*.cache

# Check systemd user session
systemctl --user status

# Verify graphical-session.target
systemctl --user status graphical-session.target

# List garlaunch-launched apps
systemctl --user list-units --type=scope 'app-garlaunch*'

# Check journal for errors
journalctl --user -u app-garlaunch.slice -f

# Test systemd-run manually
systemd-run --user --scope firefox

# Check X11 connection
xdpyinfo | head

# Verify compositor is running (for transparency)
pgrep -f garchomp || pgrep picom

# Test without transparency
# (Currently requires code change)

# Check font availability
fc-list | grep -i sans