{"id":47516117,"url":"https://github.com/BranBushes/veld-fm","last_synced_at":"2026-04-01T07:00:42.421Z","repository":{"id":297624558,"uuid":"997303602","full_name":"BranBushes/veld-fm","owner":"BranBushes","description":"A modern, tileable, terminal-based file manager built with Python and Textual.","archived":false,"fork":false,"pushed_at":"2025-10-27T14:57:15.000Z","size":563,"stargazers_count":26,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-27T16:35:55.147Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/BranBushes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-06T09:50:11.000Z","updated_at":"2025-10-27T14:57:19.000Z","dependencies_parsed_at":null,"dependency_job_id":"25fc5ecd-03f5-4dd8-8fc3-2894372fb87e","html_url":"https://github.com/BranBushes/veld-fm","commit_stats":null,"previous_names":["branbushes/veld-fm"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BranBushes/veld-fm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BranBushes%2Fveld-fm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BranBushes%2Fveld-fm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BranBushes%2Fveld-fm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BranBushes%2Fveld-fm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BranBushes","download_url":"https://codeload.github.com/BranBushes/veld-fm/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BranBushes%2Fveld-fm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31269176,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T06:57:45.811Z","status":"ssl_error","status_checked_at":"2026-04-01T06:57:42.389Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-03-27T13:00:30.246Z","updated_at":"2026-04-01T07:00:42.415Z","avatar_url":"https://github.com/BranBushes.png","language":"Python","funding_links":[],"categories":["\u003ca name=\"file-manager\"\u003e\u003c/a\u003eFile manager"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/BranBushes/veld-fm\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/BranBushes/veld-fm/master/.assets/logo.png\" alt=\"veld logo\" width=\"150\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# veld\n\nA modern, tileable, terminal-based file manager built with Python and Textual.\n\n\u003cdiv align=\"center\"\u003e\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Python Version](https://img.shields.io/badge/python-3.9+-brightgreen.svg)](https://www.python.org/downloads/)\n[![Status](https://img.shields.io/badge/status-active-success.svg)](https://github.com/BranBushes/veld-fm)\n \u003c!--[![PyPI version](https://img.shields.io/pypi/v/veld-fm.svg)](https://pypi.org/project/veld-fm/)  Add this line after publishing to PyPI --\u003e\n\n\u003c/div\u003e\n\n![A screenshot of the veld file manager in action.](https://raw.githubusercontent.com/BranBushes/veld-fm/master/.assets/ss.png)\n\n---\n\n## About\n\n`veld` is a powerful, modern file manager that runs directly in your terminal. Inspired by classic TUIs like Ranger and Midnight Commander, `veld` offers a fresh take with an emphasis on simplicity, ease of use, and multi-panel navigation.\n\n## ✨ Features\n\n*   🗂️ **Tileable Panels:** Open multiple directory views side-by-side to streamline your workflow.\n*   📂 **Toggle-able File Previews:** Automatically see a preview of the highlighted file—text, code, and even images. Press a key to hide it when you need more space.\n*   🔍 **Recursive File Search:** Instantly find files and directories within the current panel.\n*   ⌨️ **Intuitive Navigation:** Navigate your filesystem and switch between panels with familiar, ergonomic keybindings.\n*   ⚙️ **Powerful File Operations:** Perform common operations like copy, move, delete, and rename in the active panel.\n*   **ዚ Archive Management:** Create and extract zip/tar archives directly within the file manager.\n*   🎨 **Customizable Keybindings:** Don't like the defaults? Change every keybinding by editing a simple configuration file.\n*   🐧 **Cross-Platform:** Built with Python and Textual, `veld` runs on Linux, macOS, and Windows.\n*   **Vim Mode:** Queue up file operations and execute them in a batch, Vim-style.\n\n## 🚀 Installation\n\nYou need Python 3.9+ and `pip` installed.\n\nInstall the latest development version directly from GitHub:\n\n```bash\npip install git+https://github.com/BranBushes/veld-fm.git\n```\n\nOr using `uv`:\n```bash\nuv pip install git+https://github.com/BranBushes/veld-fm.git\n```\n\nThis will install `veld` and make the `veld` command available in your terminal.\n\n## 💻 Usage\n\nOnce installed, you can run `veld` from anywhere in your terminal. You can also provide an optional starting directory for the first panel.\n\n```bash\n# Start in the default home directory\nveld\n\n# Start in the ~/Documents directory\nveld ~/Documents\n```\n\n### Navigating Panels\n\nUse `Tab` and `Shift+Tab` to cycle focus between open panels. The active panel is highlighted with a colored border.\n\n### Vim Mode\n\nVeld includes an optional Vim-style command mode for batching file operations.\n\n*   **Enter Command Mode:** Press `:` to open the command input.\n*   `:vim` - Toggles Vim Mode on or off.\n*   `:w` - Executes (writes) all queued actions.\n*   `:c` - Clears all queued actions.\n\nWhen Vim Mode is active, a list of queued actions will appear in the bottom-right corner.\n\n## ⌨️ Keybindings\n\nKeybindings are organized by function and can be fully customized (see Configuration section).\n\n### Application \u0026 Panel Management\n\n| Key           | Action                 |\n|---------------|------------------------|\n| **q**         | Quit the application   |\n| **o**         | Open a new panel (prompts for path) |\n| **O** (Shift+o)| Open panel at selected directory |\n| **w**         | Close the active panel |\n| **p**         | Toggle the preview panel|\n| **backspace** | Close the search panel |\n| **:**         | Enter Command Mode     |\n\n### File \u0026 Directory Operations\n\n| Key         | Action                |\n|-------------|-----------------------|\n| **enter**   | Open file or directory (default app) |\n| **e**       | Open file with... (prompts for command) |\n| **space**   | Toggle file selection |\n| **f**       | Find files/directories|\n| **n**       | Rename a file         |\n| **d**       | Create a directory    |\n| **r**       | Delete selected files (queues in Vim Mode) |\n| **m**       | Move selected files   |\n| **c**       | Copy selected files (queues in Vim Mode) |\n| **a**       | Archive selected items|\n| **x**       | Extract highlighted archive |\n\n## 🔧 Configuration\n\nOn the first run, a config file is created at `~/.config/veld-fm/config.toml`. You can edit this file to change keybindings.\n\n## 🧑‍💻 For Developers\n\nTo set up a development environment:\n```bash\ngit clone https://github.com/BranBushes/veld-fm.git\ncd veld-fm\n./setup.sh # This creates a venv and installs in editable mode\nsource .venv/bin/activate\n```\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ❤️ from Bangladesh!\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBranBushes%2Fveld-fm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBranBushes%2Fveld-fm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBranBushes%2Fveld-fm/lists"}