aw-watcher-tmux - An activity watcher for tmux

A tmux plugin that allows monitoring activity in sessions and panes with ActivityWatch.

Watches for activity in multiple tmux sessions and reports session_name, window_name, pane_title, pane_current_command, and pane_current_path.

The plugin has been tested on Linux and is expected to work also on macOS and on Windows in Cygwin.

How to install

Requirements

ActivityWatch
curl

Preparation

Install ActivityWatch as described in the getting-started guide.
Install the Tmux Plugin Manager (tpm)

Install the aw-watcher-tmux plugin

Add below line to your ~/.tmux.conf

set -g @plugin 'akohlbecker/aw-watcher-tmux'

Press prefix + I (capital i, as in Install) to fetch the plugin and reload the tmux environment. More detailed instructions are found in the tpm README.

Usage

Once the aw-watcher-tmux plugin is installed it monitors for user activity in all tmux sessions. Any activity is reported to the ActivityWatch REST API at http://localhost:5600/api/.

aw-watcher-tmux creates a new bucket. The existence of this bucket can be checked with http://localhost:5600/api/0/buckets/aw-watcher-tmux.

All activity recorded in this bucket can be seen on http://localhost:5600/#/timeline

1.6 KiB Raw Blame History