@sebastienrousseau/dotfiles 0.2.499 → 0.2.500

package/dot_local/bin/executable_kill-port

@@ -0,0 +1,75 @@
+#!/usr/bin/env bash
+## Kill Port — Terminate processes listening on a specified port.
+##
+## Finds and kills processes bound to a given port number.
+## Supports both graceful (SIGTERM) and forced (SIGKILL) termination.
+##
+## # Requirements
+## - lsof, ss, or netstat: For finding processes
+## - kill: For process termination
+## - ps: For process information display
+##
+## # Usage
+## kill-port 3000              # Kill process on port 3000
+## kill-port 8080 --force      # Force kill (SIGKILL)
+## kill-port 443               # May require sudo for privileged ports
+##
+## # Platform Notes
+## - Linux: Uses lsof or ss
+## - macOS: Uses lsof
+
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: kill-port <port> [--force]"
+  echo "Example: kill-port 3000"
+  exit 1
+fi
+
+PORT="$1"
+FORCE=false
+[[ "${2:-}" == "--force" || "${2:-}" == "-f" ]] && FORCE=true
+
+# Validate port number
+if ! [[ "$PORT" =~ ^[0-9]+$ ]] || [[ "$PORT" -lt 1 ]] || [[ "$PORT" -gt 65535 ]]; then
+  echo "Error: Invalid port number: $PORT"
+  exit 1
+fi
+
+# Find process using the port
+find_pid() {
+  if command -v lsof >/dev/null 2>&1; then
+    lsof -ti ":$PORT" 2>/dev/null
+  elif command -v ss >/dev/null 2>&1; then
+    ss -tlnp "sport = :$PORT" 2>/dev/null | awk 'NR>1 {match($0, /pid=([0-9]+)/, a); print a[1]}'
+  elif command -v netstat >/dev/null 2>&1; then
+    netstat -tlnp 2>/dev/null | awk -v port=":$PORT" '$4 ~ port {split($7, a, "/"); print a[1]}'
+  else
+    echo "Error: No supported tool found (lsof, ss, or netstat required)"
+    exit 1
+  fi
+}
+
+PIDS=$(find_pid)
+
+if [[ -z "$PIDS" ]]; then
+  echo "No process found on port $PORT"
+  exit 0
+fi
+
+echo "Found process(es) on port $PORT:"
+for pid in $PIDS; do
+  ps -p "$pid" -o pid,comm,args --no-headers 2>/dev/null || echo "  PID: $pid"
+done
+
+if $FORCE; then
+  SIGNAL="-9"
+  echo "Force killing..."
+else
+  SIGNAL="-15"
+  echo "Sending SIGTERM..."
+fi
+
+for pid in $PIDS; do
+  kill $SIGNAL "$pid" 2>/dev/null && echo "Killed PID $pid" || echo "Failed to kill PID $pid"
+done

package/dot_local/bin/executable_lorem

@@ -0,0 +1,118 @@
+#!/usr/bin/env bash
+## Lorem Ipsum Generator — Generate placeholder text.
+##
+## Generates lorem ipsum text in words, sentences, or paragraphs.
+## Useful for testing layouts and content rendering.
+##
+## # Requirements
+## - bash 4+: For array operations
+##
+## # Usage
+## lorem                       # 1 paragraph
+## lorem p 3                   # 3 paragraphs
+## lorem words 10              # 10 words
+## lorem sentences 5           # 5 sentences
+## lorem w 50                  # 50 words (short form)
+##
+## # Platform Notes
+## - All platforms: Pure bash implementation
+
+set -euo pipefail
+
+# Lorem ipsum word pool
+WORDS=(
+  "lorem" "ipsum" "dolor" "sit" "amet" "consectetur" "adipiscing" "elit"
+  "sed" "do" "eiusmod" "tempor" "incididunt" "ut" "labore" "et" "dolore"
+  "magna" "aliqua" "enim" "ad" "minim" "veniam" "quis" "nostrud"
+  "exercitation" "ullamco" "laboris" "nisi" "aliquip" "ex" "ea" "commodo"
+  "consequat" "duis" "aute" "irure" "in" "reprehenderit" "voluptate"
+  "velit" "esse" "cillum" "fugiat" "nulla" "pariatur" "excepteur" "sint"
+  "occaecat" "cupidatat" "non" "proident" "sunt" "culpa" "qui" "officia"
+  "deserunt" "mollit" "anim" "id" "est" "laborum" "perspiciatis" "unde"
+  "omnis" "iste" "natus" "error" "voluptatem" "accusantium" "doloremque"
+  "laudantium" "totam" "rem" "aperiam" "eaque" "ipsa" "quae" "ab" "illo"
+  "inventore" "veritatis" "quasi" "architecto" "beatae" "vitae" "dicta"
+  "explicabo" "nemo" "ipsam" "quia" "voluptas" "aspernatur" "aut" "odit"
+  "fugit" "consequuntur" "magni" "dolores" "eos" "ratione" "sequi"
+  "nesciunt" "neque" "porro" "quisquam" "dolorem" "adipisci" "numquam"
+  "eius" "modi" "tempora" "incidunt" "magnam" "quaerat"
+)
+
+random_word() {
+  echo "${WORDS[$RANDOM % ${#WORDS[@]}]}"
+}
+
+generate_sentence() {
+  local word_count=$((RANDOM % 10 + 5))
+  local sentence=""
+  for ((i = 0; i < word_count; i++)); do
+    if [[ $i -eq 0 ]]; then
+      word=$(random_word)
+      sentence="${word^}"
+    else
+      sentence="$sentence $(random_word)"
+    fi
+  done
+  echo "$sentence."
+}
+
+generate_paragraph() {
+  local sentence_count=$((RANDOM % 4 + 3))
+  local paragraph=""
+  for ((i = 0; i < sentence_count; i++)); do
+    if [[ $i -eq 0 ]]; then
+      paragraph=$(generate_sentence)
+    else
+      paragraph="$paragraph $(generate_sentence)"
+    fi
+  done
+  echo "$paragraph"
+}
+
+# Parse arguments
+TYPE="${1:-paragraphs}"
+COUNT="${2:-1}"
+
+case "$TYPE" in
+  w | word | words)
+    for ((i = 0; i < COUNT; i++)); do
+      if [[ $i -eq 0 ]]; then
+        word=$(random_word)
+        echo -n "${word^}"
+      else
+        echo -n " $(random_word)"
+      fi
+    done
+    echo
+    ;;
+  s | sentence | sentences)
+    for ((i = 0; i < COUNT; i++)); do
+      generate_sentence
+    done
+    ;;
+  p | paragraph | paragraphs)
+    for ((i = 0; i < COUNT; i++)); do
+      generate_paragraph
+      [[ $i -lt $((COUNT - 1)) ]] && echo
+    done
+    ;;
+  -h | --help)
+    echo "Usage: lorem [type] [count]"
+    echo ""
+    echo "Types:"
+    echo "  words, w        Generate words"
+    echo "  sentences, s    Generate sentences"
+    echo "  paragraphs, p   Generate paragraphs (default)"
+    echo ""
+    echo "Examples:"
+    echo "  lorem               # 1 paragraph"
+    echo "  lorem p 3           # 3 paragraphs"
+    echo "  lorem words 10      # 10 words"
+    echo "  lorem sentences 5   # 5 sentences"
+    ;;
+  *)
+    echo "Unknown type: $TYPE"
+    echo "Use: words, sentences, or paragraphs"
+    exit 1
+    ;;
+esac

package/dot_local/bin/executable_mkscript

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## mkscript — Create a ready-to-go shell script.
+##
+## # Usage
+##   mkscript hello
+##   mkscript /tmp/myscript
+
+set -euo pipefail
+
+file="${1:-}"
+
+if [[ -z "${file}" ]]; then
+  echo "Usage: mkscript <path>" >&2
+  exit 1
+fi
+
+if [[ -f "${file}" ]]; then
+  echo "${file} already exists, aborting." >&2
+  exit 1
+fi
+
+mkdir -p "$(dirname "${file}")"
+
+cat >"${file}" <<'EOF'
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+
+set -euo pipefail
+
+echo "hello world"
+EOF
+
+chmod +x "${file}"
+echo "Created ${file}"

package/dot_local/bin/executable_monitor

@@ -0,0 +1,56 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## monitor — GPU-aware system monitoring in tmux.
+##
+## Opens btop alongside an auto-detected GPU monitor in a tmux split.
+## Cross-platform: Linux (nvtop/amdgpu_top/nvidia-smi/intel_gpu_top),
+## macOS (powermetrics via sudo), WSL (nvidia-smi if available).
+##
+## # Usage
+##   monitor               # Opens btop + GPU monitor
+
+set -euo pipefail
+
+if ! command -v tmux &>/dev/null; then
+  echo "monitor requires tmux" >&2
+  # Fallback: just run btop directly
+  exec btop
+fi
+
+if ! command -v btop &>/dev/null; then
+  echo "monitor requires btop" >&2
+  exit 1
+fi
+
+# Auto-detect GPU monitoring tool (platform-aware)
+case "$(uname -s)" in
+  Darwin)
+    if command -v powermetrics &>/dev/null; then
+      gpu_command=(sudo powermetrics --samplers gpu_power -i 2000)
+    else
+      gpu_command=(bash -c "printf 'macOS GPU metrics require powermetrics (built-in).\nRun: sudo powermetrics --samplers gpu_power\n'; read -rp 'Press Enter to close...'")
+    fi
+    ;;
+  Linux)
+    if command -v nvtop &>/dev/null; then
+      gpu_command=(nvtop)
+    elif command -v amdgpu_top &>/dev/null; then
+      gpu_command=(amdgpu_top --dark)
+    elif command -v nvidia-smi &>/dev/null; then
+      gpu_command=(nvidia-smi)
+    elif command -v intel_gpu_top &>/dev/null; then
+      gpu_command=(sudo intel_gpu_top)
+    else
+      gpu_command=(bash -c "printf 'No GPU monitoring tools found.\n\nInstall: nvtop, amdgpu_top, nvidia-smi, or intel_gpu_top.\n'; read -rp 'Press Enter to close...'")
+    fi
+    ;;
+  *)
+    gpu_command=(bash -c "printf 'GPU monitoring not supported on this platform.\n'; read -rp 'Press Enter to close...'")
+    ;;
+esac
+
+# If inside tmux, open as new window; otherwise create a new session
+tmux_command=(new-session -s)
+[[ -n "${TMUX:-}" ]] && tmux_command=(new-window -n)
+
+tmux "${tmux_command[@]}" "monitor" "btop" \; split-window "${gpu_command[@]}"

package/dot_local/bin/executable_myip

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+## My IP — Display public and local IP addresses.
+##
+## Queries external services for public IP and inspects
+## network interfaces for local IP address.
+##
+## # Requirements
+## - curl: For external IP lookup
+## - ip or ifconfig: For local IP detection
+##
+## # Usage
+## myip                        # Show both IPs
+## myip --json                 # JSON output format
+##
+## # Platform Notes
+## - Linux: Uses ip route or ifconfig
+## - macOS: Uses ifconfig
+
+set -euo pipefail
+
+JSON_OUTPUT=false
+[[ "${1:-}" == "--json" ]] && JSON_OUTPUT=true
+
+# Get public IP
+get_public_ip() {
+  curl -s --max-time 5 https://api.ipify.org 2>/dev/null ||
+    curl -s --max-time 5 https://ifconfig.me 2>/dev/null ||
+    curl -s --max-time 5 https://icanhazip.com 2>/dev/null ||
+    echo "unavailable"
+}
+
+# Get local IP
+get_local_ip() {
+  if command -v ip >/dev/null 2>&1; then
+    ip route get 1 2>/dev/null | awk '{print $7; exit}'
+  elif command -v ifconfig >/dev/null 2>&1; then
+    ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1' | head -1
+  else
+    hostname -I 2>/dev/null | awk '{print $1}' || echo "unavailable"
+  fi
+}
+
+PUBLIC_IP=$(get_public_ip)
+LOCAL_IP=$(get_local_ip)
+
+if $JSON_OUTPUT; then
+  echo "{\"public\": \"$PUBLIC_IP\", \"local\": \"$LOCAL_IP\"}"
+else
+  echo "Public IP:  $PUBLIC_IP"
+  echo "Local IP:   $LOCAL_IP"
+fi

package/dot_local/bin/executable_notify

@@ -0,0 +1,22 @@
+#!/bin/sh
+# Universal desktop notification (notify)
+# Supports macOS (osascript), Linux (notify-send), and WSL (powershell)
+
+title="${1:-Notification}"
+message="${2:-}"
+
+case "$(uname -s)" in
+  Darwin)
+    osascript -e "display notification \"$message\" with title \"$title\""
+    ;;
+  Linux)
+    if grep -qi microsoft /proc/version 2>/dev/null; then
+      # WSL: Use PowerShell to show a toast notification
+      powershell.exe -Command "[Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('$message', '$title')"
+    elif command -v notify-send >/dev/null 2>&1; then
+      notify-send "$title" "$message"
+    else
+      echo "$title: $message"
+    fi
+    ;;
+esac

package/dot_local/bin/executable_open

@@ -0,0 +1,36 @@
+#!/bin/sh
+# Universal file opener (open)
+# Maps to open (macOS), xdg-open (Linux), and explorer.exe (WSL)
+
+target="${1:-.}"
+
+# Helper for rich feedback if TTY is present
+log_info() {
+  if [ -t 1 ] && command -v gum >/dev/null 2>&1; then
+    gum style --foreground 39 "󰀶 Opening: $1"
+  else
+    echo "open: $1"
+  fi
+}
+
+log_info "$target"
+
+case "$(uname -s)" in
+  Darwin)
+    # Use /usr/bin/open explicitly — otherwise this wrapper would recurse
+    # into itself via PATH lookup.
+    /usr/bin/open "$target"
+    ;;
+  Linux)
+    if grep -qi microsoft /proc/version 2>/dev/null; then
+      # WSL: Translate path and open with explorer.exe
+      win_path=$(wslpath -w "$target" 2>/dev/null || echo "$target")
+      explorer.exe "$win_path"
+    elif command -v xdg-open >/dev/null 2>&1; then
+      xdg-open "$target"
+    else
+      echo "Error: No opener found (xdg-open not installed)" >&2
+      exit 1
+    fi
+    ;;
+esac

package/dot_local/bin/executable_pw

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## pw — Generate a secure password and copy to clipboard.
+##
+## # Usage
+##   pw          # 48-char password (default)
+##   pw 64       # Custom length
+
+set -euo pipefail
+
+length="${1:-48}"
+
+# R5: validate input is a positive integer
+if [[ ! "$length" =~ ^[0-9]+$ ]] || [[ "$length" -lt 1 ]] || [[ "$length" -gt 1024 ]]; then
+  echo "Usage: pw [length] (1-1024, default 48)" >&2
+  exit 1
+fi
+
+if command -v pwgen &>/dev/null; then
+  pwgen -sync "${length}" -1 | cb
+elif command -v openssl &>/dev/null; then
+  openssl rand -base64 "$((length * 3 / 4 + 1))" | head -c "$length" | cb
+else
+  echo "Requires pwgen or openssl" >&2
+  exit 1
+fi
+echo "Password (${length} chars) copied to clipboard."

package/dot_local/bin/executable_rec-start

@@ -0,0 +1,46 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## rec-start — Disable shell history for screencasts/recordings.
+##
+## Backs up and removes the history file to prevent secrets leaking.
+## Run rec-stop to restore.
+##
+## # Usage
+##   rec-start
+
+set -euo pipefail
+
+# Detect history files across shells (bounded: max 3 candidates)
+histfiles=()
+[[ -n "${HISTFILE:-}" && -f "${HISTFILE}" ]] && histfiles+=("${HISTFILE}")
+[[ -f "${HOME}/.local/share/fish/fish_history" ]] && histfiles+=("${HOME}/.local/share/fish/fish_history")
+[[ -f "${HOME}/.bash_history" && "${HISTFILE:-}" != "${HOME}/.bash_history" ]] && histfiles+=("${HOME}/.bash_history")
+
+if [[ ${#histfiles[@]} -eq 0 ]]; then
+  echo "No history files found, nothing to do."
+  exit 0
+fi
+
+backed=0
+for histfile in "${histfiles[@]}"; do
+  if [[ -f "${histfile}.bak" ]]; then
+    echo "  Already backed up: ${histfile}"
+    continue
+  fi
+  # Atomic: mv is a single rename syscall (no cp+rm race)
+  if mv "${histfile}" "${histfile}.bak"; then
+    echo "  Backed up: ${histfile}"
+    backed=$((backed + 1))
+  else
+    echo "  Failed to back up: ${histfile}" >&2
+  fi
+done
+
+if [[ $backed -eq 0 ]]; then
+  echo "History already disabled. Run rec-stop first."
+  exit 1
+fi
+
+echo ""
+echo "Recording mode ON ($backed files backed up)"
+echo "  Run rec-stop to restore."

package/dot_local/bin/executable_rec-stop

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# Copyright (c) 2015-2026 Dotfiles. All rights reserved.
+## rec-stop — Restore shell history after recording.
+##
+## # Usage
+##   rec-stop
+
+set -euo pipefail
+
+# Restore all backed-up history files (bounded: max 3 candidates)
+candidates=(
+  "${HISTFILE:-${HOME}/.bash_history}"
+  "${HOME}/.local/share/fish/fish_history"
+  "${HOME}/.bash_history"
+)
+
+restored=0
+for histfile in "${candidates[@]}"; do
+  if [[ -f "${histfile}.bak" ]]; then
+    if mv "${histfile}.bak" "${histfile}"; then
+      echo "  Restored: ${histfile}"
+      restored=$((restored + 1))
+    else
+      echo "  Failed to restore: ${histfile}" >&2
+    fi
+  fi
+done
+
+if [[ $restored -eq 0 ]]; then
+  echo "No backups found, nothing to restore."
+  exit 0
+fi
+
+echo ""
+echo "Recording mode OFF ($restored files restored)"

package/dot_local/bin/executable_regex

@@ -0,0 +1,132 @@
+#!/usr/bin/env bash
+## Regex Tester — Test regular expressions against strings or files.
+##
+## Interactive regex testing with match highlighting.
+## Supports case-insensitive and global matching modes.
+##
+## # Requirements
+## - grep: Extended regex support (GNU or BSD)
+##
+## # Usage
+## regex '[0-9]+' 'abc123def'      # Test pattern
+## regex -g '[a-z]+' 'hello world' # Find all matches
+## regex -f '^#' config.txt        # Test against file
+## regex -i 'error' log.txt        # Case insensitive
+##
+## # Platform Notes
+## - All platforms: Uses grep -E (extended regex)
+
+set -euo pipefail
+
+usage() {
+  echo "Usage: regex [OPTIONS] <pattern> [string|file]"
+  echo ""
+  echo "Options:"
+  echo "  -f, --file       Test against file contents"
+  echo "  -g, --global     Find all matches"
+  echo "  -i, --ignore     Case insensitive"
+  echo "  -m, --multiline  Multiline mode"
+  echo "  -c, --color      Colorize matches"
+  echo "  -h, --help       Show this help"
+  echo ""
+  echo "Examples:"
+  echo "  regex '[0-9]+' 'abc123def'      # Test pattern"
+  echo "  regex -g '[a-z]+' 'hello world' # Find all"
+  echo "  regex -f '^#' config.txt        # Test file"
+}
+
+FILE_MODE=false
+GLOBAL=false
+IGNORE_CASE=""
+COLOR=true
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -f | --file)
+      FILE_MODE=true
+      shift
+      ;;
+    -g | --global)
+      GLOBAL=true
+      shift
+      ;;
+    -i | --ignore)
+      IGNORE_CASE="-i"
+      shift
+      ;;
+    -c | --color)
+      COLOR=true
+      shift
+      ;;
+    --no-color)
+      COLOR=false
+      shift
+      ;;
+    -h | --help)
+      usage
+      exit 0
+      ;;
+    -*)
+      echo "Unknown option: $1"
+      usage
+      exit 1
+      ;;
+    *) break ;;
+  esac
+done
+
+if [[ $# -lt 1 ]]; then
+  usage
+  exit 1
+fi
+
+PATTERN="$1"
+shift
+
+# Get input
+if $FILE_MODE; then
+  if [[ $# -lt 1 ]] || [[ ! -f "$1" ]]; then
+    echo "Error: File required for -f mode"
+    exit 1
+  fi
+  INPUT=$(cat "$1")
+elif [[ $# -gt 0 ]]; then
+  INPUT="$*"
+else
+  INPUT=$(cat)
+fi
+
+# Color settings
+if $COLOR; then
+  GREP_COLOR="--color=always"
+else
+  GREP_COLOR="--color=never"
+fi
+
+# Test and show matches
+echo "Pattern: $PATTERN"
+echo "---"
+
+if $GLOBAL; then
+  # Find all matches
+  if echo "$INPUT" | grep -oE $IGNORE_CASE "$PATTERN" $GREP_COLOR; then
+    echo "---"
+    MATCH_COUNT=$(echo "$INPUT" | grep -oE $IGNORE_CASE "$PATTERN" | wc -l)
+    echo "Found $MATCH_COUNT match(es)"
+  else
+    echo "No matches found"
+    exit 1
+  fi
+else
+  # Test if pattern matches
+  if echo "$INPUT" | grep -qE $IGNORE_CASE "$PATTERN"; then
+    echo "$INPUT" | grep -E $IGNORE_CASE "$PATTERN" $GREP_COLOR
+    echo "---"
+    echo "Pattern matches"
+  else
+    echo "$INPUT"
+    echo "---"
+    echo "Pattern does not match"
+    exit 1
+  fi
+fi

package/dot_local/bin/executable_start-niri

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+export XDG_CURRENT_DESKTOP=niri
+export XDG_SESSION_DESKTOP=niri
+export NIXOS_OZONE_WL=1
+
+exec niri