{"id":19030347,"url":"https://github.com/chmouel/fzf-select-file","last_synced_at":"2025-09-06T23:31:40.980Z","repository":{"id":66897091,"uuid":"587691019","full_name":"chmouel/fzf-select-file","owner":"chmouel","description":"Select Files with FZF is a ZSH plug-in letting you selects files on the command line with fzf and eza","archived":false,"fork":false,"pushed_at":"2024-05-23T05:52:58.000Z","size":43,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T12:06:17.415Z","etag":null,"topics":["exa","fzf","shell","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-01-11T10:59:10.000Z","updated_at":"2025-03-10T17:11:06.000Z","dependencies_parsed_at":"2023-11-23T06:23:31.993Z","dependency_job_id":"92947b99-d0bd-46dc-b386-b27b33bcb3b7","html_url":"https://github.com/chmouel/fzf-select-file","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/chmouel/fzf-select-file","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ffzf-select-file","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ffzf-select-file/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ffzf-select-file/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ffzf-select-file/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chmouel","download_url":"https://codeload.github.com/chmouel/fzf-select-file/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chmouel%2Ffzf-select-file/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273977148,"owners_count":25201249,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["exa","fzf","shell","zsh","zsh-plugin"],"created_at":"2024-11-08T21:17:39.891Z","updated_at":"2025-09-06T23:31:40.681Z","avatar_url":"https://github.com/chmouel.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FZF select file zsh plugin\n\nA simple plugin to let you select some files on the command line with fzf and [eza](https://github.com/eza-community/eza)\n\n## Install\n\nUsing [zplug](https://github.com/zplug/zplug)\n\n```sh\nzplug 'chmouel/fzf-select-file'\n```\n\nOr any ZSH plugin manager (I use this own made one\n[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`fzf-select-file.plugin.zsh` file if you want to do this just manually.\n\n## Requirements\n\nYou need to have those tools installed:\n\n- [fzf](https://github.com/junegunn/fzf) (for selection)\n- [eza](https://github.com/eza-community/eza) (for listing)\n- [bat](https://github.com/sharkdp/bat) (for preview)\n\n## Usage\n\nC-x C-f (or control-x followed by control-f) will launch fzf with a listing\nfrom eza, you can select one or multiple files (with the tab keys) and it will\nbe added to the command line. If you have a word on the command line it will be\nused as the initial query for fzf and replaced with the results.\n\nBy default it will show the files without the 'hidden' files (the ones starting\nwith a dot) if you want to include them you can use the C-x C-a (or control-x\nfollowed by control-a) keybinding to show them.\n\nWhile in selection it will show a preview with bat for\nfiles or eza for directories (may fail on unknown files to bat) press\n`control-v` to hide the preview.\n\n## Demo\n\n\u003chttps://github.com/chmouel/fzf-select-file/assets/98980/438c5e77-b6da-45b1-b5ed-e8eb61a93fa5\u003e\n\n## Configuration\n\nYou can customize some variables\n\n- `ZSH_FZF_SELECT_FILE_FZF_ARGS`: The arguments to fzf.\n- `ZSH_FZF_SELECT_FILE_EZA_BINARY`: The binary to use for eza, default to `eza`.\n- `ZSH_FZF_SELECT_FILE_EZA_COLORS`: The eza colors to use default to `da=00`.\n- `ZSH_FZF_SELECT_FILE_EZA_ARGS`: The arguments to eza.\n- `ZSH_FZF_SELECT_FILE_BIND`: The keybinding to use default to \"^x^f\".\n- `ZSH_FZF_SELECT_ALL_FILES_BIND`: The keybinding to use default when selecting\n  all files including the dot files, default to `^x^a`.\n- `ZSH_FZF_SELECT_FILE_FZF_PREVIEW`: The preview shell command (see source for default).\n\n## TIPS\n\nIf you want to make Control-x Control-f select all you just need to set this in your config file before loading the plugin:\n\n```zsh\nZSH_FZF_SELECT_ALL_FILES_BIND=\"^x^f\"\n```\n\n## Copyright\n\n[Apache-2.0](./LICENSE)\n\n## Blog\n\n- \u003chttps://blog.chmouel.com/posts/selecting-files-in-zsh-with-fzf/\u003e\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\nYou can as well use the [FZF ZSH\nPlugin](https://github.com/unixorn/fzf-zsh-plugin) to get _everything_ selected\nwith fzf in zsh but no pretty eza listing in there...\n\n## Thanks\n\n- Inspired by this great plug-in \u003chttps://github.com/joshskidmore/zsh-fzf-history-search\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Ffzf-select-file","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchmouel%2Ffzf-select-file","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchmouel%2Ffzf-select-file/lists"}