Skip to content

Latest commit

 

History

History
60 lines (35 loc) · 2.3 KB

README.md

File metadata and controls

60 lines (35 loc) · 2.3 KB
Raw

Fork adds mac compatability and scripts to show spent time in current git repo and report generation.

image image

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 macOS and on Windows in Cygwin.

How to install

Requirements

brew install bash coreutils curl

Preparation

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

Install the aw-watcher-tmux plugin

  1. Add below line to your ~/.tmux.conf
set -g @plugin 'theolundqvist/aw-watcher-tmux'
  1. 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

Configuration

Many parameters of this plugin are configurable. For example to use my.aw-server.test as alternative aw host, add the following line to your ~/.tmux.conf:

set -g @aw-watcher-tmux-host 'my.aw-server.test'

For more options, please see ./scripts/monitor-session-activity.sh