<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>README.md - fork/eza @ v0.15.3</title>
<meta name="description" content="README.md in fork/eza at v0.15.3.">
<meta property="og:title" content="README.md - fork/eza @ v0.15.3">
<meta property="og:description" content="README.md in fork/eza at v0.15.3.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="v0.15.3" data-tip="9683862a42089a7ffc30948d5c246893056e150a">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/eza</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/eza</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Christina Sørensen</span><span class="commit-message" data-commit="288696db10bea36b2c7952628f679f91a7298151">feat: add `--color-scale`</span><span class="snapshot-sha sha" data-commit="288696db10bea36b2c7952628f679f91a7298151">288696db</span><time datetime="2023-11-08T18:53:10+01:00" title="2023-11-08 18:53:10 +0100">2023-11-08</time></p>
<header class="topbar"><details class="switcher"><summary>v0.15.3</summary><div class="menu"><strong>branches</strong><a href="/fork/eza/ref/main/">main</a><strong>tags</strong><a href="/fork/eza/ref/v0.14.1/">v0.14.1</a><a href="/fork/eza/ref/v0.14.2/">v0.14.2</a><a href="/fork/eza/ref/v0.15.0/">v0.15.0</a><a href="/fork/eza/ref/v0.15.1/">v0.15.1</a><a href="/fork/eza/ref/v0.15.2/">v0.15.2</a><a class="current" href="/fork/eza/ref/v0.15.3/">v0.15.3</a><a href="/fork/eza/ref/v0.16.0/">v0.16.0</a><a href="/fork/eza/ref/v0.16.1/">v0.16.1</a><a class="all" href="/fork/eza/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/eza/">eza</a> / <span class="cur">README.md</span></nav>
<span class="view-stats"><span>7.6 KiB</span><span>163 lines</span></span><span class="actions"><a class="raw" href="/fork/eza/raw/74f5c4f9075a20883968aaac0b20b7b6c39db0d8/README.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered">&lt;div align="center"&gt;
<h1>eza</h1>
<p>A modern, maintained replacement for ls.</p>
<p>&lt;a href="https://matrix.to/#/#eza-community:gitter.im"&gt;&lt;img alt="Gitter" src="https://img.shields.io/gitter/room/eza-community/eza?logo=element&amp;link=https%3A%2F%2Fapp.gitter.im%2F%23%2Froom%2F%23eza%3Agitter.im&amp;link=Gitter%20matrix%20room%20for%20Eza" width=200&gt;&lt;/a&gt;</p>
<p><a href="https://nixos.org"><img src="https://img.shields.io/badge/Built_With-Nix-5277C3.svg?logo=nixos&amp;labelColor=73C3D5" alt="Built with Nix" /></a>
<a href="/fork/eza/ref/v0.15.3/blob/CODE_OF_CONDUCT.md"><img src="https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg" alt="Contributor Covenant" /></a></p>
<p><a href="https://github.com/eza-community/eza/actions/workflows/unit-tests.yml"><img src="https://github.com/eza-community/eza/actions/workflows/unit-tests.yml/badge.svg" alt="Unit tests" /></a>
<img src="https://img.shields.io/crates/v/eza?link=https%3A%2F%2Fcrates.io%2Fcrates%2Feza" alt="Crates.io" />
<img src="https://img.shields.io/crates/l/eza?link=https%3A%2F%2Fgithub.com%2Feza-community%2Feza%2Fblob%2Fmain%2FLICENCE" alt="Crates.io" /></p>
&lt;/div&gt;
<p><img src="/fork/eza/raw/a8770f8e821da90578ebe6c05a3477025efc3db2/docs/images/screenshots.png" alt="eza demo gif" /></p>
<hr />
<p><strong>eza</strong> is a modern, maintained replacement for the venerable file-listing command-line program <code>ls</code> that ships with Unix and Linux operating systems, giving it more features and better defaults.
It uses colours to distinguish file types and metadata.
It knows about symlinks, extended attributes, and Git.
And it’s <strong>small</strong>, <strong>fast</strong>, and just <strong>one single binary</strong>.</p>
<p>By deliberately making some decisions differently, eza attempts to be a more featureful, more user-friendly version of <code>ls</code>.</p>
<hr />
<p><strong>eza</strong> features not in exa (non-exhaustive):</p>
<ul>
<li>Fixes <a href="https://github.com/eza-community/eza/issues/66#issuecomment-1656758327">“The Grid Bug”</a> introduced in exa 2021.</li>
<li>Hyperlink support.</li>
<li>Mount point details.</li>
<li>Selinux context output.</li>
<li>Git repo status output.</li>
<li>Human readable relative dates.</li>
<li>Several security fixes.</li>
<li>Support for <code>bright</code> terminal colours.</li>
<li>Many smaller bug fixes/changes!</li>
</ul>
<p>...and like, so much more that it became exhausting to update this all the time.
Like seriously, we have a lot of good stuff.</p>
<hr />
&lt;a id="try-it"&gt;
&lt;h1&gt;Try it!&lt;/h1&gt;
&lt;/a&gt;
<h3>Nix ❄️</h3>
<p>If you already have Nix setup with flake support, you can try out eza with the <code>nix run</code> command:</p>
<pre><code>nix run github:eza-community/eza
</code></pre>
<p>Nix will build eza and run it.</p>
<p>If you want to pass arguments this way, use e.g. <code>nix run github:eza-community/eza -- -ol</code>.</p>
<h1>Installation</h1>
<p>eza is available for Windows, macOS and Linux. Platform and distribution
specific installation instructions can be found in <a href="/fork/eza/ref/v0.15.3/blob/INSTALL.md">INSTALL.md</a>.</p>
<p><a href="https://repology.org/project/eza/versions"><img src="https://repology.org/badge/vertical-allrepos/eza.svg" alt="Packaging status" /></a></p>
<hr />
<p>Click sections to expand.</p>
&lt;a id="options"&gt;
&lt;details&gt;
    &lt;summary&gt; Command-line options &lt;/summary&gt;
&lt;h1&gt;Command-line options&lt;/h1&gt;
&lt;/a&gt;
<p>eza’s options are almost, but not quite, entirely unlike <code>ls</code>’s.</p>
<h3>Display options</h3>
<ul>
<li><strong>-1</strong>, <strong>--oneline</strong>: display one entry per line</li>
<li><strong>-G</strong>, <strong>--grid</strong>: display entries as a grid (default)</li>
<li><strong>-l</strong>, <strong>--long</strong>: display extended details and attributes</li>
<li><strong>-R</strong>, <strong>--recurse</strong>: recurse into directories</li>
<li><strong>-T</strong>, <strong>--tree</strong>: recurse into directories as a tree</li>
<li><strong>-x</strong>, <strong>--across</strong>: sort the grid across, rather than downwards</li>
<li><strong>-F</strong>, <strong>--classify</strong>: display type indicator by file names</li>
<li><strong>--colo[u]r=(when)</strong>: when to use terminal colours (always, auto, never)</li>
<li><strong>--colo[u]r-scale=(field)</strong>: highlight levels of <code>field</code> distinctly(all, age, size)</li>
<li><strong>--color-scale-mode=(mode)</strong>: use gradient or fixed colors in --color-scale. valid options are <code>fixed</code> or <code>gradient</code></li>
<li><strong>--icons=(when)</strong>: when to display icons (always, auto, never)</li>
<li><strong>--hyperlink</strong>: display entries as hyperlinks</li>
<li><strong>-w</strong>, <strong>--width=(columns)</strong>: set screen width in columns</li>
</ul>
<h3>Filtering options</h3>
<ul>
<li><strong>-a</strong>, <strong>--all</strong>: show hidden and 'dot' files</li>
<li><strong>-d</strong>, <strong>--list-dirs</strong>: list directories like regular files</li>
<li><strong>-L</strong>, <strong>--level=(depth)</strong>: limit the depth of recursion</li>
<li><strong>-r</strong>, <strong>--reverse</strong>: reverse the sort order</li>
<li><strong>-s</strong>, <strong>--sort=(field)</strong>: which field to sort by</li>
<li><strong>--group-directories-first</strong>: list directories before other files</li>
<li><strong>-D</strong>, <strong>--only-dirs</strong>: list only directories</li>
<li><strong>-f</strong>, <strong>--only-files</strong>: list only files</li>
<li><strong>--git-ignore</strong>: ignore files mentioned in <code>.gitignore</code></li>
<li><strong>-I</strong>, <strong>--ignore-glob=(globs)</strong>: glob patterns (pipe-separated) of files to ignore</li>
</ul>
<p>Pass the <code>--all</code> option twice to also show the <code>.</code> and <code>..</code> directories.</p>
<h3>Long view options</h3>
<p>These options are available when running with <code>--long</code> (<code>-l</code>):</p>
<ul>
<li><strong>-b</strong>, <strong>--binary</strong>: list file sizes with binary prefixes</li>
<li><strong>-B</strong>, <strong>--bytes</strong>: list file sizes in bytes, without any prefixes</li>
<li><strong>-g</strong>, <strong>--group</strong>: list each file’s group</li>
<li><strong>-h</strong>, <strong>--header</strong>: add a header row to each column</li>
<li><strong>-H</strong>, <strong>--links</strong>: list each file’s number of hard links</li>
<li><strong>-i</strong>, <strong>--inode</strong>: list each file’s inode number</li>
<li><strong>-m</strong>, <strong>--modified</strong>: use the modified timestamp field</li>
<li><strong>-M</strong>, <strong>--mounts</strong>: Show mount details (Linux and MacOS only).</li>
<li><strong>-S</strong>, <strong>--blocksize</strong>: show size of allocated file system blocks</li>
<li><strong>-t</strong>, <strong>--time=(field)</strong>: which timestamp field to use</li>
<li><strong>-u</strong>, <strong>--accessed</strong>: use the accessed timestamp field</li>
<li><strong>-U</strong>, <strong>--created</strong>: use the created timestamp field</li>
<li><strong>-X</strong>, <strong>--dereference</strong>: dereference symlinks for file information</li>
<li><strong>-Z</strong>, <strong>--context</strong>: list each file’s security context</li>
<li><strong>-@</strong>, <strong>--extended</strong>: list each file’s extended attributes and sizes</li>
<li><strong>--changed</strong>: use the changed timestamp field</li>
<li><strong>--git</strong>: list each file’s Git status, if tracked or ignored</li>
<li><strong>--git-repos</strong>: list each directory’s Git status, if tracked</li>
<li><strong>--git-repos-no-status</strong>: list whether a directory is a Git repository, but not its status (faster)</li>
<li><strong>--no-git</strong>: suppress Git status (always overrides <code>--git</code>, <code>--git-repos</code>, <code>--git-repos-no-status</code>)</li>
<li><strong>--time-style</strong>: how to format timestamps. valid timestamp styles are ‘<code>default</code>’, ‘<code>iso</code>’, ‘<code>long-iso</code>’, ‘<code>full-iso</code>’, ‘<code>relative</code>', or you can use a <code>custom</code> style with '<code>+</code>' as prefix. (Ex: "<code>+%Y/%m/%d, %H:%M</code>" =&gt; "<code>2023/9/30, 12:00</code>"). <a href="https://docs.rs/chrono/latest/chrono/format/strftime/index.html">more about format syntax</a>.</li>
<li><strong>--total-size</strong>: show recursive directory size</li>
<li><strong>--no-permissions</strong>: suppress the permissions field</li>
<li><strong>-o</strong>, <strong>--octal-permissions</strong>: list each file's permission in octal format</li>
<li><strong>--no-filesize</strong>: suppress the filesize field</li>
<li><strong>--no-user</strong>: suppress the user field</li>
<li><strong>--no-time</strong>: suppress the time field</li>
</ul>
<p>Some of the options accept parameters:</p>
<ul>
<li>Valid <strong>--colo[u]r</strong> options are <strong>always</strong>, <strong>automatic</strong> (or <strong>auto</strong> for short), and <strong>never</strong>.</li>
<li>Valid sort fields are <strong>accessed</strong>, <strong>changed</strong>, <strong>created</strong>, <strong>extension</strong>, <strong>Extension</strong>, <strong>inode</strong>, <strong>modified</strong>, <strong>name</strong>, <strong>Name</strong>, <strong>size</strong>, <strong>type</strong>, and <strong>none</strong>. Fields starting with a capital letter sort uppercase before lowercase. The modified field has the aliases <strong>date</strong>, <strong>time</strong>, and <strong>newest</strong>, while its reverse has the aliases <strong>age</strong> and <strong>oldest</strong>.</li>
<li>Valid time fields are <strong>modified</strong>, <strong>changed</strong>, <strong>accessed</strong>, and <strong>created</strong>.</li>
<li>Valid time styles are <strong>default</strong>, <strong>iso</strong>, <strong>long-iso</strong>, <strong>full-iso</strong>, and <strong>relative</strong>.</li>
</ul>
&lt;/details&gt;
<h1>Hacking on eza</h1>
<p>If you wanna contribute to eza, firstly, you're expected to follow our
<a href="https://github.com/eza-community/eza/blob/main/CODE_OF_CONDUCT.md">code of conduct</a>.
After having understood the code of conduct, you can have a look at our
<a href="https://github.com/eza-community/eza/blob/main/CONTRIBUTING.md">CONTRIBUTING.md</a>
for more info about actual hacking.</p>
<p><a href="https://star-history.com/#eza-community/eza&amp;Date"><img src="https://api.star-history.com/svg?repos=eza-community/eza&amp;type=Date" alt="Star History Chart" /></a></p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>&lt;</a-p><a-tg>div</a-tg> <a-at>align</a-at>=&quot;<a-s>center</a-s>&quot;<a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text"><a-p># </a-p><a-tt>eza</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"><a-p>A modern, maintained replacement for ls.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-p>&lt;a href=&quot;https://matrix.to/#/#eza-community:gitter.im&quot;&gt;&lt;img alt=&quot;Gitter&quot; src=&quot;https://img.shields.io/gitter/room/eza-community/eza?logo=element&amp;link=https%3A%2F%2Fapp.gitter.im%2F%23%2Froom%2F%23eza%3Agitter.im&amp;link=Gitter%20matrix%20room%20for%20Eza&quot; width=200&gt;&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>[![Built with Nix](https://img.shields.io/badge/Built_With-Nix-5277C3.svg?logo=nixos&amp;labelColor=73C3D5)](https://nixos.org)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>[![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)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"><a-p>![Crates.io](https://img.shields.io/crates/v/eza?link=https%3A%2F%2Fcrates.io%2Fcrates%2Feza)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>![Crates.io](https://img.shields.io/crates/l/eza?link=https%3A%2F%2Fgithub.com%2Feza-community%2Feza%2Fblob%2Fmain%2FLICENCE)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>&lt;/div&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>![eza demo gif](docs/images/screenshots.png)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>**eza** is a modern, maintained replacement for the venerable file-listing command-line program `ls` that ships with Unix and Linux operating systems, giving it more features and better defaults.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>It uses colours to distinguish file types and metadata.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>It knows about symlinks, extended attributes, and Git.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>And it’s **small**, **fast**, and just **one single binary**.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>By deliberately making some decisions differently, eza attempts to be a more featureful, more user-friendly version of `ls`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>**eza** features not in exa (non-exhaustive):</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>- Fixes [“The Grid Bug”](https://github.com/eza-community/eza/issues/66#issuecomment-1656758327) introduced in exa 2021.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>- Hyperlink support.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>- Mount point details.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"><a-p>- Selinux context output.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>- Git repo status output.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"><a-p>- Human readable relative dates.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>- Several security fixes.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>- Support for `bright` terminal colours.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>- Many smaller bug fixes/changes!</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>...and like, so much more that it became exhausting to update this all the time.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>Like seriously, we have a lot of good stuff.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>id</a-at><a-p>=&quot;</a-p><a-s>try-it</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"><a-p>&lt;</a-p><a-tg>h1</a-tg><a-p>&gt;Try it!&lt;/</a-p><a-tg>h1</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>&lt;/</a-p><a-tg>a</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>### </a-p><a-tt>Nix ❄️</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"><a-p>If you already have Nix setup with flake support, you can try out eza with the `nix run` command:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"><a-tl>    nix run github:eza-community/eza</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>Nix will build eza and run it.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>If you want to pass arguments this way, use e.g. `nix run github:eza-community/eza -- -ol`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p># </a-p><a-tt>Installation</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"><a-p>eza is available for Windows, macOS and Linux. Platform and distribution</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>specific installation instructions can be found in [INSTALL.md](INSTALL.md).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"><a-p>[![Packaging status](https://repology.org/badge/vertical-allrepos/eza.svg)](https://repology.org/project/eza/versions)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"><a-p>---</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>Click sections to expand.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>&lt;</a-p><a-tg>a</a-tg><a-p> </a-p><a-at>id</a-at><a-p>=&quot;</a-p><a-s>options</a-s><a-p>&quot;&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>&lt;</a-p><a-tg>details</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>    &lt;</a-p><a-tg>summary</a-tg><a-p>&gt; Command-line options &lt;/</a-p><a-tg>summary</a-tg><a-p>&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>&lt;h1&gt;Command-line options&lt;/h1&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"><a-p>&lt;/a&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>eza’s options are almost, but not quite, entirely unlike `ls`’s.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>### </a-p><a-tt>Display options</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>- **-1**, **--oneline**: display one entry per line</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>- **-G**, **--grid**: display entries as a grid (default)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"><a-p>- **-l**, **--long**: display extended details and attributes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>- **-R**, **--recurse**: recurse into directories</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"><a-p>- **-T**, **--tree**: recurse into directories as a tree</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>- **-x**, **--across**: sort the grid across, rather than downwards</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"><a-p>- **-F**, **--classify**: display type indicator by file names</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>- **--colo[u]r=(when)**: when to use terminal colours (always, auto, never)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>- **--colo[u]r-scale=(field)**: highlight levels of `field` distinctly(all, age, size)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>- **--color-scale-mode=(mode)**: use gradient or fixed colors in --color-scale. valid options are `fixed` or `gradient`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>- **--icons=(when)**: when to display icons (always, auto, never)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"><a-p>- **--hyperlink**: display entries as hyperlinks</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>- **-w**, **--width=(columns)**: set screen width in columns</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"><a-p>### </a-p><a-tt>Filtering options</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"><a-p>- **-a**, **--all**: show hidden and &#39;dot&#39; files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>- **-d**, **--list-dirs**: list directories like regular files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>- **-L**, **--level=(depth)**: limit the depth of recursion</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>- **-r**, **--reverse**: reverse the sort order</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>- **-s**, **--sort=(field)**: which field to sort by</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>- **--group-directories-first**: list directories before other files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>- **-D**, **--only-dirs**: list only directories</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"><a-p>- **-f**, **--only-files**: list only files</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>- **--git-ignore**: ignore files mentioned in `.gitignore`</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"><a-p>- **-I**, **--ignore-glob=(globs)**: glob patterns (pipe-separated) of files to ignore</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"><a-p>Pass the `--all` option twice to also show the `.` and `..` directories.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text"><a-p>### </a-p><a-tt>Long view options</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text"><a-p>These options are available when running with `--long` (`-l`):</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L118" href="#L118">118</a><span class="code-text"><a-p>- **-b**, **--binary**: list file sizes with binary prefixes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L119" href="#L119">119</a><span class="code-text"><a-p>- **-B**, **--bytes**: list file sizes in bytes, without any prefixes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L120" href="#L120">120</a><span class="code-text"><a-p>- **-g**, **--group**: list each file’s group</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L121" href="#L121">121</a><span class="code-text"><a-p>- **-h**, **--header**: add a header row to each column</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L122" href="#L122">122</a><span class="code-text"><a-p>- **-H**, **--links**: list each file’s number of hard links</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L123" href="#L123">123</a><span class="code-text"><a-p>- **-i**, **--inode**: list each file’s inode number</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L124" href="#L124">124</a><span class="code-text"><a-p>- **-m**, **--modified**: use the modified timestamp field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L125" href="#L125">125</a><span class="code-text"><a-p>- **-M**, **--mounts**: Show mount details (Linux and MacOS only).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L126" href="#L126">126</a><span class="code-text"><a-p>- **-S**, **--blocksize**: show size of allocated file system blocks</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L127" href="#L127">127</a><span class="code-text"><a-p>- **-t**, **--time=(field)**: which timestamp field to use</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L128" href="#L128">128</a><span class="code-text"><a-p>- **-u**, **--accessed**: use the accessed timestamp field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L129" href="#L129">129</a><span class="code-text"><a-p>- **-U**, **--created**: use the created timestamp field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L130" href="#L130">130</a><span class="code-text"><a-p>- **-X**, **--dereference**: dereference symlinks for file information</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L131" href="#L131">131</a><span class="code-text"><a-p>- **-Z**, **--context**: list each file’s security context</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L132" href="#L132">132</a><span class="code-text"><a-p>- **-@**, **--extended**: list each file’s extended attributes and sizes</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L133" href="#L133">133</a><span class="code-text"><a-p>- **--changed**: use the changed timestamp field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L134" href="#L134">134</a><span class="code-text"><a-p>- **--git**: list each file’s Git status, if tracked or ignored</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L135" href="#L135">135</a><span class="code-text"><a-p>- **--git-repos**: list each directory’s Git status, if tracked</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L136" href="#L136">136</a><span class="code-text"><a-p>- **--git-repos-no-status**: list whether a directory is a Git repository, but not its status (faster)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L137" href="#L137">137</a><span class="code-text"><a-p>- **--no-git**: suppress Git status (always overrides `--git`, `--git-repos`, `--git-repos-no-status`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L138" href="#L138">138</a><span class="code-text"><a-p>- **--time-style**: how to format timestamps. valid timestamp styles are ‘`default`’, ‘`iso`’, ‘`long-iso`’, ‘`full-iso`’, ‘`relative`&#39;, or you can use a `custom` style with &#39;`+`&#39; as prefix. (Ex: &quot;`+%Y/%m/%d, %H:%M`&quot; =&gt; &quot;`2023/9/30, 12:00`&quot;). [more about format syntax](https://docs.rs/chrono/latest/chrono/format/strftime/index.html).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L139" href="#L139">139</a><span class="code-text"><a-p>- **--total-size**: show recursive directory size</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L140" href="#L140">140</a><span class="code-text"><a-p>- **--no-permissions**: suppress the permissions field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L141" href="#L141">141</a><span class="code-text"><a-p>- **-o**, **--octal-permissions**: list each file&#39;s permission in octal format</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L142" href="#L142">142</a><span class="code-text"><a-p>- **--no-filesize**: suppress the filesize field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L143" href="#L143">143</a><span class="code-text"><a-p>- **--no-user**: suppress the user field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L144" href="#L144">144</a><span class="code-text"><a-p>- **--no-time**: suppress the time field</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L145" href="#L145">145</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L146" href="#L146">146</a><span class="code-text"><a-p>Some of the options accept parameters:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L147" href="#L147">147</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L148" href="#L148">148</a><span class="code-text"><a-p>- Valid **--colo\[u\]r** options are **always**, **automatic** (or **auto** for short), and **never**.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L149" href="#L149">149</a><span class="code-text"><a-p>- 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**.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L150" href="#L150">150</a><span class="code-text"><a-p>- Valid time fields are **modified**, **changed**, **accessed**, and **created**.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L151" href="#L151">151</a><span class="code-text"><a-p>- Valid time styles are **default**, **iso**, **long-iso**, **full-iso**, and **relative**.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L152" href="#L152">152</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L153" href="#L153">153</a><span class="code-text"><a-p>&lt;/details&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L154" href="#L154">154</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L155" href="#L155">155</a><span class="code-text"><a-p># </a-p><a-tt>Hacking on eza</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L156" href="#L156">156</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L157" href="#L157">157</a><span class="code-text">If you wanna contribute to eza, firstly, you&#39;re expected to follow our </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L158" href="#L158">158</a><span class="code-text">[code of conduct](https://github.com/eza-community/eza/blob/main/CODE_OF_CONDUCT.md). </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L159" href="#L159">159</a><span class="code-text">After having understood the code of conduct, you can have a look at our</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L160" href="#L160">160</a><span class="code-text">[CONTRIBUTING.md](https://github.com/eza-community/eza/blob/main/CONTRIBUTING.md) </span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L161" href="#L161">161</a><span class="code-text">for more info about actual hacking.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L162" href="#L162">162</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L163" href="#L163">163</a><span class="code-text">[![Star History Chart](https://api.star-history.com/svg?repos=eza-community/eza&amp;type=Date)](https://star-history.com/#eza-community/eza&amp;Date)</span></span></pre></div></div>
</main>
</body>
</html>
