https://github.com/arkane-systems/tmux-taskman
A pop-down task manager for tmux.
https://github.com/arkane-systems/tmux-taskman
plugin tasks tmux top tpm
Last synced: 7 months ago
JSON representation
A pop-down task manager for tmux.
- Host: GitHub
- URL: https://github.com/arkane-systems/tmux-taskman
- Owner: arkane-systems
- License: mit
- Created: 2019-09-07T01:22:26.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-09-15T00:34:09.000Z (about 6 years ago)
- Last Synced: 2025-01-16T13:54:14.450Z (9 months ago)
- Topics: plugin, tasks, tmux, top, tpm
- Language: Shell
- Size: 313 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# tmux-taskman
[](https://ko-fi.com/I3I1VA18)
Based extensively on Bruno Sutic's tmux-sidebar ( https://github.com/tmux-plugins/tmux-sidebar ),
tmux-taskman also does one thing: it opens a task manager (htop if available, otherwise top, by
default) pane. A fast and convenient what's-going-on check whatever you're doing in tmux.
## Features:
* toggles on and off with one key binding, which may or may not focus the pane
* remembers its size
* preserves layout
## Requirements:
* tmux 1.9 or higher, top; htop recommended but not required
## Key bindings:
* prefix + ` - toggle task manager but do not focus it
* prefix + ~ - toggle task manager and focus it
## Installation:
Use [Tmux Plugin Manager](https://github.com/tmux-plugins/tpm) and add this plugin
to your `.tmux.conf`:
```
set -g @plugin 'tmux-plugins/tmux-sidebar'
```
Hit prefix + I to fetch the plugin and source it. You should now be able to use the plugin.
## Customization:
To change the keybindings:
```
set -g @taskman-task '\`'
set -g @taskman-task-focus '~'
```
To change the command run as the task manager:
```
set -g @taskman-task-command 'atop'
```
To make it appear at the bottom instead of the top:
```
set -g @taskman-task-position 'bottom'
```