{"id":24655300,"url":"https://github.com/night0721/ccc.nvim","last_synced_at":"2025-03-21T02:16:50.691Z","repository":{"id":231942317,"uuid":"783094054","full_name":"night0721/ccc.nvim","owner":"night0721","description":"Fork of fm-nvim, Neovim plugin that lets you use ccc and fnf within Neovim.","archived":false,"fork":false,"pushed_at":"2024-04-07T00:11:24.000Z","size":26,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-25T22:45:21.032Z","etag":null,"topics":["ccc","file-manager","lua","neovim","neovim-plugin","nvim"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/night0721.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":"2024-04-06T23:26:20.000Z","updated_at":"2024-10-18T14:36:51.000Z","dependencies_parsed_at":"2024-04-07T01:15:31.229Z","dependency_job_id":"f2164ccf-74a9-4445-af6f-20d2a66add90","html_url":"https://github.com/night0721/ccc.nvim","commit_stats":null,"previous_names":["night0721/ccc.nvim"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/night0721%2Fccc.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/night0721%2Fccc.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/night0721%2Fccc.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/night0721%2Fccc.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/night0721","download_url":"https://codeload.github.com/night0721/ccc.nvim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244722743,"owners_count":20499154,"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":["ccc","file-manager","lua","neovim","neovim-plugin","nvim"],"created_at":"2025-01-25T22:36:50.307Z","updated_at":"2025-03-21T02:16:50.664Z","avatar_url":"https://github.com/night0721.png","language":"Lua","readme":"[![GitHub Stars](https://img.shields.io/github/stars/night0721/ccc.nvim.svg?style=social\u0026label=Star\u0026maxAge=2592000)](https://github.com/night0721/ccc.nvim/stargazers/)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)\n[![Last Commit](https://img.shields.io/github/last-commit/night0721/ccc.nvim)](https://github.com/night0721/ccc.nvim/pulse)\n[![GitHub Open Issues](https://img.shields.io/github/issues/night0721/ccc.nvim.svg)](https://github.com/night0721/ccc.nvim/issues/)\n[![GitHub Closed Issues](https://img.shields.io/github/issues-closed/night0721/ccc.nvim.svg)](https://github.com/night0721/ccc.nvim/issues?q=is%3Aissue+is%3Aclosed)\n[![GitHub License](https://img.shields.io/github/license/night0721/ccc.nvim?logo=GNU)](https://github.com/night0721/ccc.nvim/blob/master/LICENSE)\n[![Lua](https://img.shields.io/badge/Lua-2C2D72?logo=lua\u0026logoColor=white)](https://github.com/night0721/ccc.nvim/search?l=lua)\n\n# ccc.nvim \n\n`ccc.nvim` is a fork of Neovim plugin 'fm-nvim' that lets you use your favorite terminal file managers (and fuzzy finders) from within Neovim.\n\n\u003cdetails\u003e\n\u003csummary\u003eSupported File Managers\u003c/summary\u003e\n\n- [ccc](https://github.com/night0721/ccc)\n\n\u003c/details\u003e\n\n\u003cp\u003e\n\u003cdetails\u003e\n\u003csummary\u003eSupported Fuzzy Finders\u003c/summary\u003e\n\n- [fnf](https://github.com/leo-arch/fnf)\n\n\u003c/details\u003e\n\u003c/p\u003e\n\n\u003cp\u003eKeep in mind that support for fuzzy finding is quite limited and using seperate plugins would be more practical.\u003c/p\u003e\n\n\u003cp\u003e1. Partial Support as files cannot be opened.\u003c/p\u003e\n\n## Demo and Screenshots:\n\n![Demo](https://user-images.githubusercontent.com/57725322/142964076-6efd1247-b689-4cf7-bc29-ca1c6746462c.gif)\n\n\u003cp\u003e\n\u003cdetails\u003e\n\u003csummary\u003eScreenshots\u003c/summary\u003e\n\n##### [fnf](https://github.com/leo-arch/fnf)\n\n![fnf](https://github.com/night0721/ccc.nvim/assets/77528305/db8ca2e2-1df8-4eed-9888-2e578ff888c0)\n\n##### [ccc](https://github.com/night0721/ccc)\n\n![ccc](https://github.com/night0721/ccc.nvim/assets/77528305/8ae753e4-7f16-4d44-b466-ea3c7ab78c41)\n\n\u003c/details\u003e\n\u003c/p\u003e\n\n## Installation:\n\n- [packer.nvim](https://github.com/wbthomason/packer.nvim):\n  ```lua\n  use {'night0721/ccc.nvim'}\n  ```\n\n## Configuration:\n\nThe following configuration contains the defaults so if you find them satisfactory, there is no need to use the setup function.\n\n```lua\nrequire('ccc').setup{\n\t-- (Vim) Command used to open files\n\tedit_cmd = \"edit\",\n\n\t-- See `Q\u0026A` for more info\n\ton_close = {},\n\ton_open = {},\n\n\t-- UI Options\n\tui = {\n\t\t-- Default UI (can be \"split\" or \"float\")\n\t\tdefault = \"float\",\n\n\t\tfloat = {\n\t\t\t-- Floating window border (see ':h nvim_open_win')\n\t\t\tborder    = \"none\",\n\n\t\t\t-- Highlight group for floating window/border (see ':h winhl')\n\t\t\tfloat_hl  = \"Normal\",\n\t\t\tborder_hl = \"FloatBorder\",\n\n\t\t\t-- Floating Window Transparency (see ':h winblend')\n\t\t\tblend     = 0,\n\n\t\t\t-- Num from 0 - 1 for measurements\n\t\t\theight    = 0.8,\n\t\t\twidth     = 0.8,\n\n\t\t\t-- X and Y Axis of Window\n\t\t\tx         = 0.5,\n\t\t\ty         = 0.5\n\t\t},\n\n\t\tsplit = {\n\t\t\t-- Direction of split\n\t\t\tdirection = \"topleft\",\n\n\t\t\t-- Size of split\n\t\t\tsize      = 24\n\t\t}\n\t},\n\n\t-- Terminal commands used w/ file manager (have to be in your $PATH)\n\tcmds = {\n        ccc_cmd     = \"ccc\",\n        fnf_cmd     = \"find . | fnf\",\n\t},\n\n\t-- Mappings used with the plugin\n\tmappings = {\n\t\tvert_split = \"\u003cC-v\u003e\",\n\t\thorz_split = \"\u003cC-h\u003e\",\n\t\ttabedit    = \"\u003cC-t\u003e\",\n\t\tedit       = \"\u003cC-e\u003e\",\n\t\tESC        = \"\u003cESC\u003e\"\n\t},\n}\n```\n\n## Usage:\n\nAny of the following commands are fine...\n\n- Commands\n  - `:Ccc`\n  - `:Fnf`\n\nbut you can add a directory path w/ the command (doesn't work with `fnf`).\n\nExample:\n\n```\n:Ccc ~/.config/nvim/\n```\n\n## Q\u0026A\n\nQ: What if I want to open files in splits or tabs?\n\nA: Use any of the default mappings (unless you've changed them)...\n\n- `\u003cC-h\u003e` for horizontal split\n- `\u003cC-v\u003e` for vertical split\n- `\u003cC-e\u003e` for normal edit\n- `\u003cC-t\u003e` for tabs\n\nQ: Can I run a function once exiting or entering the plugin?\n\nA: Yes you can! Use the following code as a guide...\n\n```lua\nlocal function yourFunction()\n\t-- Your code goes here\nend\n\nrequire('ccc').setup{\n\t-- Runs yourFunction() upon exiting the floating window (can only be a function)\n\ton_close = { yourFunction },\n\n\t-- Runs yourFunction() upon opening the floating window (can only be a function)\n\ton_open = { yourFunction }\n}\n```\n\nQ: What if I want to map `\u003cESC\u003e` to close the window?\n\nA: You can do this by mapping `\u003cESC\u003e` to whatever closes your file manager (note that this may bring up other issues). This can be done with the following code...\n\n```lua\nrequire('ccc').setup{\n\tmappings = {\n\t\t-- Example for Vifm\n\t\tESC        = \":q\u003cCR\u003e\"\n\t}\n}\n```\n\nQ: Am I able to have image previews?\n\nA: Not yet\n\u003c!-- A: Yes and no. Assuming you are on Linux, it is possible with the help of tools like [Überzug](https://github.com/seebye/ueberzug). If you are on Mac or Windows, it is not possible. --\u003e\n\nQ: Can I use splits instead of a floating window\n\nA: It's possible by changing the \"default\" option in the \"ui\" table to \"split\"\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnight0721%2Fccc.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnight0721%2Fccc.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnight0721%2Fccc.nvim/lists"}