{"id":25938318,"url":"https://github.com/vifon/texas","last_synced_at":"2025-03-04T03:35:48.925Z","repository":{"id":33634252,"uuid":"37286602","full_name":"vifon/texas","owner":"vifon","description":"The integration of ranger with zsh/bash","archived":false,"fork":false,"pushed_at":"2018-05-27T14:45:50.000Z","size":29,"stargazers_count":29,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-03-11T21:34:20.456Z","etag":null,"topics":["bash","midnight-commander","ranger","tmux","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vifon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-11T21:14:49.000Z","updated_at":"2022-09-29T03:28:15.000Z","dependencies_parsed_at":"2022-09-13T05:03:35.564Z","dependency_job_id":null,"html_url":"https://github.com/vifon/texas","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Ftexas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Ftexas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Ftexas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vifon%2Ftexas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vifon","download_url":"https://codeload.github.com/vifon/texas/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241780475,"owners_count":20019057,"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":["bash","midnight-commander","ranger","tmux","zsh"],"created_at":"2025-03-04T03:35:48.374Z","updated_at":"2025-03-04T03:35:48.916Z","avatar_url":"https://github.com/vifon.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"texas\n=====\n\n`texas` creates a shell session synchronized with a [ranger][1]\nsession. Whenever one's current directory changes, so does the\nother. It was created as an alternative to a Midnight Commander\nfeature known as `ShowCommandLine` (which is bound to\n\u003ckbd\u003ectrl-o\u003c/kbd\u003e).\n\n[1]: https://github.com/hut/ranger\n\nINSTALLATION\n------------\n\nTL;DR: Run `./install.sh`. You don't need to read any further if\nyou're not interested what does it actually do.\n\nCurrently there is no support for the plugin managers such as\n[antigen](https://github.com/zsh-users/antigen) due to a bit tricky\nloading process. If you use them, be sure to load `texas` after\nloading the plugins managed by the manager. I've encountered some\nstrange hard to track issues otherwise.\n\n**INSTALLATION DETAILS**\n\nThe installation is comprised of two steps: installing a `ranger`\nplugin and installing a shell plugin. Both are mandatory.\n\nAn unattended installation may be performed like this:\n\n    $ yes | ./install.sh\n\n**Step 1: Install ranger plugin**\n\nCopy `texas.py` to `~/.config/ranger/plugins`.\n\n**Step 2: Install shell plugin**\n\n**bash**\n\nSource the `texas.bash` file by adding the line `source\n/path/to/texas.bash` to your `.bashrc`.\n\n**zsh**\n\nFirst copy the file `texas.zsh` to your `$fpath` and rename it to just\n`texas` (remove the `.zsh` suffix). After that, source the\n`texas_init.zsh` file by adding the line `source\n/path/to/texas_init.zsh` to your `.zshrc`.\n\nUSAGE\n-----\n\n`texas` uses [tmux][2] internally. Although knowledge of how to use\n`tmux` is not necessary, the user will certainly benefit from it.\n\n[2]: http://tmux.github.io/\n\n**Startup**\n\n`texas` may be started either from inside an existing `tmux` session\nor from a regular shell session. In the first case, it will use the\ncurrent `tmux` window and in the second case it will create a new\n`tmux` session **in a separate tmux daemon automatically named\n\"texas\"**.\n\nIf you launch `texas` from an existing `tmux` session, you may quit\n`ranger` and the shell should still be running just as before\nlaunching `texas`.\n\nIf you launch `texas` outside of an existing `tmux` session, `ranger`\nand the shell are bound together: closing one will close the other and\nin that regard they may be considered as a single application. If you\nopen any more `tmux` windows (which `texas` by all means does not\ndiscourage), they will *not* be closed. Only `ranger` and the\nassociated shell will close leaving all the other `tmux` windows\nintact.\n\n**Switching windows**\n\nIf you run `texas` in a new `tmux` session (see the previous\nparagraph), you may use \u003ckbd\u003ectrl-o\u003c/kbd\u003e to switch between windows,\nlike in Midnight Commander. The regular `tmux` keys for switching\nwindows will work too (please refer to the `tmux` manual).\n\u003ckbd\u003ectrl-o\u003c/kbd\u003e has one advantage though (other than being shorter):\nit will work even if you move one of the `tmux` panes to a separate\n`tmux` window (for example with the `:break-pane` `tmux` command) as\nit intelligently switches either to a second split or a second window.\n\nBefore `v1.0` it was supported only in `zsh`. Since `v1.0` it works in\n`bash` too.\n\nSince `v1.1` \u003ckbd\u003ectrl-o\u003c/kbd\u003e is bound in `tmux` itself. Before that\nit was handled by `bash`/`zsh` and `ranger`.\n\nSince `v1.2` \u003ckbd\u003ectrl-o\u003c/kbd\u003e is bound only when run in a new\n`tmux` daemon to prevent contaminating the all the other tmux sessions\nwith this keybinding.\n\nCONFIGURATION\n-------------\n\nThe followind environmental variables may be used to customize `texas`:\n\n- **TEXAS_CONFIG_NOSWAP** — display `ranger` below the shell instead\n  of on top of it (set to \"1\" to enable)\n- **TEXAS_CONFIG_SIZE** — customize the size of the `ranger` pane,\n  as percentage (default: 70).\n- **TEXAS_CONFIG_TMUX_CONFIG** — an *additional* `tmux` config to\n  source after starting `texas`. Only used in a dedicated `tmux`\n  session, i.e. when `texas` is started from outside of an already\n  running `tmux`.\n- **TEXAS_CONFIG_SWITCH_KEY** — a `tmux` key to be bound in a\n  dedicated `tmux` session for the pane switching (default:\n  \u003ckbd\u003eC-o\u003c/kbd\u003e)\n- **TEXAS_CONFIG_HORIZONTAL** - start tmux with `-h` flag thus\n  making split horizontal instead of vertical (default). Set to\n  \"1\" to enable.\n\nDEPENDENCIES\n------------\n\n- `ranger`\n- `tmux`\n- `bash` or `zsh`\n\nKNOWN ISSUES\n------------\n\nIf used with `bash`, each time `ranger` changes its current directory\na new prompt line will be shown in `bash`. It will erase the contents\nof the command line and may be seen as ugly.\n\nIn `tmux 2.1` with `TEXAS_CONFIG_NOSWAP=0` the wrong pane is being\nfocused. It can be fixed by manually adding `-d` to the `tmux\nswap-pane` call. I've detected this behavior only in `tmux 2.1`. In\nboth `2.0` and `2.2` `-d` causes the exactly opposite effect, so it\nseems to be a bug in `tmux 2.1`.\n\nSEE ALSO\n--------\n\n`ranger(1)`, `tmux(1)`\n\nAUTHOR\n------\n\nWojciech 'vifon' Siewierski \u003c wojciech dot siewierski at onet dot pl \u003e\n\nCOPYRIGHT\n---------\n\nCopyright (C) 2015-2016  Wojciech Siewierski\n\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License\nalong with this program.  If not, see \u003chttp://www.gnu.org/licenses/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvifon%2Ftexas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvifon%2Ftexas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvifon%2Ftexas/lists"}