{"id":20468971,"url":"https://github.com/neko-box-coder/filemanager2","last_synced_at":"2025-11-01T09:02:35.799Z","repository":{"id":240450205,"uuid":"802667826","full_name":"Neko-Box-Coder/filemanager2","owner":"Neko-Box-Coder","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-26T20:11:04.000Z","size":248,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T21:23:27.719Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Lua","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/Neko-Box-Coder.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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}},"created_at":"2024-05-18T23:36:17.000Z","updated_at":"2025-03-26T20:11:08.000Z","dependencies_parsed_at":"2024-05-19T00:30:16.322Z","dependency_job_id":"d1bbf9f2-b43d-433e-8325-d012d14fab87","html_url":"https://github.com/Neko-Box-Coder/filemanager2","commit_stats":null,"previous_names":["neko-box-coder/filemanager2"],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neko-Box-Coder%2Ffilemanager2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neko-Box-Coder%2Ffilemanager2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neko-Box-Coder%2Ffilemanager2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Neko-Box-Coder%2Ffilemanager2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Neko-Box-Coder","download_url":"https://codeload.github.com/Neko-Box-Coder/filemanager2/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248697453,"owners_count":21147329,"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":[],"created_at":"2024-11-15T14:07:30.577Z","updated_at":"2025-11-01T09:02:35.781Z","avatar_url":"https://github.com/Neko-Box-Coder.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Filemanager Plugin\n\n\u003e This is a fork from https://codeberg.org/micro-plugins/filemanager2\n\u003e and will continue to be maintained as much as possible\n\u003e All credits and previous efforts goes to [Nicolai Søborg](https://github.com/NicolaiSoeborg), \n[ryo-inagaki](https://github.com/ryo-inagaki) and [taconi](https://github.com/taconi)\n\nA simple plugin that allows for easy navigation of a file tree.\n\nThis plugin contains the same functionality as \n[filemanager](https://github.com/micro-editor/updated-plugins/tree/master/filemanager-plugin), \nbut with the commands 'rename', 'touch' and 'mkdir' working in micro v2. \nThe adjustment of these commands was done by [Ryo Inagaki](https://github.com/ryo-inagaki/) and \nthere is already a [Pull Request](https://github.com/micro-editor/updated-plugins/pull/10) \nhowever, PR's are not accepted for a while (there is an \n[issue](https://github.com/micro-editor/plugin-channel/issues/74) on this subject). \nThis repository was created to make available the commands working, as soon as the pull request \nis accepted, this repository will be archived and deleted after a while.\n\n![Example picture](./assets/example.jpg?raw=true \"Example\")\n\nIf [nerd fonts](https://www.nerdfonts.com) is installed and options `filemanager2.nerdfonts` is `true`\n\n![Example picture icons](./assets/example_icons.png?raw=true \"Example\")\n\n## Installation\n\n### Settings\nAdd this repo as a **pluginrepos** option in the **~/.config/micro/settings.json** file \n(it is necessary to restart the micro after this change):\n```json\n{\n  \"pluginrepos\": [\n      \"https://raw.githubusercontent.com/Neko-Box-Coder/filemanager2/main/repo.json\"\n  ]\n}\n```\n\n### Install\n\nRun in your shell:\n```sh\nmicro -plugin install filemanager2\n```\nor press `Ctrl-e` in micro and run this (and restart micro afterwards):\n```\n\u003e plugin install filemanager2\n```\n\n## Basics\n\nThe top line always has the current directory's path to show you where you are.\\\nThe `..` near the top is used to move back a directory, from your current position.\n\nAll directories have a `/` added to the end of it, and are syntax-highlighted as a `special` character.\\\n\nIf the directory is expanded, there will be a `+` to the left of it. \nIf it is collapsed there will be a `-` instead.\n\n**NOTE:** If you change files without using the plugin, it can't know what you did. \nThe only fix is to close and open the tree.\n\n### Options\n\n| Option                       | Purpose                                                      | Default |\n| :--------------------------- | :----------------------------------------------------------- | :------ |\n| `filemanager2.showdotfiles`  | Show dotfiles (hidden if false)                              | `true`  |\n| `filemanager2.showignored`   | Show gitignore'd files (hidden if false)                     | `true`  |\n| `filemanager2.compressparent`| Collapse the parent dir when left is pressed on a child file | `true`  |\n| `filemanager2.foldersfirst`  | Sorts folders above any files                                | `true`  |\n| `filemanager2.openonstart`   | Automatically open the file tree when starting Micro         | `false` |\n| `filemanager2.nerdfonts`     | Use nerd fonts icons                                         | `false` |\n| `filemanager2.showcurrent`   | Show and expand to current file in tree                      | `true`  |\n| `filemanager2.relativepath`  | Use relative paths when possible                             | `true`  |\n| `filemanager2.newtab`        | Open files in new tabs instead of splits                     | `true`  |\n| `filemanager2.treewidth`     | Default tree width percent                                   | `30`    |\n| `filemanager2.lengthfactor`  | Multiplier on tree width depending on how long the line is   | `0.3`   |\n\nIn addition to this, you can also get the file icon in the status bar by calling `filemanager2.FileIcon`, \nfor example\n\n```json\n\"statusformatl\": \"$(filemanager2.FileIcon) $(filename)$(modified)\",\n```\n\n\n### Commands and Keybindings\n\nThe keybindings below are the equivalent to Micro's defaults, and not actually set by the plugin. \nIf you've changed any of those keybindings, then that key is used instead.\n\nIf you want to \n[keybind](https://github.com/zyedidia/micro/blob/master/runtime/help/keybindings.md#rebinding-keys) \nany of the operations/commands, bind to the labeled API in the table below.\n\n| Command  | Keybinding(s)              | What it does                                                                                | API for `bindings.json`                |\n| :------- | :------------------------- | :------------------------------------------------------------------------------------------ | :------------------------------------- |\n| `tree`   | -                          | Open/close the tree, or moves to the tree to current tab if opened in different tab         | `filemanager2.toggle_tree`             |\n| -        | \u003ckbd\u003eTab\u003c/kbd\u003e \u0026 MouseLeft | Open a file, or go into the directory. Goes back a dir if on `..`                           | `filemanager2.try_open_at_cursor`      |\n| -        | \u003ckbd\u003e→\u003c/kbd\u003e               | Expand directory in tree listing                                                            | `filemanager2.uncompress_at_cursor`    |\n| -        | \u003ckbd\u003e←\u003c/kbd\u003e               | Collapse directory listing                                                                  | `filemanager2.compress_at_cursor`      |\n| -        | \u003ckbd\u003eShift ⬆\u003c/kbd\u003e         | Go to the target's parent directory                                                         | `filemanager2.goto_parent_dir`         |\n| -        | \u003ckbd\u003eAlt Shift {\u003c/kbd\u003e     | Jump to the previous directory in the view                                                  | `filemanager2.goto_next_dir`           |\n| -        | \u003ckbd\u003eAlt Shift }\u003c/kbd\u003e     | Jump to the next directory in the view                                                      | `filemanager2.goto_prev_dir`           |\n| `rm`     | -                          | Prompt to delete the target file/directory your cursor is on                                | `filemanager2.prompt_delete_at_cursor` |\n| `rename` | -                          | Rename the file/directory your cursor is on, using the passed name                          | `filemanager2.rename_at_cursor`        |\n| `touch`  | -                          | Make a new file under/into the file/directory your cursor is on, using the passed name      | `filemanager2.new_file`                |\n| `mkdir`  | -                          | Make a new directory under/into the file/directory your cursor is on, using the passed name | `filemanager2.new_dir`                 |\n| `cp`     | -                          | Copy the file/directory your cursor is on with the passed path as destination file/dir      | `filemanager2.copy`                    |\n\n#### Notes\n\n- `rename`, `touch`, and `mkdir` require a name to be passed when calling.\\\n  Example: `rename newnamehere`, `touch filenamehere`, `mkdir dirnamehere`.\\\n  If the passed name already exists in the current dir, it will cancel instead of overwriting (for safety).\n\n- The \u003ckbd\u003eCtrl w\u003c/kbd\u003e keybinding is to switch which buffer your cursor is on.\\\n  This isn't specific to the plugin, it's just part of Micro, but many people seem to not know this.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneko-box-coder%2Ffilemanager2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fneko-box-coder%2Ffilemanager2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fneko-box-coder%2Ffilemanager2/lists"}