# Install lsd with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, scoop, winget, zypper

Clone of ls with colorful output, file type icons, and more. Version 1.2.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:lsd
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install lsd
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install lsd
```

  Evidence: MacPorts ports tree: sysutils/lsd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add lsd
```

  Evidence: Alpine Linux edge package indexes: lsd from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install lsd
```

  Evidence: Debian stable package indexes: lsd from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install lsd
```

  Evidence: Fedora Rawhide package metadata: lsd from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#lsd
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ls/lsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S lsd
```

  Evidence: Arch Linux sync databases: lsd from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install lsd
```

  Evidence: openSUSE Tumbleweed package metadata: lsd from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/lsd
```

  Evidence: Scoop official bucket manifest trees: bucket/lsd.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id lsd-rs.lsd -e
```

  Evidence: Windows Package Manager source index: lsd-rs.lsd from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:lsd
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/lsd>
- **Version:** 1.2.0
- **Source summary:** Clone of ls with colorful output, file type icons, and more
- **Homepage:** <https://github.com/lsd-rs/lsd>
- **Repository:** <https://github.com/lsd-rs/lsd>
- **Upstream docs:** <https://github.com/lsd-rs/lsd#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/lsd-rs/lsd/archive/refs/tags/v1.2.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- lsd (cli)
- lsd (alias)

## Build dependencies

- pandoc
- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.2.0
- Local data: ok
- Upstream repository: https://github.com/lsd-rs/lsd
- Upstream latest detected: v1.2.0 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

lsd is a Rust implementation of a modern `ls`-style file-listing command with color, icons, themes, and configuration.

### Project history

The official repository describes lsd as 'the next gen ls command'. It was created on GitHub in November 2018 and early releases appeared in December 2018, followed by v1.0.0 in August 2023 and v1.2.0 in October 2025.

The README documents a familiar package-manager installation matrix across Linux distributions, macOS, BSDs, Windows, and source builds. It also credits the colorls project and sharkdp's fd project for inspiration and CI ideas.

### Adoption history

lsd has become one of the best-known modern `ls` replacements in package-manager culture. GitHub metadata showed about 16k stars and over 500 forks by July 2026, and the supplied package-manager facts list Alpine, Homebrew, Debian, Fedora, MacPorts, Nix, Arch, Scoop, Ubuntu, WinGet, and openSUSE.

Its adoption follows the broader terminal-aesthetics wave around Nerd Fonts, icons, themes, and Rust CLI tools: users often install it alongside shells, prompt themes, and other replacements for classic Unix commands.

### How it is used

Users run `lsd` directly or alias `ls` to `lsd` in shell startup files. The README documents icon prerequisites, package-manager installation commands, and optional shell configuration.

Customization is via `config.yaml`, `colors.yaml`, and `icons.yaml` under the lsd configuration directory. On Unix-like systems the README says lsd follows XDG and checks `$HOME/.config/lsd` and `$XDG_CONFIG_HOME/lsd`; on Windows it checks `%USERPROFILE%\.config\lsd` and `%APPDATA%\lsd`.

### Why package nerds care

lsd is significant because it packages a complete modern terminal visual style into a small command. For package nerds, it is the canonical example of a Rust CLI replacing a core Unix affordance while still fitting naturally into Homebrew, distro repositories, and Windows package managers.

### Timeline

- 2018: GitHub repository created and early 0.x releases published.
- 2023: v1.0.0 released.
- 2025: v1.2.0 released.
- 2026: GitHub metadata shows broad adoption and continued activity.

### Related projects

- lsd is related to GNU/BSD `ls`, colorls, exa/eza, Nerd Fonts, Font Awesome, and the wider Rust CLI ecosystem.

### Sources

- <https://api.github.com/repos/lsd-rs/lsd>
- <https://api.github.com/repos/lsd-rs/lsd/releases?per_page=100>
- <https://github.com/lsd-rs/lsd>
- <https://raw.githubusercontent.com/lsd-rs/lsd/master/README.md>
- source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/lsd/config.yaml, ~/.config/lsd/colors.yaml, ~/.config/lsd/icons.yaml, $XDG_CONFIG_HOME/lsd/config.yaml, $XDG_CONFIG_HOME/lsd/colors.yaml, $XDG_CONFIG_HOME/lsd/icons.yaml
- Windows: %USERPROFILE%\.config\lsd\config.yaml, %USERPROFILE%\.config\lsd\colors.yaml, %USERPROFILE%\.config\lsd\icons.yaml, %APPDATA%\lsd\config.yaml, %APPDATA%\lsd\colors.yaml, %APPDATA%\lsd\icons.yaml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** lsd
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - lsd - 1.1.5-5+b1: normalized package name match | Debian stable package indexes: lsd from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | ls command with a lot of pretty colors and some other stuff | https://github.com/lsd-rs/lsd
- Nix - lsd: normalized package name match | nixpkgs package indexes: pkgs/by-name/ls/lsd/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - lsd - 1.0.0-2: normalized package name match | Ubuntu 24.04 LTS package indexes: lsd from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | ls command with a lot of pretty colors and some other stuff
- apk - lsd - 1.2.0-r1: normalized package name match | Alpine Linux edge package indexes: lsd from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Next-Gen ls command | https://github.com/lsd-rs/lsd
- apk - lsd-bash-completion - 1.2.0-r1: normalized package name match | Alpine Linux edge package indexes: lsd-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for lsd | https://github.com/lsd-rs/lsd
- apk - lsd-fish-completion - 1.2.0-r1: normalized package name match | Alpine Linux edge package indexes: lsd-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for lsd | https://github.com/lsd-rs/lsd
- apk - lsd-zsh-completion - 1.2.0-r1: normalized package name match | Alpine Linux edge package indexes: lsd-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for lsd | https://github.com/lsd-rs/lsd
- dnf - lsd - 1.2.0-6.fc45: normalized package name match | Fedora Rawhide package metadata: lsd from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Ls command with a lot of pretty colors and some other stuff | https://crates.io/crates/lsd
- pacman - lsd - 1.2.0-2: normalized package name match | Arch Linux sync databases: lsd from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Modern ls with a lot of pretty colors and awesome icons | https://github.com/lsd-rs/lsd
- zypper - lsd - 1.2.0-1.3: normalized package name match | openSUSE Tumbleweed package metadata: lsd from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Ls command with a lot of pretty colors and some other stuff | https://crates.io/crates/lsd
- MacPorts - lsd: normalized package name match | MacPorts ports tree: sysutils/lsd/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/lsd: normalized package name match | Scoop official bucket manifest trees: bucket/lsd.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - lsd-rs.lsd: normalized package name match | Windows Package Manager source index: lsd-rs.lsd from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [pandoc](https://www.automicvault.com/pkg/brew/pandoc/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [nuls](https://www.automicvault.com/pkg/brew/nuls/) - Shares av.db curated category or tags: cli, file-listing, file-management, ls, rust.
- [eza](https://www.automicvault.com/pkg/brew/eza/) - Shares av.db curated category or tags: cli, file-listing, file-management, rust, system.
- [g-ls](https://www.automicvault.com/pkg/brew/g-ls/) - Shares av.db curated category or tags: cli, file-management, ls, system, terminal.
- [lla](https://www.automicvault.com/pkg/brew/lla/) - Shares av.db curated category or tags: cli, file-listing, file-management, rust, system.
- [czkawka](https://www.automicvault.com/pkg/brew/czkawka/) - Shares av.db curated category or tags: cli, file-management, rust, system.
- [ddh](https://www.automicvault.com/pkg/brew/ddh/) - Shares av.db curated category or tags: cli, file-management, rust, system.
- [dust](https://www.automicvault.com/pkg/brew/dust/) - Shares av.db curated category or tags: cli, file-management, rust, system.
- [dutree](https://www.automicvault.com/pkg/brew/dutree/) - Shares av.db curated category or tags: cli, file-management, rust, system.
- [lr](https://www.automicvault.com/pkg/brew/lr/) - Local package facts share a topical domain. Shared terms: cli, file, file-listing, file-management, listing.

## Combined YAML source

View the package source record on GitHub. [combined/lsd.yml](https://github.com/automic-vault/db/blob/main/combined/lsd.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
