Paolo Donadeo 487937f8cf feat(reminders): dynamically adjust popup width based on content
- Calculate the maximum line width of the reminders output in
  `show_reminders.sh`
- Pass the calculated width and a temporary file to the tmux popup in
  `main.sh`
- Ensure popup width is at least 40 and does not exceed the tmux window
  width
- Improve display by preventing horizontal scrolling and better fitting
  content
2025-12-27 12:12:58 +01:00
2025-12-24 11:12:07 +01:00

tmux-remind

A tmux plugin that integrates with 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 - A sophisticated calendar and alarm program
  • tmux 3.2+ (for display-popup support)

Installation

With TPM (Tmux Plugin Manager)

Add to your ~/.tmux.conf:

set -g @plugin 'your-username/tmux-remind'

Reload tmux and press prefix + I to install.

Manual Installation

git clone https://github.com/your-username/tmux-remind ~/.tmux/plugins/tmux-remind

Add to your ~/.tmux.conf:

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

Description
tmux and remind integration via popup
Readme MIT 54 KiB
Languages
Shell 100%