Skip to content

Commit 4132eec

Browse files
committed
docs: improve documentation
1 parent b4683c2 commit 4132eec

File tree

2 files changed

+25
-19
lines changed

2 files changed

+25
-19
lines changed

README.md

Lines changed: 24 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,13 @@
88

99
Tmux plugin to notify you when processes are complete.
1010

11-
Notification is via libnotify and visual bell raised in the tmux window. Visual bells can be mapped (in the terminal level) to X11 urgency bit and handled by your window manager.
11+
Notifications are done via libnotify, and visual bells are raised in the tmux window. Visual bells can be mapped (in the terminal level) to X11 urgency bit and handled by your window manager.
1212

1313
## Use cases
1414

1515
- When you have already started a process in a pane and wish to be notified, that is when you can't use a manual trigger.
16-
- Working in different containers (Docker) -> can't choose the shell -> and can't use a shell level feature
17-
- Working over ssh, but your tmux is on the client-side
16+
- Working in different containers (Docker) -> can't choose the shell -> and can't use a shell-level feature
17+
- Working over ssh, but your Tmux is on the client-side
1818

1919
## Install
2020

@@ -28,15 +28,11 @@ Use `prefix + I` to install.
2828

2929
## Usage
3030

31-
`prefix + m`: Start monitoring a pane and notify when it finishes.
31+
- `prefix + m`: Start monitoring a pane and notify when it finishes.
3232

33-
`prefix + alt + m`: Start monitoring a pane, return it in focus and notify when it finishes.
33+
- `prefix + alt + m`: Start monitoring a pane, return it in focus and notify when it finishes.
3434

35-
`prefix + ctrl + M`: Start monitoring pane and notify in bash and telegram when it finishes.
36-
37-
`prefix + ctrl + alt + M`: Start monitoring a pane, return it in focus and notify in bash and telegram when it finishes.
38-
39-
`prefix + M`: Cancel monitoring of a pane.
35+
- `prefix + M`: Cancel monitoring of a pane.
4036

4137
## Pre-requisites
4238

@@ -51,13 +47,13 @@ Use `prefix + I` to install.
5147

5248
### Enable verbose notification
5349

54-
By default, the notification text is set to `Tmux pane task completed!`. We have also included a verbose output option. When enabled, information about the pane, window, and session the task has completed is given.
50+
The notification text is defaulted to `Tmux pane task completed!`. We have also included a verbose output option. Information about the pane, window, and session the task has completed is given when enabled.
5551

56-
Put `set -g @tnotify-verbose 'on'` in the `.tmux.conf` config file to enable this.
52+
To enable this, put `set -g @tnotify-verbose 'on'` in the `.tmux.conf` config file.
5753

5854
#### Change the verbose notification message
5955

60-
To change the verbose notification text, put `set -g @tnotify-verbose-msg 'put your notification text here'` in the `.tmux.conf` config file. You can use all the tmux variables in your notification text. Some useful tmux aliases are:
56+
To change the verbose notification text, put `set -g @tnotify-verbose-msg 'put your notification text here'` in the `.tmux.conf` config file. You can use all the Tmux variables in your notification text. Some useful Tmux aliases are:
6157

6258
- `#D`: Pane id
6359
- `#P`: Pane index
@@ -66,23 +62,33 @@ To change the verbose notification text, put `set -g @tnotify-verbose-msg 'put y
6662
- `#I`: Window index
6763
- `#W`: Window name
6864

69-
For the full list of aliases and variables you are referred to the `FORMATS` section of the [tmux manual](http://man7.org/linux/man-pages/man1/tmux.1.html).
65+
For the complete list of aliases and variables, you are referred to the `FORMATS` section of the [tmux manual](http://man7.org/linux/man-pages/man1/tmux.1.html).
7066

7167
### Enable telegram channel notifications
7268

73-
To enable telegram channel notifications, put `set -g @tnotify-telegram-bot-id 'your telegram bot id'` and `set -g @tnotify-telegram-channel-id 'your channel id'` in the `.tmux.conf` config file. You can get your telegram bot id by creating a bot using [BotFather](https://core.telegram.org/bots#6-botfather) and your channel id by sending your channel invite link to the `@username_to_id_bot` bot. After this, you can use the telegram keybindings in the [usage](#usage) section to start a monitor with telegram channel notifications.
69+
By default, the notification is only sent to the operating system. We have also included a telegram channel notification option. When enabled, a notification is sent to a user-specified telegram channel.
70+
71+
Put both `set -g @tnotify-telegram-bot-id 'your telegram bot id'` and `set -g @tnotify-telegram-channel-id 'your channel id'` in the `.tmux.conf` config file to enable this. Additionally, you can use the `set -g @tnotify-telegram-all 'on'` option to send all notifications to telegram. After enabling this option, the following key bindings are available:
72+
73+
- `prefix + ctrl + M`: Start monitoring pane and notify in bash and telegram when it finishes.
74+
75+
- `prefix + ctrl + alt + M`: Start monitoring a pane, return it in focus and notify in bash and telegram when it finishes.
76+
77+
> **Note**
78+
> You can get your telegram bot id by creating a bot using [BotFather](https://core.telegram.org/bots#6-botfather) and your channel id by sending your channel invite link to the `@username_to_id_bot` bot.
7479
7580
### Change monitor update period
7681

7782
By default, the monitor sleep period is set to 10 seconds. This means that tmux-notify checks the pane activity every 10 seconds.
7883

79-
Put `set -g @tnotify-sleep-duration 'desired duration" in the`.tmux.conf\` file to change this duration.
84+
Put `set -g @tnotify-sleep-duration 'desired duration'` in the `.tmux.conf` file to change this duration.
8085

81-
**NOTE:** Keep in mind that there is a trade-off between notification speed (short sleep duration) and the amount of memory this tool needs.
86+
> **Warning**
87+
> Remember that there is a trade-off between notification speed (short sleep duration) and the amount of memory this tool needs.
8288
8389
### Add additional shell suffixes
8490

85-
The tmux notify script uses your shell prompt suffix to check whether a command has finished. It looks for the `$`, `#` and `%` suffixes by default. If you customise your shell to use different shell suffixes, you can add them by putting `set -g @tnotify-prompt-suffixes 'put your comma-separated bash suffix list here'` in the`.tmux.conf` file.
91+
The Tmux notify script uses your shell prompt suffix to check whether a command has finished. By default, it looks for the `$`, `#` and `%` suffixes. If you customise your shell to use different shell suffixes, you can add them by putting `set -g @tnotify-prompt-suffixes 'put your comma-separated bash suffix list here'` in the `.tmux.conf` file.
8692

8793
Feel free to open [a pull](https://github.com/ChanderG/tmux-notify/pulls) request or [issue](https://github.com/ChanderG/tmux-notify/issues) if you think your shell prompt suffix should be included by default.
8894

scripts/variables.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ export prompt_suffixes_default="$,#,%"
2222
export verbose_option="@tnotify-verbose"
2323
export verbose_default="off"
2424
export verbose_msg_option="@tnotify-verbose-msg"
25-
export verbose_msg_default="(#S, #I:#P:#W) Tmux pane task completed!"
25+
export verbose_msg_default="(#S, #I:#P) Tmux pane task completed!"
2626

2727
# Monitor checker interval
2828
export monitor_sleep_duration="@tnotify-sleep-duration"

0 commit comments

Comments
 (0)