4 files changed, 273 insertions, 0 deletions
diff --git a/scripts/install-whisper.sh b/scripts/install-whisper.sh
new file mode 100755
index 00000000..e2ea4ac9
--- /dev/null
+++ b/scripts/install-whisper.sh
@@ -0,0 +1,103 @@
+#!/usr/bin/env bash
+# Install OpenAI Whisper for transcription on Arch Linux
+# Usage: install-whisper.sh [--yes]   # --yes for non-interactive mode
+
+set -euo pipefail
+
+# Non-interactive mode
+ASSUME_YES=false
+if [[ "${1:-}" == "--yes" ]] || [[ "${1:-}" == "-y" ]]; then
+  ASSUME_YES=true
+fi
+
+echo "=== Whisper Installation for Arch Linux ==="
+echo
+
+# Check if running on Arch
+if [[ ! -f /etc/arch-release ]]; then
+  echo "Warning: This script is designed for Arch Linux"
+  if [[ "$ASSUME_YES" == false ]]; then
+    read -p "Continue anyway? [y/N] " -n 1 -r
+    echo
+    [[ ! $REPLY =~ ^[Yy]$ ]] && exit 1
+  else
+    echo "Continuing anyway (--yes mode)"
+  fi
+fi
+
+# 1. Install system dependencies
+echo "Step 1/3: Installing system dependencies (ffmpeg)..."
+if ! command -v ffmpeg &> /dev/null; then
+  sudo pacman -S --needed ffmpeg
+  echo "✓ ffmpeg installed"
+else
+  echo "✓ ffmpeg already installed"
+fi
+
+# 2. Check for AUR package first (optional but cleaner)
+echo
+echo "Step 2/3: Checking for AUR package..."
+AUR_INSTALLED=false
+
+if command -v yay &> /dev/null; then
+  echo "Found yay. Checking AUR for python-openai-whisper..."
+  if yay -Ss python-openai-whisper | grep -q 'python-openai-whisper'; then
+    INSTALL_AUR=false
+    if [[ "$ASSUME_YES" == true ]]; then
+      echo "Installing from AUR (--yes mode)"
+      INSTALL_AUR=true
+    else
+      read -p "Install from AUR via yay? [Y/n] " -n 1 -r
+      echo
+      if [[ $REPLY =~ ^[Yy]$ ]] || [[ -z $REPLY ]]; then
+        INSTALL_AUR=true
+      fi
+    fi
+
+    if [[ "$INSTALL_AUR" == true ]]; then
+      yay -S --needed --noconfirm python-openai-whisper
+      echo "✓ Installed from AUR"
+      AUR_INSTALLED=true
+    fi
+  else
+    echo "Package python-openai-whisper not found in AUR"
+  fi
+else
+  echo "yay not found. Skipping AUR installation."
+  echo "(Install yay if you prefer AUR packages)"
+fi
+
+# 3. Install via pip if not from AUR
+if [[ "$AUR_INSTALLED" == false ]]; then
+  echo
+  echo "Step 3/3: Installing openai-whisper via pip..."
+  pip install --user -U openai-whisper
+  echo "✓ openai-whisper installed via pip"
+  echo
+  echo "Note: Ensure ~/.local/bin is in your PATH"
+  echo "Add to ~/.bashrc or ~/.zshrc: export PATH=\"\$HOME/.local/bin:\$PATH\""
+fi
+
+# Verify installation
+echo
+echo "=== Verifying Installation ==="
+if command -v whisper &> /dev/null; then
+  echo "✓ whisper command found at: $(which whisper)"
+  whisper --help | head -n 3
+  echo
+  echo "=== Installation Complete! ==="
+  echo
+  echo "Models available: tiny, base, small, medium, large"
+  echo "Recommended: small (good balance of speed/accuracy)"
+  echo "Model will download automatically on first use."
+  echo
+  echo "Test with: whisper your-audio.m4a --model small --language en"
+else
+  echo "✗ Installation failed - whisper command not found"
+  echo
+  echo "Troubleshooting:"
+  echo "1. Ensure ~/.local/bin is in your PATH"
+  echo "2. Run: source ~/.bashrc (or ~/.zshrc)"
+  echo "3. Try: python -m whisper --help"
+  exit 1
+fi
diff --git a/scripts/local-whisper b/scripts/local-whisper
new file mode 100755
index 00000000..b08651c9
--- /dev/null
+++ b/scripts/local-whisper
@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+# local-whisper - Transcribe audio files using locally installed Whisper
+# Usage: local-whisper <audio-file> [model] [language]
+#
+# Models: tiny, base, small, medium, large (default: small)
+# Language: en, es, fr, etc. (default: en)
+
+set -euo pipefail
+
+# Parse arguments
+AUDIO="${1:-}"
+MODEL="${2:-small}"
+LANG="${3:-en}"
+
+# Validate arguments
+if [[ -z "$AUDIO" ]]; then
+  echo "Usage: local-whisper <audio-file> [model] [language]" >&2
+  echo "Example: local-whisper meeting.m4a small en" >&2
+  exit 1
+fi
+
+if [[ ! -f "$AUDIO" ]]; then
+  echo "Error: Audio file not found: $AUDIO" >&2
+  exit 1
+fi
+
+# Check whisper is installed
+if ! command -v whisper &> /dev/null; then
+  echo "Error: whisper command not found" >&2
+  echo "Install with: ~/.emacs.d/scripts/install-whisper.sh" >&2
+  exit 1
+fi
+
+# Get absolute path to audio file
+AUDIO_ABS="$(realpath "$AUDIO")"
+AUDIO_DIR="$(dirname "$AUDIO_ABS")"
+AUDIO_BASE="$(basename "$AUDIO_ABS")"
+AUDIO_NAME="${AUDIO_BASE%.*}"
+
+# Run whisper
+# Note: whisper creates ${AUDIO_NAME}.txt automatically in the output directory
+whisper "$AUDIO_ABS" \
+  --model "$MODEL" \
+  --language "$LANG" \
+  --task transcribe \
+  --output_format txt \
+  --output_dir "$AUDIO_DIR" \
+  --verbose False 2>&1
+
+# Output file that whisper creates
+OUTPUT_FILE="$AUDIO_DIR/$AUDIO_NAME.txt"
+
+# Return transcript to stdout
+if [[ -f "$OUTPUT_FILE" ]]; then
+  cat "$OUTPUT_FILE"
+  exit 0
+else
+  echo "Error: Whisper did not create expected output file: $OUTPUT_FILE" >&2
+  exit 1
+fi
diff --git a/scripts/oai-transcribe b/scripts/oai-transcribe
new file mode 100755
index 00000000..f64a8122
--- /dev/null
+++ b/scripts/oai-transcribe
@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+# oai-transcribe - Transcribe audio files using OpenAI Whisper API
+# Usage: oai-transcribe <audio-file> [language]
+#
+# Requires: OPENAI_API_KEY environment variable
+# Language: en, es, fr, etc. (default: en)
+
+set -euo pipefail
+
+# Parse arguments
+AUDIO="${1:-}"
+LANG="${2:-en}"
+
+# Validate arguments
+if [[ -z "$AUDIO" ]]; then
+  echo "Usage: oai-transcribe <audio-file> [language]" >&2
+  echo "Example: oai-transcribe meeting.m4a en" >&2
+  exit 1
+fi
+
+if [[ ! -f "$AUDIO" ]]; then
+  echo "Error: Audio file not found: $AUDIO" >&2
+  exit 1
+fi
+
+# Check API key is set
+if [[ -z "${OPENAI_API_KEY:-}" ]]; then
+  echo "Error: OPENAI_API_KEY environment variable not set" >&2
+  echo "Set with: export OPENAI_API_KEY='sk-...'" >&2
+  exit 1
+fi
+
+# Check curl is available
+if ! command -v curl &> /dev/null; then
+  echo "Error: curl command not found" >&2
+  exit 1
+fi
+
+# Call OpenAI API
+curl -s -X POST "https://api.openai.com/v1/audio/transcriptions" \
+  -H "Authorization: Bearer $OPENAI_API_KEY" \
+  -F "model=whisper-1" \
+  -F "response_format=text" \
+  -F "language=${LANG}" \
+  -F "file=@${AUDIO}"
diff --git a/scripts/uninstall-whisper.sh b/scripts/uninstall-whisper.sh
new file mode 100755
index 00000000..e46c6ebc
--- /dev/null
+++ b/scripts/uninstall-whisper.sh
@@ -0,0 +1,65 @@
+#!/usr/bin/env bash
+# Uninstall OpenAI Whisper
+
+set -euo pipefail
+
+echo "=== Whisper Uninstallation ==="
+echo
+
+REMOVED=false
+
+# Check if installed via AUR
+if command -v yay &> /dev/null; then
+  if yay -Qi python-openai-whisper &> /dev/null 2>&1; then
+    echo "Detected AUR installation (python-openai-whisper)"
+    read -p "Remove via yay? [Y/n] " -n 1 -r
+    echo
+    if [[ $REPLY =~ ^[Yy]$ ]] || [[ -z $REPLY ]]; then
+      yay -R python-openai-whisper
+      echo "✓ Removed via AUR"
+      REMOVED=true
+    fi
+  fi
+fi
+
+# Check if installed via pip
+if pip list 2>/dev/null | grep -q openai-whisper; then
+  echo "Detected pip installation (openai-whisper)"
+  read -p "Remove via pip? [Y/n] " -n 1 -r
+  echo
+  if [[ $REPLY =~ ^[Yy]$ ]] || [[ -z $REPLY ]]; then
+    pip uninstall -y openai-whisper
+    echo "✓ Removed via pip"
+    REMOVED=true
+  fi
+fi
+
+if [[ "$REMOVED" == false ]]; then
+  echo "No whisper installation found (checked AUR and pip)"
+fi
+
+# Ask about ffmpeg
+echo
+read -p "Remove ffmpeg? (may be used by other apps) [y/N] " -n 1 -r
+echo
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+  sudo pacman -R ffmpeg
+  echo "✓ Removed ffmpeg"
+fi
+
+# Ask about model cache
+CACHE_DIR="$HOME/.cache/whisper"
+if [[ -d "$CACHE_DIR" ]]; then
+  echo
+  echo "Whisper models are cached in: $CACHE_DIR"
+  du -sh "$CACHE_DIR" 2>/dev/null || echo "Size: unknown"
+  read -p "Delete cached models? [y/N] " -n 1 -r
+  echo
+  if [[ $REPLY =~ ^[Yy]$ ]]; then
+    rm -rf "$CACHE_DIR"
+    echo "✓ Deleted model cache"
+  fi
+fi
+
+echo
+echo "=== Uninstallation Complete ==="