Files
tmux-logger/INSTALL.md
2025-07-17 19:39:02 -05:00

1.2 KiB

Installation

Manual install

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

Add to ~/.tmux.conf:

run-shell '~/.tmux/plugins/tmux-logger/tmux-logger.tmux'

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

TPM install

Add to ~/.tmux.conf:

set -g @plugin 'user/tmux-logger'

Press prefix + I

Options

# 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

./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.