neo-oli / tmux-text-macros

Tmux plugins for defining text macros

tmux-text-macros is a tmux plugin. It let's you define a bunch of strings, from which you can choose by pressing Prefix + e.

By default it contains all the emojis and a few emoticons

Requirements

• fzf
• fzf-tmux

Installation

1. clone repository to ~/.tmux/plugins/
2. add run-shell ~/.tmux/plugins/tmux-text-macros/tmux-text-macros.tmux to your ~/.tmux.conf
3. run tmux source ~/.tmux.conf to enable the changes

Configuration

You can add your own custom macros to ~/.tmux/custom-macros. You can use the custom-macros file as a template.

If you want to disable all the default macros put set -g @ttm-load-default-macros off before loading the plugin in your .tmux.conf

Options

@ttm-load-default-macros (default: "on")

Disable all the default macros. Use this if you want to hide all emojis and just use your custom macros

@ttm-window-mode (default: "horizontal")

How to split the tmux window

• horizontal
• vertical
• full -> new window

@ttm-keybind (default: "e")

Setting the keybind for tmux-text-macros to execute.

Usage

Press Prefix e (normally Ctrl+b e) and choose a string by choosing it with the arrow keys or by entering a search string and press enter.

tmux-text-macros's Issues

[Request] Escape for tmux special-keys

I have a few Macro's I'd like to have newlines. Adding support for escaping tmux special keys would make this possible.

https://stackoverflow.com/questions/19313807/tmux-send-keys-syntax#19330452

Error message when using prefix + e to invoke tmux-text-macros extension

Description:
When I press the prefix key followed by the "e" key to invoke the tmux-text-macros extension, it prints the following error message on the terminal:

"tmux split-window -h -n Macros "PANE='%0' /home/fedora/.tmux/plugins/tmux-text-macros/tmux-text-macros.tmux -r"' returned 1"

This error occurs even though I have not made any changes to the default keys.

Steps to reproduce:

• Install the tmux-text-macros extension.
• Open a tmux session.
• Press the prefix key followed by "e" to invoke the extension.

Expected behavior:
The tmux-text-macros extension should be invoked and work as expected without any error messages.

Actual behavior:
An error message is displayed on the terminal as described above.

Environment:

Operating system: Fedora 36
Terminal emulator: xfce4-terminal
Tmux version: tmux 3.3a

[Request] Option to bind alternate key

I use prefix e to open my tmux config in nvim. It would be nice to change key binding without changing the source code.