ranger-tmux

Tmux integration for ranger

Install

To install this plugin, clone the respository into ranger's plugins folder, or install it with pip:

pip install ranger-tmux
# Then run this to install the package as a ranger plugin:
python -m ranger_tmux install

Features

• Open files from ranger in a new tmux window or pane
• Make your terminal track ranger's directory
• Make ranger track your terminal's directory
• Set tmux window title to show ranger is running
• Drop down file-manager in your tmux session
• Easily split a ranger pane to launch a shell in the current folder

Other pane tracking & syncing

This plugin enables syncing of the current working directory between ranger and other tmux panes in the same window.

The pane to be used for syncing or tracking is determined in the following order:

1. A marked pane;
2. The currently selected pane;
3. The last selected pane;
4. The next pane.

Ranger will only sync its working directory to another pane if the process running in another pane does not have any child processes. This prevents ranger typing cd commands if you have launched a text editor from the shell in the other pane.

Drop-down ranger

When installing the plugin, you will be asked if you want to install a key-binding in ~/.tmux.conf for drop-down ranger. This allows you to toggle ranger in a drop-down tmux pane in the current window. This can be run manually by running python -m ranger_tmux.drop in a tmux session.

The key binding can be installed by running python -m ranger_tmux --tmux install, or by running the :install_tmux_dropdown_shortcut command in ranger (or typing the xh shortcut). The default key-binding installed is prefix, backspace, but this can be changed by editing the lines added to ~/.tmux.conf.

Shortcut keys

Settings

This plugin adds several settings to ranger:

The default values can be modified by setting them in ~/.config/ranger/rc.conf, e.g.:

set tmux_cwd_sync true
set tmux_cwd_track true
set tmux_set_title true
set tmux_open_in_window true
set tmux_dropdown_percent 60