• Stars
    star
    308
  • Rank 135,712 (Top 3 %)
  • Language
    Shell
  • License
    MIT License
  • Created over 9 years ago
  • Updated 10 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Quickly open any path on your terminal window in your $EDITOR of choice!

Tmux fpp

Plugin wrapper around Facebook PathPicker.

Quickly open any path on your terminal window in your $EDITOR of choice!

Demo

Demo tmux-fpp

Dependencies

  • fpp - Facebook PathPicker.

Key bindings

  • prefix + f - open a new window with a fpp selection of your current tmux pane.

Installation with Tmux Plugin Manager (recommended)

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

set -g @plugin 'tmux-plugins/tmux-fpp'

Hit prefix + I to fetch the plugin and source it. You should now be able to use the plugin.

Manual Installation

Clone the repo:

$ git clone https://github.com/tmux-plugins/tmux-fpp ~/clone/path

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

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

Reload TMUX environment:

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

You should now be able to use the plugin.

Configuration

How can I change the default "f" key binding to something else? For example, key "x"?

Put set -g @fpp-key 'x' in tmux.conf.

How can I paste the selected file paths into my original pane, instead of launching an editor?

Put set -g @fpp-mode 'paste' in tmux.conf.

Alternatively you can bind both behaviours to different keys manually:

# Disable default binding
set -g @fpp-bind off

# Bind 'f' to run FPP launching an editor
bind-key f run-shell '~/.tmux/plugins/tmux-fpp start edit'

# Bind 'x' to run FPP and paste the list of files in the initial pane
bind-key x run-shell '~/.tmux/plugins/tmux-fpp start paste'

How can I specify custom path to fpp?

Put set -g @fpp-path '~/my/path/fpp' in tmux.conf.

Other goodies

tmux-fpp works great with:

  • tmux-urlview - a plugin for quickly opening any url on your terminal window
  • tmux-copycat - a plugin for regex searches in tmux and fast match selection
  • tmux-yank - enables copying highlighted text to system clipboard

License

MIT

More Repositories

1

tpm

Tmux Plugin Manager
Shell
12,082
star
2

tmux-resurrect

Persists tmux environment across system restarts.
Shell
11,249
star
3

tmux-continuum

Continuous saving of tmux environment. Automatic restore when tmux is started. Automatic tmux start when computer is turned on.
Shell
3,263
star
4

tmux-yank

Tmux plugin for copying to system clipboard. Works on OSX, Linux and Cygwin.
Shell
2,682
star
5

tmux-sensible

basic tmux settings everyone can agree on
Shell
1,756
star
6

list

A list of tmux plugins.
1,201
star
7

tmux-copycat

A plugin that enhances tmux search
Shell
1,103
star
8

tmux-logging

Easy logging and screen capturing for Tmux.
Shell
1,034
star
9

tmux-pain-control

standard pane key-bindings for tmux
Shell
755
star
10

tmux-open

Tmux key bindings for quick opening of a highlighted file or url
Shell
631
star
11

tmux-prefix-highlight

Plugin that highlights when you press tmux prefix key
Shell
571
star
12

tmux-sidebar

A sidebar with the directory tree for the current path. Tries to make tmux more IDE like.
Shell
536
star
13

tmux-battery

Plug and play battery percentage and icon indicator for Tmux.
Shell
499
star
14

tmux-cpu

Plug and play cpu percentage and icon indicator for Tmux.
Shell
433
star
15

tmux-sessionist

Lightweight tmux utils for manipulating sessions
Shell
412
star
16

vim-tmux-focus-events

Make terminal vim and tmux work better together.
Vim Script
348
star
17

vim-tmux

vim plugin for tmux.conf
Vim Script
333
star
18

tmux-urlview

Quickly open any url on your terminal window!
Shell
266
star
19

tmux-online-status

Tmux plugin that displays online status of your computer.
Shell
169
star
20

tmux-example-plugin

Example Tmux plugin that actually demonstrates how to build plugins for Tmux. The accompanying tutorial is here: https://github.com/tmux-plugins/tpm/blob/master/HOW_TO_PLUGIN.md
Shell
45
star
21

tmux-cowboy

Kill hanging processes fast
Shell
37
star
22

tmux-maildir-counter

Plugin that counts files on a specific mail directory
Shell
32
star
23

tmux-test

A small framework for isolated testing of tmux plugins.
Shell
16
star
24

language-tmux

Atom language support for Tmux config file
CoffeeScript
10
star
25

tmux-newsboat

Display newsboat counters in tmux status line.
Shell
10
star