Package: ranger-tmux
ranger-tmuxTmux integration for rangerInstallTo 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 installFeaturesOpen files from ranger in a new tmux window or paneMake your terminal track ranger's directoryMake ranger track your terminal's directorySet tmux window title to show ranger is runningDrop down file-manager in your tmux sessionEasily split a ranger pane to launch a shell in the current folderOther pane tracking & syncingThis 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:A marked pane;The currently selected pane;The last selected pane;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 typingcdcommands if you have launched a text editor from the shell in the other pane.Drop-down rangerWhen installing the plugin, you will be asked if you want to install a key-binding in~/.tmux.conffor 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 runningpython -m ranger_tmux.dropin a tmux session.The key binding can be installed by runningpython -m ranger_tmux --tmux install, or by running the:install_tmux_dropdown_shortcutcommand in ranger (or typing thexhshortcut). The default key-binding installed isprefix, backspace, but this can be changed by editing the lines added to~/.tmux.conf.Shortcut keysKey SequenceCommandxcChange the current working directory in the other pane to the directory in rangerxdChange ranger's current directory to the directory of the other panexsToggle syncing of ranger's current directory to the other panextToggle tracking of the other pane's working directory to tmuxxwToggle opening files in a new tmux windowxiToggle setting the tmux window's title to "ranger" when ranger is runningxeOpen the selected file with rifle in a new tmux windowx|Split ranger's current tmux pane vertiallyx-Split ranger's current tmux pane horizontallyxhAdds the dropdown shortcut to~/.tmux.confSettingsThis plugin adds several settings to ranger:SettingTypeDefaultMeaningtmux_cwd_syncboolFalseWhen True, ranger's current directory is synced to the other panetmux_cwd_sync_now_focusboolFalseWhen True, the other pane will be focused after manually syncing it with rangertmux_cwd_trackboolFalseWhen True, ranger's current directory tracks the other panetmux_cwd_track_intervalfloat0.5Time between checks of the directory of the other pane when trackingtmux_open_in_windowboolTrueWhen True, files opened with ranger will open in a new tmux windowtmux_set_titleboolTrueWhen True, the tumx window will be renamed to "ranger" when ranger is runningtmux_dropdown_percentint60The height of the pane created when the drop-down tmux key-binding is installed and usedtmux_dropdown_animateboolTrueWhen True, dropped-down ranger will grow / shrink when summonedtmux_dropdown_durationfloat100Drop-down animation time in milisecondsThe 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