65 lines
1.6 KiB
Markdown
65 lines
1.6 KiB
Markdown
# tmux-remind
|
|
|
|
A tmux plugin that integrates with [remind](https://dianne.skoll.ca/projects/remind/) to display reminders and calendar views in tmux popups.
|
|
|
|
## Features
|
|
|
|
- **Quick Reminders View**: Display today's reminders in a centered popup (60% width/height)
|
|
- **Calendar View**: Show a 2-week calendar overview in a full-screen popup (99% width/height)
|
|
- Uses `less` for scrollable output with line position indicator
|
|
|
|
## Requirements
|
|
|
|
- [remind](https://dianne.skoll.ca/projects/remind/) - A sophisticated calendar and alarm program
|
|
- tmux 3.2+ (for `display-popup` support)
|
|
|
|
## Installation
|
|
|
|
### With [TPM](https://github.com/tmux-plugins/tpm) (Tmux Plugin Manager)
|
|
|
|
Add to your `~/.tmux.conf`:
|
|
|
|
```bash
|
|
set -g @plugin 'git@git.donadeo.net:pdonadeo/tmux-remind'
|
|
```
|
|
|
|
Reload tmux and press `prefix + I` to install.
|
|
|
|
### Manual Installation
|
|
|
|
```bash
|
|
git clone https://git.donadeo.net/pdonadeo/tmux-remind.git ~/.tmux/plugins/tmux-remind
|
|
```
|
|
|
|
Add to your `~/.tmux.conf`:
|
|
|
|
```bash
|
|
run-shell ~/.tmux/plugins/tmux-remind/tmux-remind.tmux
|
|
```
|
|
|
|
## Usage
|
|
|
|
The plugin provides two keybindings:
|
|
|
|
| Keybinding | Action |
|
|
|------------|--------|
|
|
| `prefix + r` | Show today's reminders in a popup |
|
|
| `prefix + c` | Show 2-week calendar in a popup |
|
|
|
|
### Navigation
|
|
|
|
Both views use `less` for navigation:
|
|
|
|
- `j` / `k` or arrow keys to scroll
|
|
- `q` to close the popup
|
|
- `/` to search
|
|
- `g` to go to top, `G` to go to bottom
|
|
|
|
## Configuration
|
|
|
|
The plugin uses your default `remind` configuration. Make sure you have your `.reminders` file set up in your home directory or configure remind accordingly.
|
|
|
|
## License
|
|
|
|
MIT
|