# Installation

## Manual install

```bash
git clone https://github.com/dptsec/tmux-logger ~/.tmux/plugins/tmux-logger
```

Add to `~/.tmux.conf`:
```bash
run-shell '~/.tmux/plugins/tmux-logger/tmux-logger.tmux'
```

Reload: `tmux source-file ~/.tmux.conf`

## TPM install

Add to `~/.tmux.conf`:
```bash
set -g @plugin 'user/tmux-logger'
```

Press `prefix + I`

## Options

```bash
# Change log directory (default: ~/.tmux-logger)
set -g @tmux-logger-log-dir "~/logs"

# Use custom dictionary (default: /usr/share/dict/words)
set -g @tmux-logger-word-source "/path/to/words.txt"

# Enable timestamp prefix for each log line (default: off)
set -g @tmux-logger-timestamp-prefix "on"
```

## Dictionary setup

Most systems have `/usr/share/dict/words` already. If not:

**Ubuntu/Debian:** `sudo apt install wamerican`  
**macOS:** `brew install words`  
**Arch:** `sudo pacman -S words`  
**RHEL/CentOS:** `sudo yum install words`
**Void:** `sudo xbps-install words-en`

## Control

```bash
./scripts/control.sh status     # Check if logging
./scripts/control.sh logs       # List recent files
./scripts/control.sh cleanup    # Remove old logs
./scripts/control.sh stop       # Stop current pane
./scripts/control.sh start      # Start current pane
```

Done.