{"id":13411218,"url":"https://github.com/ms-jpq/chadtree","last_synced_at":"2025-05-14T10:06:40.895Z","repository":{"id":37264693,"uuid":"278033950","full_name":"ms-jpq/chadtree","owner":"ms-jpq","description":"File manager for Neovim. Better than NERDTree.","archived":false,"fork":false,"pushed_at":"2025-04-11T00:52:40.000Z","size":27127,"stargazers_count":1676,"open_issues_count":93,"forks_count":64,"subscribers_count":7,"default_branch":"chad","last_synced_at":"2025-04-11T04:14:34.152Z","etag":null,"topics":["chad","colours","devicons","file-explorer","file-manager","github-colours","neovim","neovim-plugin","nerdtree","nvim","python","tree"],"latest_commit_sha":null,"homepage":"","language":"Python","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/ms-jpq.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-07-08T08:29:41.000Z","updated_at":"2025-04-10T16:47:27.000Z","dependencies_parsed_at":"2024-01-03T00:41:23.355Z","dependency_job_id":"df6b5594-712f-4711-b32d-410032f8806f","html_url":"https://github.com/ms-jpq/chadtree","commit_stats":{"total_commits":2560,"total_committers":37,"mean_commits":69.1891891891892,"dds":"0.36445312500000004","last_synced_commit":"47da8973a4225de59ac1bb344ee1a541f0874ff1"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms-jpq%2Fchadtree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms-jpq%2Fchadtree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms-jpq%2Fchadtree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ms-jpq%2Fchadtree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ms-jpq","download_url":"https://codeload.github.com/ms-jpq/chadtree/tar.gz/refs/heads/chad","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254119484,"owners_count":22017951,"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":["chad","colours","devicons","file-explorer","file-manager","github-colours","neovim","neovim-plugin","nerdtree","nvim","python","tree"],"created_at":"2024-07-30T20:01:12.231Z","updated_at":"2025-05-14T10:06:40.864Z","avatar_url":"https://github.com/ms-jpq.png","language":"Python","readme":"# [CHADTree](https://ms-jpq.github.io/chadtree)\n\nFile Manager for Neovim, Better than NERDTree.\n\n## Features Illustrated\n\n**See full list of screen captures [here](https://github.com/ms-jpq/chadtree/tree/chad/docs/FEATURES.md)**\n\n### I like speed\n\n- **Parallel** Filesystem Scan\n\n- **[React Like](https://reactjs.org/docs/reconciliation.html)** Reconciling Difference Minimizing Rendering engine\n\n- **Never** blocks\n\n_You can read more about my [performance optimization](https://github.com/ms-jpq/chadtree/tree/chad/docs/ARCHITECTURE.md) here._\n\n### I like power\n\n- Visual mode selections\n\n- Create, Copy, Paste, Delete, Rename, gotta do them all\n\n- Quickfix integration\n\n- [Bookmarks](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/bookmarks.png)\n\n![visual_select.gif](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/visual_select.gif)\n\n### I like 21st century\n\n- Filtering by glob\n\n- Follow mode\n\n- Session support (save open folders to disk, pick up where you left off)\n\n- Trash support (requires [`trash`](https://formulae.brew.sh/formula/trash) or [`trash-cli`](https://github.com/andreafrancia/trash-cli))\n\n- `ls -l` statistics\n\n- Correct! handling of symlinks\n\n![filtering.gif](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/filtering.gif)\n\n### I like version control\n\n- Asynchronous parse git status (untracked, modified, staged)\n\n- Full support for git submodules\n\n![git.gif](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/git_showcase.gif)\n\n### I like colours\n\n- Full `$LS_COLOR` support! (shows same colours as unix `ls` \u0026 `tree` commands)\n\n- [Github coloured](https://github.com/github/linguist) icons (over 600 colours!)\n\n- Three different sets of icons out of the box\n\n- Four built-in themes - nord, solarized, trapdoor, vim-syntax\n\n![ls_colours.png](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/ls_colours.png)\n\n![github_colours.png](https://raw.githubusercontent.com/ms-jpq/chadtree/chad/docs/img/github_colours.png)\n\n### I like refinement\n\n- Maintain cursor position on relevant files even when during movements.\n\n- Maintain selection when copying, moving files\n\n- Mimetype warning (so you don't accidentally open an image)\n\n- Validating config parser **(notice, I added an extra `\"dog\"` param)**\n\n![mime warn.png](https://github.com/ms-jpq/chadtree/raw/chad/docs/img/mimetype.png)\n\n![schema error.png](https://github.com/ms-jpq/chadtree/raw/chad/docs/img/schema_error.png)\n\n### I like documentation\n\n- Built-in help command in a floating window!\n\n- Over 1000 lines of meticulous docs covering every option / function!\n\n**Use `:CHADhelp` to view [documentation](https://github.com/ms-jpq/chadtree/tree/chad/docs)**\n\n**Use `:CHADhelp --web` to open documentation in your browser!** (If you have one installed)\n\n## Install\n\n**Minimum version**: `python`: 3.8.2, `nvim`: `0.4.3`, make sure to have `virtualenv` installed (e.g.: `sudo apt install --yes -- python3-venv`)\n\nInstall the usual way, ie. [VimPlug](https://github.com/junegunn/vim-plug), [Vundle](https://github.com/VundleVim/Vundle.vim), etc\n\n```vim\nPlug 'ms-jpq/chadtree', {'branch': 'chad', 'do': 'python3 -m chadtree deps'}\n```\n\nYou will have to run `:CHADdeps` when installing / updating. This will install CHADTree's dependencies locally inside `chadtree/.vars/runtime`.\n\ndoing `rm -rf chadtree/` will cleanly remove everything CHADTree uses on your computer.\n\n## Usage\n\nTo toggle CHADTree run command `:CHADopen`. Set it to a hotkey for convenience.\n\n```vimL\nnnoremap \u003cleader\u003ev \u003ccmd\u003eCHADopen\u003ccr\u003e\n```\n\nTo see a list of hot keys:\n\nEither use `:CHADhelp keybind` or open in browser using [`:CHADhelp keybind --web`](https://github.com/ms-jpq/chadtree/tree/chad/docs/KEYBIND.md)\n\n### FAQ\n\nQ: Sometimes Windows will get stuck with CHADTree decorations when I do not want them to be, how do I resolve this?\n\nA: Run `:CHADrestore`\n\n### Recommendations\n\nAdd a hotkey to clear quickfix list:\n\n```vimL\nnnoremap \u003cleader\u003el \u003ccmd\u003ecall setqflist([])\u003ccr\u003e\n```\n\n## If you like this...\n\nAlso check out\n\n- [`sad`](https://github.com/ms-jpq/sad), its a modern `sed` that does previews with syntax highlighting, and lets you pick and choose which chunks to edit.\n\n- [`coq.nvim`](https://github.com/ms-jpq/coq_nvim), it's a FAST AS FUCK completion client with shit tons of features.\n\n- [isomorphic-copy](https://github.com/ms-jpq/isomorphic-copy), it's a cross platform clipboard that is daemonless, and does not require third party support.\n\n## Special Thanks\n\nCHADTree does not define it's own colours beyond some minimal defaults, all themes are imported from other open source projects.\n\n\u003e The base icons are imported from the [vim-devicon](https://github.com/ryanoasis/vim-devicons)\n\n\u003e All emoji icons are imported from the [vim-emoji-icon-theme](https://github.com/adelarsq/vim-emoji-icon-theme)\n\n\u003e Some themes are imported from [dircolors-solarized](https://github.com/seebi/dircolors-solarized)\n\n\u003e Some themes are imported from [nord-dircolors](https://github.com/arcticicestudio/nord-dircolors)\n\n\u003e Some themes are imported from [LS_COLORS](https://github.com/trapd00r/LS_COLORS)\n\n\u003e Some themes are imported from [vim-nerdtree-syntax-highlight](https://github.com/tiagofumo/vim-nerdtree-syntax-highlight)\n","funding_links":[],"categories":["File Explorer","HarmonyOS","Python"],"sub_categories":["Markdown and LaTeX","Windows Manager","Assembly"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms-jpq%2Fchadtree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fms-jpq%2Fchadtree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fms-jpq%2Fchadtree/lists"}