{"id":13587242,"url":"https://github.com/chmouel/zsh-select-with-lf","last_synced_at":"2025-04-23T16:03:53.937Z","repository":{"id":197436228,"uuid":"698650797","full_name":"chmouel/zsh-select-with-lf","owner":"chmouel","description":"Zsh plugin to select a file or directory with LF","archived":false,"fork":false,"pushed_at":"2023-11-29T22:15:32.000Z","size":13,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-23T16:03:21.981Z","etag":null,"topics":["lf","zsh","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":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chmouel.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}},"created_at":"2023-09-30T14:52:20.000Z","updated_at":"2025-03-23T17:29:20.000Z","dependencies_parsed_at":"2023-11-29T23:26:31.316Z","dependency_job_id":"21e1b3ec-8349-4057-ae8f-120729e816c3","html_url":"https://github.com/chmouel/zsh-select-with-lf","commit_stats":null,"previous_names":["chmouel/zsh-select-with-lf"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fzsh-select-with-lf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fzsh-select-with-lf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fzsh-select-with-lf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Fzsh-select-with-lf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chmouel","download_url":"https://codeload.github.com/chmouel/zsh-select-with-lf/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250468273,"owners_count":21435452,"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":["lf","zsh","zsh-plugin"],"created_at":"2024-08-01T15:06:07.125Z","updated_at":"2025-04-23T16:03:53.916Z","avatar_url":"https://github.com/chmouel.png","language":"Shell","funding_links":[],"categories":["Plugins","Shell"],"sub_categories":["ZSH on Windows"],"readme":"# Select files or directories with lf\n\nA simple plugin to let you select some files or a directory using [lf](https://github.com/gokcehan/lf)\n\nhttps://github.com/chmouel/zsh-select-with-lf/assets/98980/e7c2801f-7a9c-40e7-9187-b75fcf64facf\n\n## 🛠️ Installation\n\n### Using [Antigen](https://github.com/zsh-users/antigen)\n\nBundle `zsh-vi-mode` in your `.zshrc`\n\n```shell\nantigen bundle chmouel/zsh-select-with-lf\n```\n\n### Using [zplug](https://github.com/b4b4r07/zplug)\n\nLoad `zsh-vi-mode` as a plugin in your `.zshrc`\n\n```shell\nzplug \"chmouel/zsh-select-with-lf\"\n```\n\n### Using [zgen](https://github.com/tarjoilija/zgen)\n\nInclude the load command in your `.zshrc`\n\n```shell\nzgen load chmouel/zsh-select-with-lf\n```\n\n### Using [zinit](https://github.com/zdharma-continuum/zinit)\n\nInclude the load command in your `.zshrc`\n\n```shell\nzinit ice depth=1\nzinit light chmouel/zsh-select-with-lf\n```\n\nNote: the use of `depth=1` ice is optional, other types of ice are neither\nrecommended nor officially supported by this plugin.\n\n### As an [Oh My Zsh!](https://github.com/robbyrussell/oh-my-zsh) custom plugin\n\nClone `zsh-vi-mode` into your custom plugins repo\n\n```shell\ngit clone https://github.com/chmouel/zsh-select-with-lf \\\n  $ZSH_CUSTOM/plugins/zsh-select-with-lf\n```\n\nThen load as a plugin in your `.zshrc`\n\n```shell\nplugins+=(zsh-select-with-lf)\n```\n\nKeep in mind that plugins need to be added before `oh-my-zsh.sh` is sourced.\n\n### Using [Antibody](https://getantibody.github.io/)\n\nAdd `zsh-vi-mode` to your plugins file (e.g. `~/.zsh_plugins.txt`)\n\n```shell\nchmouel/zsh-select-with-lf\n```\n\n### Using [Zap](https://github.com/zap-zsh/zap)\n\nLoad `zsh-vi-mode` as a plugin in your `.zshrc`\n\n```shell\nplug \"chmouel/zsh-select-with-lf\"\n```\n\n### Manual\n\nOr any ZSH plugin manager (I use my own simple one [vtplug](https://blog.chmouel.com/2022/03/18/vtplug-a-very-dumb-and-tiny-zsh-plugin-manager/))\n\nYou can as well simply git clone this repository and source the\n`zsh-select-with-lf.plugin.zsh` file if you want to do this just manually.\n\n## Requirements\n\nOnly [lf](https://github.com/gokcehan/lf) is needed.\n\n## Usage\n\nJust do `C-x C-l` to select a directory and `C-x l` (C-x mean control and x) it\nwill start `lf` and put the result file or directory on your command line.\n\nFor files you need to select the files and press enter, for the directories you\nneed to navigate to the directory and press q to quit `lf`.\n\nThis plugin will try to do the right thing if you have a file or a directory on\nthe current word to have `lf` initially started on the right directory.\n\n## Configuration\n\nYou can customize some variables\n\n- `ZSH_SELECT_WITH_LF_FILE_BIND`: The keybinding to use to select files default to \"^x^f\"\n- `ZSH_SELECT_WITH_LF_DIR_BIND`: The keybinding to use to select directories default to \"^x^f\"\n\n## Copyright\n\n[Apache-2.0](./LICENSE)\n\n## Authors\n\nChmouel Boudjnah\n\n- Fediverse - \u003c[@chmouel@fosstodon.org](https://fosstodon.org/@chmouel)\u003e\n- Twitter - \u003c[@chmouel](https://twitter.com/chmouel)\u003e\n- Blog - \u003c[https://blog.chmouel.com](https://blog.chmouel.com)\u003e\n\n## Alternative\n\nThe wiki list another method on how to do this: \u003chttps://github.com/gokcehan/lf/wiki/Integrations#zsh-file-picker--directory-changer\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Fzsh-select-with-lf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchmouel%2Fzsh-select-with-lf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Fzsh-select-with-lf/lists"}