{"id":50728944,"url":"https://github.com/elio-fm/elio","last_synced_at":"2026-06-12T13:00:53.755Z","repository":{"id":343300838,"uuid":"1177113373","full_name":"elio-fm/elio","owner":"elio-fm","description":"Snappy, batteries-included terminal file manager with rich previews, inline images, bulk actions, and trash support","archived":false,"fork":false,"pushed_at":"2026-06-06T09:59:36.000Z","size":7602,"stargazers_count":258,"open_issues_count":2,"forks_count":11,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-06T11:20:43.658Z","etag":null,"topics":["cli","file-browser","file-manager","image-preview","kitty-graphics","ratatui","rust","sixel","terminal","tui"],"latest_commit_sha":null,"homepage":"https://elio-fm.github.io/","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/elio-fm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE-MIT","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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":"2026-03-09T17:53:05.000Z","updated_at":"2026-06-06T09:52:33.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/elio-fm/elio","commit_stats":null,"previous_names":["miguelregueiro/elio","elio-fm/elio"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/elio-fm/elio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elio-fm%2Felio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elio-fm%2Felio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elio-fm%2Felio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elio-fm%2Felio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elio-fm","download_url":"https://codeload.github.com/elio-fm/elio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elio-fm%2Felio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34245218,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["cli","file-browser","file-manager","image-preview","kitty-graphics","ratatui","rust","sixel","terminal","tui"],"created_at":"2026-06-10T07:00:27.291Z","updated_at":"2026-06-12T13:00:53.748Z","avatar_url":"https://github.com/elio-fm.png","language":"Rust","funding_links":[],"categories":["Applications"],"sub_categories":["File manager"],"readme":"\u003ch1 align=\"left\"\u003e\u003cimg src=\"assets/logo.png\" width=\"64\" alt=\"elio logo\" align=\"absmiddle\" /\u003e\u0026nbsp;elio\u003c/h1\u003e\n\nSnappy, batteries-included terminal file manager with rich previews, inline images, bulk actions, and trash support.\n\n![elio — default theme](examples/themes/default/screenshot.webp)\n\n## Documentation\n\n- Installation: https://elio-fm.github.io/install/\n- Docs: https://elio-fm.github.io/docs/\n\n---\n\n## Features\n\n- **Three-pane layout** — Places, Files, and Preview side by side\n- **Rich previews** — text, code, documents, archives, media, and more; see [Preview Coverage](#preview-coverage)\n- **Inline images** — rendered directly in supported terminals\n- **Customizable Places and devices** — pinned folders plus auto-detected drives and mounts\n- **Quick actions** — Go-to, Open With, and copy-to-clipboard\n- **Trash management** — trash, restore, or permanently delete files\n- **Keyboard and mouse navigation** — browse comfortably either way\n- **Grid and list views** — switch with `v`, zoom the grid with `Ctrl++` / `Ctrl+-`\n- **Fuzzy search** — find folders and files quickly\n- **Zoxide jumps** — jump to frequent directories from your zoxide history\n- **Shell integration** — install cd-on-exit wrappers for bash, zsh, fish, and Nushell\n- **Theming** — full palette and file-class control via `theme.toml`\n\n---\n\n## Installation\n\n### Arch Linux\n\nInstall from the AUR with your preferred AUR helper:\n\n```bash\nparu -S elio\n```\n\n### Fedora\n\nEnable the COPR repository and install with `dnf`:\n\n```bash\nsudo dnf copr enable miguelregueiro/elio\nsudo dnf install elio\n```\n\n### Debian and Ubuntu-based Linux\n\nConfigure the official apt repository and install with `apt`:\n\n```bash\ncurl -fsSL https://elio-fm.github.io/elio-apt/install.sh | sudo sh\nsudo apt install elio\n```\n\nManual repository setup is available in [`elio-apt`](https://github.com/elio-fm/elio-apt). To install without adding a repository, download `elio_amd64.deb` from the [latest release](https://github.com/elio-fm/elio/releases/latest).\n\nThe apt repository currently publishes `amd64` packages.\n\n### Homebrew\n\nInstall from Homebrew:\n\n```bash\nbrew install elio\n```\n\n### Cargo\n\nInstall from crates.io:\n\n```bash\ncargo install elio\n```\n\n`elio` starts in your current working directory by default. Pass a file or directory path to open it instead.\n\n\u003e [!TIP]\n\u003e Recommended: use a Nerd Font in your terminal so icons display correctly.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eRunning From Source\u003c/strong\u003e\u003c/summary\u003e\n\n```bash\ncargo run --release\n```\n\n\u003c/details\u003e\n\n---\n\n## Example Themes\n\nA few bundled themes are shown below. More are available in [`examples/themes/`](examples/themes/). See [Theming](#theming) for theme paths and docs.\n\n| Catppuccin Mocha | Navi |\n|---|---|\n| \u003cp align=\"center\"\u003e\u003cimg src=\"examples/themes/catppuccin-mocha/screenshot.webp\" alt=\"Catppuccin Mocha\" width=\"440\"\u003e\u003c/p\u003e | \u003cp align=\"center\"\u003e\u003cimg src=\"examples/themes/navi/screenshot.webp\" alt=\"Navi\" width=\"440\"\u003e\u003c/p\u003e |\n\n| Amber Dusk | Blush Light |\n|---|---|\n| \u003cp align=\"center\"\u003e\u003cimg src=\"examples/themes/amber-dusk/screenshot.webp\" alt=\"Amber Dusk\" width=\"440\"\u003e\u003c/p\u003e | \u003cp align=\"center\"\u003e\u003cimg src=\"examples/themes/blush-light/screenshot.webp\" alt=\"Blush Light\" width=\"440\"\u003e\u003c/p\u003e |\n\n---\n\n## Image Previews\n\nInline visual previews, including images, covers, thumbnails, and rendered pages, work automatically on supported terminals.\n\n| Terminal | Protocol | Status |\n|---|---|---|\n| [Kitty](https://sw.kovidgoyal.net/kitty/) | Kitty Graphics Protocol | ✓ Auto-detected |\n| [Ghostty](https://ghostty.org/) | Kitty Graphics Protocol | ✓ Auto-detected |\n| [Warp](https://www.warp.dev/) | Kitty direct-placement protocol | ✓ Auto-detected |\n| [WezTerm](https://wezfurlong.org/wezterm/) | iTerm2 Inline Protocol | ✓ Auto-detected |\n| [iTerm2](https://iterm2.com/) | iTerm2 Inline Protocol | ✓ Auto-detected |\n| [Konsole](https://konsole.kde.org/) | Kitty direct-placement protocol | ✓ Auto-detected |\n| [foot](https://codeberg.org/dnkl/foot) | Sixel | ✓ Auto-detected |\n| [Windows Terminal](https://github.com/microsoft/terminal) | Sixel | ✓ Auto-detected |\n| Alacritty | — | Not supported |\n| Other | Kitty Graphics Protocol | Set `ELIO_IMAGE_PREVIEWS=1` to enable |\n\n\u003e Sixel terminals can render large or first-time previews more slowly than Kitty Graphics or iTerm2 Inline backends.\n\u003e\n\u003e In Konsole, inline previews are temporarily cleared while modal popups are open to avoid rendering artifacts.\n\nUseful environment variables:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eEnvironment Variables\u003c/strong\u003e\u003c/summary\u003e\n\n| Variable | Effect |\n|---|---|\n| `ELIO_IMAGE_PREVIEWS=1` | Force-enable on unrecognized terminals that support the Kitty Graphics Protocol |\n| `ELIO_ZOXIDE_OPTS` | Extra options appended to the zoxide interactive picker options |\n| `ELIO_DEBUG_PREVIEW` | Log image preview activity to `elio-preview.log` in the system temp directory |\n| `ELIO_LOG_MOUSE` | Log raw mouse events to `elio-mouse.log` in the system temp directory |\n\n\u003c/details\u003e\n\n---\n\n## Preview Coverage\n\nelio previews many file types directly in the Preview pane:\n\n- Text, source code, Markdown, logs, and structured data such as JSON, YAML, TOML, CSV/TSV, and SQLite\n- Documents such as PDFs, ebooks, Office files, OpenDocument files, and Apple Pages\n- Images, audio, and video metadata, with inline images, covers, and thumbnails when supported\n- Folders, archives, comic archives, torrents, ISO images, and other disk-image-style containers\n- Binary files with useful metadata when no richer preview is available\n\nSome richer previews require optional system tools such as Poppler, FFmpeg, resvg, 7-Zip, unar, or FontForge.\n\nSee the preview docs:\nhttps://elio-fm.github.io/docs/previews/\n\n---\n\n## Optional Preview Tools\n\nelio works out of the box, but a few external tools enable richer previews for specific file types:\n\n- `poppler` for PDF previews\n- `ffmpeg` / `ffprobe` for media metadata and thumbnails\n- `resvg` for SVG previews\n- `7z` / `unar` for archive previews\n- `fontforge` for font previews\n\nSee the full optional tools list and package names in the docs:\nhttps://elio-fm.github.io/docs/optional-tools/\n\n---\n\n## Using elio over SSH\n\nelio works well over SSH for navigation, file operations, text/code previews, and terminal-based workflows.\n\nRich visual previews depend on the remote host and the local terminal:\n\n- Text and code previews work normally.\n- Images, PDF pages, video thumbnails, album art, SVG previews, and archive extras need terminal image support plus optional preview tools installed on the remote host.\n- Terminal apps opened through `Open With` run inside the SSH session.\n- System openers such as `Enter`, `o`, `open`, `gio`, `xdg-open`, or `cmd /c start` use the remote host's opener stack. From an SSH session, they may open on the remote host, fail, or do nothing useful.\n\n---\n\n## Workflow\n\nelio supports common file-manager actions directly from the keyboard:\n\n- `Enter` opens folders or selected files with the system default application.\n- `O` opens files through the Open With flow when supported, including terminal apps.\n- `c` copies names, paths, or directory paths using OSC52 or the platform clipboard.\n- `g` opens quick jumps for common locations such as Home, Downloads, config, and Trash.\n- `d` moves files to Trash; `D` deletes permanently; in the Trash view, `d` also deletes permanently and `r` restores.\n- `f` searches folders, while `Ctrl+F` searches files in the current tree.\n- `z` jumps through zoxide history when `zoxide` is installed.\n- `!` opens a shell in the current folder and returns to elio when the shell exits.\n\nPlatform details vary for clipboard tools, trash backends, file openers, and shell selection. See the workflow docs:\nhttps://elio-fm.github.io/docs/workflow/\n\n---\n\n## Change Directory on Quit\n\nelio can leave your shell in the directory you were browsing when you quit:\n\n```bash\nelio shell install\n```\n\nRestart your shell, then run `elio` normally. Press `q` to quit and move your shell to elio's final directory, or `Q` to quit without changing directories.\n\nSee the shell integration docs for uninstall steps, supported shells, and manual setup:\nhttps://elio-fm.github.io/docs/shell-integration/\n\n---\n\n## Configuration\n\nelio reads configuration from:\n\n| Platform | Config file |\n|---|---|\n| Linux / BSD | `~/.config/elio/config.toml` or `$XDG_CONFIG_HOME/elio/config.toml` |\n| macOS | `~/Library/Application Support/elio/config.toml` |\n| Windows | `%APPDATA%\\elio\\config.toml` |\n\nSee [`examples/config.toml`](examples/config.toml) for an annotated example, or the configuration docs:\nhttps://elio-fm.github.io/docs/configuration/\n\n---\n\n## Theming\n\nelio themes are TOML files layered on top of the built-in defaults, so you only need to set the keys you want to change.\n\n| Platform | Theme file |\n|---|---|\n| Linux / BSD | `~/.config/elio/theme.toml` or `$XDG_CONFIG_HOME/elio/theme.toml` |\n| macOS | `~/Library/Application Support/elio/theme.toml` |\n| Windows | `%APPDATA%\\elio\\theme.toml` |\n\nSee [`assets/themes/default/theme.toml`](assets/themes/default/theme.toml) for the full default theme and [`examples/themes/`](examples/themes/) for ready-made themes.\n\nFor transparent or terminal-palette setups, see [`examples/themes/transparent/theme.toml`](examples/themes/transparent/theme.toml) and [`examples/themes/terminal-ansi/theme.toml`](examples/themes/terminal-ansi/theme.toml).\n\nTheme docs:\nhttps://elio-fm.github.io/docs/themes/\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eControls\u003c/strong\u003e\u003c/summary\u003e\n\nKeys marked with `*` are configurable in `[keys]` in `config.toml`; the defaults are shown here. Configurable actions accept one key, a list, or an empty list to unbind the action, such as `open_with = [\"O\", \"w\"]` or `delete_permanently = []`. Named keys are supported for arrows, `enter`, `space`, `tab`, `backtab` / `shift+tab`, `backspace`, `delete` / `del`, `pageup`, `pagedown`, `home`, `end`, and `F1`–`F12`; named keys and modifiers are case-insensitive, so `F2`, `PageUp`, and `Ctrl+O` work. Modifier bindings such as `ctrl+o`, `alt+o`, and `ctrl+enter` are also supported. Setting an action replaces its full default key list.\n\n### Navigation\n\n| Key | Action |\n|---|---|\n| `k` / `↑` `*` | Move up |\n| `j` / `↓` `*` | Move down |\n| `h` / `←` / `Backspace` `*` | Go to parent directory |\n| `l` / `→` `*` | Enter folder |\n| `Enter` `*` | Enter folder / open file or selection |\n| `g` `*` | Go-to menu (`g` top, `d` downloads, `h` home, `c` config folder, `t` trash) |\n| `Home` `*` | Jump to first item |\n| `G` / `End` `*` | Jump to last item |\n| `PageUp` / `PageDown` `*` | Page up / down |\n| `Tab` / `Shift+Tab` `*` | Cycle places |\n| `Alt+←` / `Alt+→` `*` | Back / forward in history |\n\n### Search\n\n| Key | Action |\n|---|---|\n| `f` `*` | Fuzzy-find folders in the current tree |\n| `Ctrl+F` `*` | Fuzzy-find files in the current tree |\n| `z` `*` | Jump with zoxide directory history |\n\n### File Actions\n\n| Key | Action |\n|---|---|\n| `o` `*` | Open focused item or selection with the system default application |\n| `O` `*` | Open With chooser |\n| `!` `*` | Open shell in current folder |\n| `a` `*` | Create file or folder |\n| `d` / `Del` `*` | Trash; permanently delete if already in trash |\n| `D` / `Shift+Del` `*` | Delete permanently |\n| `r` / `F2` `*` | Rename / bulk rename |\n| `r` `*` (in Trash) | Restore from trash |\n\n### View\n\n| Key | Action |\n|---|---|\n| `v` `*` | Toggle grid / list view |\n| `Ctrl++` / `Ctrl+-` | Grid zoom in / out |\n| `.` `*` | Show / hide dotfiles |\n| `s` `*` | Cycle sort (Name → Modified → Size) |\n\n### Preview\n\n| Key | Action |\n|---|---|\n| `Shift+K` / `[` `*` | Step page (PDF, comic, EPUB) or scroll preview up |\n| `Shift+J` / `]` `*` | Step page (PDF, comic, EPUB) or scroll preview down |\n| `Shift+H` / `Shift+L` `*` | Scroll preview left / right |\n\n### Selection and Clipboard\n\n| Key | Action |\n|---|---|\n| `Space` `*` | Toggle selection |\n| `Ctrl+A` `*` | Select all |\n| `y` `*` | Yank (copy) |\n| `x` `*` | Cut |\n| `p` `*` | Paste |\n| `-` `*` | Create absolute symlink from yanked items |\n| `_` `*` | Create relative symlink from yanked items |\n| `c` `*` | Copy path details to clipboard |\n\n### Mouse\n\n| Action | Description |\n|---|---|\n| Click | Select item |\n| Double-click | Open item |\n| Scroll | Scroll browser or preview |\n| `Shift+Scroll` | Scroll preview sideways |\n\n### General\n\n| Key | Action |\n|---|---|\n| `?` | Open help overlay |\n| `Esc` | Cancel / clear selection / close overlay |\n| `q` `*` | Quit |\n| `Q` `*` | Quit without changing the shell directory |\n\n\u003c/details\u003e\n\n---\n\n## License\n\n[MIT](LICENSE-MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felio-fm%2Felio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felio-fm%2Felio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felio-fm%2Felio/lists"}