{"id":13696650,"url":"https://github.com/joouha/ranger_tmux","last_synced_at":"2025-03-16T18:32:27.596Z","repository":{"id":57459953,"uuid":"354886589","full_name":"joouha/ranger_tmux","owner":"joouha","description":"Tmux integration for ranger","archived":false,"fork":false,"pushed_at":"2023-08-28T16:54:50.000Z","size":72,"stargazers_count":39,"open_issues_count":6,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-13T02:37:11.120Z","etag":null,"topics":["ranger-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/joouha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-04-05T15:47:44.000Z","updated_at":"2025-01-26T18:32:03.000Z","dependencies_parsed_at":"2024-10-27T11:08:40.642Z","dependency_job_id":"60e39875-4090-4363-be91-3270eb80084b","html_url":"https://github.com/joouha/ranger_tmux","commit_stats":{"total_commits":49,"total_committers":3,"mean_commits":"16.333333333333332","dds":"0.16326530612244894","last_synced_commit":"0f1ddbcad7a931680d45d03c4b684de6d4a26b6c"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joouha%2Franger_tmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joouha%2Franger_tmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joouha%2Franger_tmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joouha%2Franger_tmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joouha","download_url":"https://codeload.github.com/joouha/ranger_tmux/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243826780,"owners_count":20354220,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ranger-plugin"],"created_at":"2024-08-02T18:00:44.166Z","updated_at":"2025-03-16T18:32:22.586Z","avatar_url":"https://github.com/joouha.png","language":"Python","funding_links":[],"categories":["Plugins"],"sub_categories":[],"readme":"# ranger-tmux\n\nTmux integration for ranger\n\n## Install\n\nTo install this plugin, clone the respository into ranger's plugins folder, or install it with pip:\n\n```\npip install ranger-tmux\n# Then run this to install the package as a ranger plugin:\npython -m ranger_tmux install\n```\n\n## Features\n\n\u003cimg src=\"https://i.postimg.cc/SRz46CNH/output.gif\" align=\"right\" width=300\u003e\n\n- Open files from ranger in a new tmux window or pane\n- Make your terminal track ranger's directory\n- Make ranger track your terminal's directory\n- Set tmux window title to show ranger is running\n- Drop down file-manager in your tmux session\n- Easily split a ranger pane to launch a shell in the current folder\n\n### Other pane tracking \u0026 syncing\n\nThis plugin enables syncing of the current working directory between ranger and other tmux panes in the same window.\n\nThe pane to be used for syncing or tracking is determined in the following order:\n\n1. A marked pane;\n2. The currently selected pane;\n3. The last selected pane;\n4. The next pane.\n\nRanger 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.\n\n### Drop-down ranger\n\nWhen 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.\n\nThe 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`.\n\n## Shortcut keys\n\n| Key Sequence | Command                                                                           |\n| ------------ | --------------------------------------------------------------------------------- |\n| `xc`         | Change the current working directory in the other pane to the directory in ranger |\n| `xd`         | Change ranger's current directory to the directory of the other pane              |\n| `xs`         | Toggle syncing of ranger's current directory to the other pane                    |\n| `xt`         | Toggle tracking of the other pane's working directory to tmux                     |\n| `xw`         | Toggle opening files in a new tmux window                                         |\n| `xi`         | Toggle setting the tmux window's title to \"ranger\" when ranger is running         |\n| `xe`         | Open the selected file with rifle in a new tmux window                            |\n| `x\\|`        | Split ranger's current tmux pane vertially                                        |\n| `x-`         | Split ranger's current tmux pane horizontally                                     |\n| `xh`         | Adds the dropdown shortcut to `~/.tmux.conf`                                      |\n\n## Settings\n\nThis plugin adds several settings to ranger:\n\n| Setting                   | Type  | Default | Meaning                                                                                  |\n| ------------------------- | ----- | ------- | ---------------------------------------------------------------------------------------- |\n| `tmux_cwd_sync`           | bool  | False   | When True, ranger's current directory is synced to the other pane                        |\n| `tmux_cwd_sync_now_focus` | bool  | False   | When True, the other pane will be focused after manually syncing it with ranger          |\n| `tmux_cwd_track`          | bool  | False   | When True, ranger's current directory tracks the other pane                              |\n| `tmux_cwd_track_interval` | float | 0.5     | Time between checks of the directory of the other pane when tracking                     |\n| `tmux_open_in_window`     | bool  | True    | When True, files opened with ranger will open in a new tmux window                       |\n| `tmux_set_title`          | bool  | True    | When True, the tmux window will be renamed to \"ranger\" when ranger is running            |\n| `tmux_dropdown_percent`   | int   | 60      | The height of the pane created when the drop-down tmux key-binding is installed and used |\n| `tmux_dropdown_animate`   | bool  | True    | When True, dropped-down ranger will grow / shrink when summoned                          |\n| `tmux_dropdown_duration`  | float | 100     | Drop-down animation time in miliseconds                                                  |\n\nThe default values can be modified by setting them in `~/.config/ranger/rc.conf`, e.g.:\n\n```\nset tmux_cwd_sync true\nset tmux_cwd_track true\nset tmux_set_title true\nset tmux_open_in_window true\nset tmux_dropdown_percent 60\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoouha%2Franger_tmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoouha%2Franger_tmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoouha%2Franger_tmux/lists"}