{"id":13897735,"url":"https://github.com/anuvyklack/vifmpane","last_synced_at":"2025-07-04T21:06:21.216Z","repository":{"id":107001578,"uuid":"415373450","full_name":"anuvyklack/vifmpane","owner":"anuvyklack","description":"Сhoose on which vifm pane to open the current working directory when you enter, and into which directory from which of the panes would you navigate at the exit.","archived":false,"fork":false,"pushed_at":"2021-10-12T22:11:48.000Z","size":10,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-04T05:26:35.879Z","etag":null,"topics":["shell","shell-script","vifm","vifmcd","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/anuvyklack.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}},"created_at":"2021-10-09T17:13:54.000Z","updated_at":"2022-01-06T07:34:04.000Z","dependencies_parsed_at":"2024-02-23T11:55:19.613Z","dependency_job_id":null,"html_url":"https://github.com/anuvyklack/vifmpane","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/anuvyklack/vifmpane","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anuvyklack%2Fvifmpane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anuvyklack%2Fvifmpane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anuvyklack%2Fvifmpane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anuvyklack%2Fvifmpane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anuvyklack","download_url":"https://codeload.github.com/anuvyklack/vifmpane/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anuvyklack%2Fvifmpane/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263619753,"owners_count":23489561,"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":["shell","shell-script","vifm","vifmcd","zsh-plugin"],"created_at":"2024-08-06T18:03:50.584Z","updated_at":"2025-07-04T21:06:21.198Z","avatar_url":"https://github.com/anuvyklack.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# vifmpane\n\nCurrently when you open vifm with `vifm .` the current path will be opened onto\nthe left pane, despite on which pane you would like to open it.\n\nThis script in intended to fix this behaviour and allows to choose on which\npane to open current path on enter, and into which directory from which of the\npanes to cd at the exit.\n\nThis script supports all types of vifm tabs: global and pane-wise (set with\n`set tabscope=pane`), and [vifmimg](https://github.com/cirala/vifmimg) script\n(if installed) which adds image preview with\n[Überzug](https://github.com/seebye/ueberzug) into vifm.\n\n## Installation\n\nYou may use your shell plugin manager.  For example, to install with\n[zsh-snap](https://github.com/marlonrichert/zsh-snap) (zsh plugin manager)\n`vifmpane` as well as `vifmimg` add next lines into your `.zshrc` file:\n\n```\nznap install cirala/vifmimg\nznap install anuvyklack/vifmpane\n```\n\nOr clone this repo and symlink `vifmpane` file into the directory that contains in\nthe `$PATH` variable: \n\n```\ngit clone --depth 1 https://github.com/anuvyklack/vifmpane.git\ncd vifmpane\nln -s $PWD/vifmpane $HOME/.local/bin/vifmpane\n```\n\n## Configuration\n\nThe behaviour of this script is configured with global variable `VIFM_PANE_STRATEGY`.\nThere are three strategies to choose on which vifm pane open `$PWD` and into\nwhich directory navigate on exit.  Default value is `last`.\n\n* `left` or `first` (both values are valid)\\\n  Sync shell with the vifm **left** pane.  On launch vifm the current path\n  `$PWD` will be opened onto **left** pane. On exit cd to the directory on the\n  vifm **left** pane.\n* `right` or `second` (both values are valid)\\\n  Sync shell with the vifm **right** pane. When launch vifm the current path\n  will be opened onto **right** pane. On exit cd to the directory on the vifm\n  **rigth** pane.\n* `last` (default)\\\n  On launch vifm the current path will be opened onto the vifm **last** active\n  pane from the previous time you leave vifm. On exit cd into the directory\n  from the **last** active pane.\n\n## Usage\n\nIn bash/zsh to navigate into selected directory on exit run:\n\n```\nsource vifmpane\n```\n\nit will execute the script in the current process but not in a subshell.\n\n### zsh\n\nTo open vifm in current directory with `Ctrl + o` keybinding add next lines\ninto your `.zshrc` file.\n\n```zsh\nvifmcd() {\n  zle .reset-prompt\n  BUFFER=\" source vifmpane\"\n  zle accept-line\n}\nzle -N vifmcd\n\n# \u003cC-o\u003e - Launch vifm and cd to the last directory after closing it.\nbindkey '^o' vifmcd\n```\n\n## Prerequisites\n\n* [jq](https://github.com/stedolan/jq) — vifm stores its data between\n  sessions in JSON format.  To install on Ubuntu/Debian execute:\n\n  ```\n  sudo apt-get install jq\n  ```\n\n* [vifmimg](https://github.com/cirala/vifmimg) — (optional) for image preview.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanuvyklack%2Fvifmpane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanuvyklack%2Fvifmpane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanuvyklack%2Fvifmpane/lists"}