extrakto for tmux

Output completions - you can complete commands that require you to retype text that is already on the screen. This works everywhere, even in remote ssh sessions.

You can fuzzy find your text instead of selecting it by hand:

• press tmux prefix + tab to start extrakto
• fuzzy find the text/path/url/line
• use custom filters (ctrl + f)
• press
  • tab to insert it to the current pane,
  • enter to copy it to the clipboard,
• see other features in HELP (press ctrl-h in extrakto)

Use it for paths, URLs, options from a man page, git hashes, docker container names, ...

Installation

Requires

• tmux
• fzf
• Python 3.6+
• Bash (tested with 5.0+, on macOS please brew install bash first)

Supported clipboards:

• Linux (xclip)
• macOS (pbcopy)
• WSL (aka "Bash on Windows")
• bring your own

tmux beta

Because tmux with popups will not be released before/around May 2021 you may wish to install the master/beta version.

• On Arch: trizen -S tmux-git or yay -S tmux-git (see your AUR package manager)
• On macOS with homebrew: brew install tmux --HEAD

If you do not wish to install the beta extrakto will open in a split window.

a: with Tmux Plugin Manager

Add the plugin to the list of TPM plugins in .tmux.conf:

set -g @plugin 'laktak/extrakto'

Hit prefix + I to fetch the plugin and source it.

You should now have all extrakto key bindings defined.

b: Manual Installation

Clone the repo:

$ git clone https://github.com/laktak/extrakto ~/clone/path

Add this line to the bottom of .tmux.conf:

run-shell ~/clone/path/extrakto.tmux

Reload the tmux environment:

# type this in terminal
$ tmux source-file ~/.tmux.conf

You should now have all extrakto key bindings defined.

Wiki

Add or look for special tips in our wiki.

Options

To set any of these options write on your ~/.tmux.conf file:

set -g <option> "<value>"

Where <option> and <value> are one of the specified here:

Example:

set -g @extrakto_split_size "15"
set -g @extrakto_clip_tool "xsel --input --clipboard" # works better for nvim
set -g @extrakto_copy_key "tab"      # use tab to copy to clipboard
set -g @extrakto_insert_key "enter"  # use enter to insert selection

Custom Filters

You can define your own filters by creating a file in ~/.config/extrakto/extrakto.conf:

[quote]
regex: ("[^"\n\r]+")

To override an existing filter copy it to your file first.

See extrakto.conf for syntax and predefined filters.

CLI

You can also use extrakto as a standalone tool to extract tokens from text.

Installation

For now simply clone the repository and link to the tool somewhere in your path:

git clone https://github.com/laktak/extrakto
cd extrakto
# assuming you `export PATH=$PATH:~/.local/bin` in your `.bashrc`:
ln -s $PWD/extrakto.py ~/.local/bin/extrakto

Requires Python 3.6+.

CLI Usage

usage: extrakto.py [-h] [--name] [-w] [-l] [--all] [-a ADD] [-p] [-u] [--alt] [-r] [-m MIN_LENGTH] [--warn-empty]

Extracts tokens from plaintext.

optional arguments:
  -h, --help            show this help message and exit
  --name                prefix filter name in the output
  -w, --words           extract "word" tokens
  -l, --lines           extract lines
  --all                 extract using all filters defined in extrakto.conf
  -a ADD, --add ADD     add custom filter
  -p, --paths           short for -a=path
  -u, --urls            short for -a=url
  --alt                 return alternate variants for each match (e.g. https://example.com and example.com)
  -r, --reverse         reverse output
  -m MIN_LENGTH, --min-length MIN_LENGTH
                        minimum token length
  --warn-empty          warn if result is empty

Contributions

Thanks go to all contributors for their ideas and PRs!

Please run black if you change any python code and run shfmt if you change any bash files.