{"id":29054270,"url":"https://github.com/houqp/kiorg","last_synced_at":"2026-04-01T23:55:38.193Z","repository":{"id":300676240,"uuid":"957310500","full_name":"houqp/kiorg","owner":"houqp","description":"A hacker's file manager with VIM inspired keybind","archived":false,"fork":false,"pushed_at":"2026-02-28T06:53:08.000Z","size":7337,"stargazers_count":411,"open_issues_count":6,"forks_count":13,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-02-28T12:37:32.025Z","etag":null,"topics":["cross-platform","egui","file-browser","file-manager","filebrowser","filemanager","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/houqp.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-30T03:27:55.000Z","updated_at":"2026-02-28T06:53:11.000Z","dependencies_parsed_at":"2025-06-23T03:30:12.673Z","dependency_job_id":"8cb9446d-5d26-4b30-9ab8-a9002ef90559","html_url":"https://github.com/houqp/kiorg","commit_stats":null,"previous_names":["houqp/kiorg"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/houqp/kiorg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houqp%2Fkiorg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houqp%2Fkiorg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houqp%2Fkiorg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houqp%2Fkiorg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/houqp","download_url":"https://codeload.github.com/houqp/kiorg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/houqp%2Fkiorg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29966684,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T09:33:09.965Z","status":"ssl_error","status_checked_at":"2026-03-01T09:25:48.915Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["cross-platform","egui","file-browser","file-manager","filebrowser","filemanager","rust"],"created_at":"2025-06-27T02:07:26.650Z","updated_at":"2026-04-01T23:55:38.175Z","avatar_url":"https://github.com/houqp.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"# Kiorg\n[![Releases](https://img.shields.io/badge/-releases-blue)](https://github.com/houqp/kiorg/releases)\n[![discord](https://dcbadge.limes.pink/api/server/https://discord.gg/TdTb2CHfpr?style=flat\u0026compact=true)](https://discord.gg/TdTb2CHfpr)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/icons/1024x1024@2x.png\" alt=\"Kiorg Logo\" width=\"200px\"\u003e\n\u003c/p\u003e\n\nKiorg is a performance focused cross-platform file manager with Vim-inspired key\nbindings. It is built using the [egui](https://www.egui.rs/#demo) framework.\n\n## Key Features\n\n* Lightingly fast rendering and navigation\n* Multi-tab support\n* Vim-inspired keyboard shortcuts\n* Built-in zoxide like fuzzy directory teleport\n* Content preview for various file formats including code syntax highlight, image, video,pdf, epub, etc.\n* Customizable shortcuts and color themes through TOML config files\n* Cross-platform support (Linux, macOS, Windows)\n* Bookmarks for quick access to frequently used directories\n* Single self-contained binary with battery included\n* Builtin terminal emulator\n* App state persistence\n* Language agnostic plugin system\n* Undo/redo file operations\n\n## Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"crates/kiorg/tests/snapshots/help_menu.png\" alt=\"Help Menu\" width=\"800px\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eBuilt-in help menu with keyboard shortcuts\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"crates/kiorg/tests/snapshots/preview_features_showcase.gif\" alt=\"Content preview\" width=\"800px\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eFile content preview\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"crates/kiorg/tests/snapshots/theme_selection_animation.gif\" alt=\"Theme Selection\" width=\"800px\"\u003e\n  \u003cbr\u003e\n  \u003cem\u003eCustomizable color themes\u003c/em\u003e\n\u003c/p\u003e\n\n## Installation\n\nPre-built binaries for all platforms are available on the [releases page](https://github.com/houqp/kiorg/releases).\n\nAlternatively, you can build and install from source using cargo:\n\n```bash\ncargo install --locked --git  https://github.com/houqp/kiorg.git kiorg\n```\n\n## Configuration\n\nKiorg reads the `config.toml` TOML configuration file stored in the following locations:\n\n* Linux: `~/.config/kiorg/`\n* macOS: `~/.config/kiorg/` (if it exists) or `~/Library/Application Support/kiorg/`\n* Windows: `%APPDATA%\\kiorg\\`\n\n### Sample Configuration\n\n```toml\n# Sort preference configuration (optional)\n[sort_preference]\ncolumn = \"Name\"             # Sort column: \"Name\", \"Modified\", \"Size\", or \"None\"\norder = \"Ascending\"         # Sort order: \"Ascending\" or \"Descending\"\n\n[layout]\npreview = 0.5 # Increase preview default width ratio to 50%\n\n# Override default shortcuts (optional)\n[shortcuts]\nMoveDown = [\n  { key = \"j\" },\n  { key = \"down\" }\n]\nMoveUp = [\n  { key = \"k\" },\n  { key = \"up\" }\n]\nDeleteEntry = [\n  { key = \"d\" }\n]\nActivateSearch = [\n  { key = \"/\" },\n  { key = \"f\", ctrl = true }\n]\n```\n\n### Custom Theme\n\nTo define a custom theme:\n\n```toml\n# Select your custom theme\ntheme = \"my_cool_theme\"\n\n# Define the custom theme colors\n[[custom_themes]]\nname = \"my_cool_theme\"\ndisplay_name = \"My Cool Theme\"\n[custom_themes.colors]\nfg = \"#FAF7F0\"                  # Main text color\nbg = \"#000000\"                  # Main background color\nbg_light = \"#080808\"            # Lighter background (panels, separators)\nbg_extreme = \"#050505\"          # Darkest background (scrollbars, inputs)\nbg_selected = \"#1A1A1A\"         # Selected item background\nbg_fill = \"#1A1A1A\"             # UI element background\nbg_interactive_fill = \"#262626\" # Interactive element background\nbg_active = \"#333333\"           # Active element background\nfg_selected = \"#FAF7F0\"         # Selected text color\nfg_light = \"#4E5A6A\"            # Dimmed/secondary text\nfg_folder = \"#87CEEB\"           # Folder icon color\nhighlight = \"#FFA247\"           # Highlight color\nlink_text = \"#7FA5CC\"           # Link text color\nlink_underscore = \"#58B8FD\"     # Link underline color\nwarn = \"#FFA247\"                # Warning color\nerror = \"#D06666\"               # Error color\nsuccess = \"#6BBF59\"             # Success color\n```\n\nYou can try asking LLM to generate these custom theme configs for you based on themes from other apps, it typically works one shot.\n\n\n## Development\n\n### Common workflows\n\n* To run static analysis: `cargo clippy --workspace --all-targets -- -D warnings`\n* To execute tests, run: `cargo test` or `cargo nextest run`\n  * Recommend nextest since it's 2-3x faster.\n* To regenerate screenshots in readme: `UPDATE_SNAPSHOTS=1 cargo test --features=snapshot`\n\n### Design patterns\n\n* Composition over inheritance.\n* Simple modular design and avoid unnecessary abstractions.\n* Leverage async operations for long-running tasks to prevent blocking UI rendering.\n* Implementing user preference persistence for improved user experience.\n* Clean layout with compact spacing and alignment, functionality over flashy visuals.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhouqp%2Fkiorg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhouqp%2Fkiorg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhouqp%2Fkiorg/lists"}