{"id":13474899,"url":"https://github.com/eza-community/eza","last_synced_at":"2025-09-09T21:03:31.375Z","repository":{"id":184405066,"uuid":"671832156","full_name":"eza-community/eza","owner":"eza-community","description":"A modern alternative to ls","archived":false,"fork":false,"pushed_at":"2025-09-04T16:18:17.000Z","size":8446,"stargazers_count":17171,"open_issues_count":284,"forks_count":314,"subscribers_count":35,"default_branch":"main","last_synced_at":"2025-09-04T18:24:20.470Z","etag":null,"topics":["color","command-line","files","hacktoberfest","icons","ls","nerd-fonts","rust","terminal","tools"],"latest_commit_sha":null,"homepage":"https://eza.rocks","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"syphar/zetta","license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eza-community.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","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},"funding":{"github":"cafkafk"}},"created_at":"2023-07-28T08:35:55.000Z","updated_at":"2025-09-04T17:30:25.000Z","dependencies_parsed_at":"2023-07-29T09:30:42.160Z","dependency_job_id":"eb083547-8ddc-4d38-9050-5d04642ce6bb","html_url":"https://github.com/eza-community/eza","commit_stats":null,"previous_names":["cafkafk/zetta","cafkafk/eza","eza-community/eza"],"tags_count":92,"template":false,"template_full_name":null,"purl":"pkg:github/eza-community/eza","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eza-community%2Feza","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eza-community%2Feza/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eza-community%2Feza/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eza-community%2Feza/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eza-community","download_url":"https://codeload.github.com/eza-community/eza/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eza-community%2Feza/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273734403,"owners_count":25158273,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"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":["color","command-line","files","hacktoberfest","icons","ls","nerd-fonts","rust","terminal","tools"],"created_at":"2024-07-31T16:01:15.798Z","updated_at":"2025-09-09T21:03:31.363Z","avatar_url":"https://github.com/eza-community.png","language":"Rust","readme":"\u003c!--\nSPDX-FileCopyrightText: 2023-2024 Christina Sørensen\nSPDX-FileContributor: Christina Sørensen\n\nSPDX-License-Identifier: EUPL-1.2\n--\u003e\n\n\u003cdiv align=\"center\"\u003e\n\u003cdiv align=\"center\" markdown=\"1\"\u003e\n   \u003csup\u003eSpecial thanks to:\u003c/sup\u003e\n   \u003cbr\u003e\n   \u003cbr\u003e\n   \u003ca href=\"https://www.warp.dev/eza\"\u003e\n      \u003cimg alt=\"Warp sponsorship\" width=\"400\" src=\"https://github.com/user-attachments/assets/ab8dd143-b0fd-4904-bdc5-dd7ecac94eae\"\u003e\n   \u003c/a\u003e\n\n### [Warp, the AI terminal for developers](https://www.warp.dev/eza)\n[Available for MacOS, Linux, \u0026 Windows](https://www.warp.dev/eza)\u003cbr\u003e\n\n\u003c/div\u003e\n    \n# eza\n\nA modern replacement for ls.\n\n\u003ca href=\"https://matrix.to/#/#eza-community:gitter.im\"\u003e\u003cimg alt=\"Gitter\" src=\"https://img.shields.io/gitter/room/eza-community/eza?logo=element\u0026link=https%3A%2F%2Fapp.gitter.im%2F%23%2Froom%2F%23eza%3Agitter.im\u0026link=Gitter%20matrix%20room%20for%20Eza\" width=200\u003e\u003c/a\u003e\n\n[![Built with Nix](https://img.shields.io/badge/Built_With-Nix-5277C3.svg?logo=nixos\u0026labelColor=73C3D5)](https://nixos.org)\n[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)\n\n[![Unit tests](https://github.com/eza-community/eza/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/eza-community/eza/actions/workflows/unit-tests.yml)\n[![Crates.io](https://img.shields.io/crates/v/eza?link=https%3A%2F%2Fcrates.io%2Fcrates%2Feza)](https://crates.io/crates/eza)\n![Crates.io](https://img.shields.io/crates/l/eza?link=https%3A%2F%2Fgithub.com%2Feza-community%2Feza%2Fblob%2Fmain%2FLICENCE)\n\n\u003c/div\u003e\n\n![eza demo gif](docs/images/screenshots.png)\n\n---\n\n**eza** is a modern alternative for the venerable file-listing command-line program `ls` that ships with Unix and Linux operating systems, giving it more features and better defaults.\nIt uses colours to distinguish file types and metadata.\nIt knows about symlinks, extended attributes, and Git.\nAnd it’s **small**, **fast**, and just **one single binary**.\n\nBy deliberately making some decisions differently, eza attempts to be a more featureful, more user-friendly version of `ls`.\n\n---\n\n**eza** features not in exa (non-exhaustive):\n\n- Fixes [“The Grid Bug”](https://github.com/eza-community/eza/issues/66#issuecomment-1656758327) introduced in exa 2021.\n- Hyperlink support.\n- Mount point details.\n- Selinux context output.\n- Git repo status output.\n- Human readable relative dates.\n- Several security fixes.\n- Support for `bright` terminal colours.\n- Many smaller bug fixes/changes!\n- Configuration `theme.yml` file for customization of colors and icons.\n\n...and like, so much more that it became exhausting to update this all the time.\nLike seriously, we have a lot of good stuff.\n\n---\n\n\u003ca id=\"try-it\"\u003e\n\u003ch1\u003eTry it!\u003c/h1\u003e\n\u003c/a\u003e\n\n### Nix ❄️\n\nIf you already have Nix setup with flake support, you can try out eza with the `nix run` command:\n\n    nix run github:eza-community/eza\n\nNix will build eza and run it.\n\nIf you want to pass arguments this way, use e.g. `nix run github:eza-community/eza -- -ol`.\n\n# Installation\n\neza is available for Windows, macOS and Linux. Platform and distribution\nspecific installation instructions can be found in [INSTALL.md](INSTALL.md).\n\n[![Packaging status](https://repology.org/badge/vertical-allrepos/eza.svg?columns=3)](https://repology.org/project/eza/versions)\n\n---\n\n\u003ca id=\"options\"\u003e\n\u003ch1\u003eCommand-line options\u003c/h1\u003e\n\u003c/a\u003e\n\neza’s options are almost, but not quite, entirely unlike `ls`’s. Quick overview:\n\n## Display options\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n- **-1**, **--oneline**: display one entry per line\n- **-G**, **--grid**: display entries as a grid (default)\n- **-l**, **--long**: display extended details and attributes\n- **-R**, **--recurse**: recurse into directories\n- **-T**, **--tree**: recurse into directories as a tree\n- **-x**, **--across**: sort the grid across, rather than downwards\n- **-F**, **--classify=(when)**: display type indicator by file names (always, auto, never)\n- **--colo[u]r=(when)**: when to use terminal colours (always, auto, never)\n- **--colo[u]r-scale=(field)**: highlight levels of `field` distinctly(all, age, size)\n- **--color-scale-mode=(mode)**: use gradient or fixed colors in --color-scale. valid options are `fixed` or `gradient`\n- **--icons=(when)**: when to display icons (always, auto, never)\n- **--hyperlink**: display entries as hyperlinks\n- **--absolute=(mode)**: display entries with their absolute path (on, follow, off)\n- **-w**, **--width=(columns)**: set screen width in columns\n\n\u003c/details\u003e\n\n## Filtering options\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n- **-a**, **--all**: show hidden and 'dot' files\n- **-d**, **--list-dirs**: list directories like regular files\n- **-L**, **--level=(depth)**: limit the depth of recursion\n- **-r**, **--reverse**: reverse the sort order\n- **-s**, **--sort=(field)**: which field to sort by\n- **--group-directories-first**: list directories before other files\n- **--group-directories-last**: list directories after other files\n- **-D**, **--only-dirs**: list only directories\n- **-f**, **--only-files**: list only files\n- **--no-symlinks**: don't show symbolic links\n- **--show-symlinks**: explicitly show links (with `--only-dirs`, `--only-files`, to show symlinks that match the filter)\n- **--git-ignore**: ignore files mentioned in `.gitignore`\n- **-I**, **--ignore-glob=(globs)**: glob patterns (pipe-separated) of files to ignore\n\nPass the `--all` option twice to also show the `.` and `..` directories.\n\n\u003c/details\u003e\n\n## Long view options\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\nThese options are available when running with `--long` (`-l`):\n\n- **-b**, **--binary**: list file sizes with binary prefixes\n- **-B**, **--bytes**: list file sizes in bytes, without any prefixes\n- **-g**, **--group**: list each file’s group\n- **--smart-group**: only show group if it has a different name from owner\n- **-h**, **--header**: add a header row to each column\n- **-H**, **--links**: list each file’s number of hard links\n- **-i**, **--inode**: list each file’s inode number\n- **-m**, **--modified**: use the modified timestamp field\n- **-M**, **--mounts**: Show mount details (Linux and MacOS only).\n- **-S**, **--blocksize**: show size of allocated file system blocks\n- **-t**, **--time=(field)**: which timestamp field to use\n- **-u**, **--accessed**: use the accessed timestamp field\n- **-U**, **--created**: use the created timestamp field\n- **-X**, **--dereference**: dereference symlinks for file information\n- **-Z**, **--context**: list each file’s security context\n- **-@**, **--extended**: list each file’s extended attributes and sizes\n- **--changed**: use the changed timestamp field\n- **--git**: list each file’s Git status, if tracked or ignored\n- **--git-repos**: list each directory’s Git status, if tracked\n- **--git-repos-no-status**: list whether a directory is a Git repository, but not its status (faster)\n- **--no-git**: suppress Git status (always overrides `--git`, `--git-repos`, `--git-repos-no-status`)\n- **--time-style**: how to format timestamps. valid timestamp styles are ‘`default`’, ‘`iso`’, ‘`long-iso`’, ‘`full-iso`’, ‘`relative`’, or a custom style ‘`+\u003cFORMAT\u003e`’ (E.g., ‘`+%Y-%m-%d %H:%M`’ =\u003e ‘`2023-09-30 13:00`’. For more specifications on the format string, see the _`eza(1)` manual page_ and [chrono documentation](https://docs.rs/chrono/latest/chrono/format/strftime/index.html).).\n- **--total-size**: show recursive directory size\n- **--no-permissions**: suppress the permissions field\n- **-o**, **--octal-permissions**: list each file's permission in octal format\n- **--no-filesize**: suppress the filesize field\n- **--no-user**: suppress the user field\n- **--no-time**: suppress the time field\n- **--stdin**: read file names from stdin\n\nSome of the options accept parameters:\n\n- Valid **--colo\\[u\\]r** options are **always**, **automatic** (or **auto** for short), and **never**.\n- Valid sort fields are **accessed**, **changed**, **created**, **extension**, **Extension**, **inode**, **modified**, **name**, **Name**, **size**, **type**, and **none**. Fields starting with a capital letter sort uppercase before lowercase. The modified field has the aliases **date**, **time**, and **newest**, while its reverse has the aliases **age** and **oldest**.\n- Valid time fields are **modified**, **changed**, **accessed**, and **created**.\n- Valid time styles are **default**, **iso**, **long-iso**, **full-iso**, and **relative**.\n\n\n\nSee the `man` pages for further documentation of usage. They are available\n- online [in the repo](https://github.com/eza-community/eza/tree/main/man)\n- in your terminal via `man eza`, as of version [`[0.18.13] - 2024-04-25`](https://github.com/eza-community/eza/blob/main/CHANGELOG.md#01813---2024-04-25)\n\u003c/details\u003e\n\n\n## Custom Themes\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n**Eza** has recently added support for a `theme.yml` file, where you can specify all of the existing theme-ing options\navailable for the `LS_COLORS` and `EXA_COLORS` environment variables, as well as the option to specify different icons\nfor different file types and extensions. Any existing environment variables set will continue to work and will take\nprecedence for backwards compatibility.\n\n#### **New** Pre-made themes\nCheck out the themes available in the official [eza-themes](https://github.com/eza-community/eza-themes) repository, or contribute your own.\n\nAn example theme file is available in `docs/theme.yml`, and needs to either be placed in a directory specified by the \nenvironment variable `EZA_CONFIG_DIR`, or will looked for by default in `$XDG_CONFIG_HOME/eza`.\n\nFull details are available on the [man page](https://github.com/eza-community/eza/tree/main/man/eza_colors-explanation.5.md) and an example theme file is included [here](https://github.com/eza-community/eza/tree/main/docs/theme.yml)\n\n\u003c/details\u003e\n\n\n# Hacking on eza\n\nIf you wanna contribute to eza, firstly, you're expected to follow our \n[code of conduct](https://github.com/eza-community/eza/blob/main/CODE_OF_CONDUCT.md). \nAfter having understood the code of conduct, you can have a look at our\n[CONTRIBUTING.md](https://github.com/eza-community/eza/blob/main/CONTRIBUTING.md) \nfor more info about actual hacking.\n\n[![Star History Chart](https://api.star-history.com/svg?repos=eza-community/eza\u0026type=Date)](https://star-history.com/#eza-community/eza\u0026Date)\n","funding_links":["https://github.com/sponsors/cafkafk"],"categories":["Rust","Files and Directories","Shell","Uncategorized","Other Tools","Applications","Command Line","Command Line Tools","Command Line Utilities","Included Software","FileSystem","Tools",":hammer_and_wrench: My Tools","tools","terminal","Packages","Table of Contents","Terminal","🐧 Linux","Lovely Commands","\u003ca name=\"ls\"\u003e\u003c/a\u003eFile listing (alternatives to ls)","Miscellaneous Tools","工具","Table of contents"],"sub_categories":["Directory Listing","Javascript","Uncategorized","Bonus","System tools","Dependency Management","Tools","Acknowledgments","Rust",":floppy_disk: My Software","CLI Tools","Terminal Utilities","shell","多模态","CLI"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feza-community%2Feza","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feza-community%2Feza","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feza-community%2Feza/lists"}