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

New way to see and navigate directory trees. Version 1.58.0 via Homebrew; verified 2026-07-10. Also installable with debian: sudo apt install broot.

## Install

```sh
sudo av install brew:broot
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install broot
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install broot
```

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

### Linux

- apk (92%):

```sh
sudo apk add broot
```

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

- Debian apt (92%):

```sh
sudo apt install broot
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#broot
```

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

- pacman (92%):

```sh
sudo pacman -S broot
```

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

- zypper (92%):

```sh
sudo zypper install broot
```

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

### Windows

- Scoop (92%):

```sh
scoop install main/broot
```

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

- winget (92%):

```sh
winget install --id Dystroy.broot -e
```

  Evidence: Windows Package Manager source index: Dystroy.broot from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:broot
- **Package manager:** Homebrew
- **Version:** 1.58.0
- **Source summary:** New way to see and navigate directory trees
- **Homepage:** <https://dystroy.org/broot/>
- **Repository:** <https://github.com/Canop/broot>
- **Last updated:** 2026-07-10T23:39:07Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- broot (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.58.0
## Project history and usage

Broot is a Rust terminal file navigator that combines a compact directory tree, fuzzy search, file operations, preview panels, shell integration, and user-defined verbs. It is designed as a more interactive answer to `tree`, `ls`, `find`, and ad hoc `cd` workflows.

### Project history

The official documentation describes Broot as a better way to navigate directories, find files, and launch commands. Its core idea is to keep a readable tree visible even for large directories by filtering, respecting ignore files, and letting the user jump back to the shell in the selected directory through the `br` integration.

The GitHub repository and changelog show steady development over many years, with features expanding from directory overview and search into panels, file previews, staging areas, trash support, image rendering through terminal graphics protocols, Git status views, modal input, configurable verbs, and shell integrations.

### Adoption history

Broot became popular among command-line users who wanted richer navigation without adopting a full-screen orthodox file manager. GitHub shows a large user audience, and the input package facts show broad packaging across Homebrew, Debian, Alpine, MacPorts, Nix, Arch, Scoop, Winget, and openSUSE.

### How it is used

Typical use is `br` or `broot` inside a project tree: type a few letters to narrow the tree, press enter or a configured verb to open a file, use Alt-Enter to return to the shell in a selected directory, and use panels or the staging area for file operations. Configuration lives under the XDG config directory and lets users define verbs, shortcuts, skins, icons, and preview transformers.

### Why package nerds care

Broot is a representative modern Rust CLI package: single-purpose but deep, cross-platform, visually rich in the terminal, and widely distributed by both Unix and Windows package managers. It also illustrates how newer tools compose with shells rather than replacing them outright.

### Timeline

- 2019: Early public release tags appear in the official Git repository.
- 2023: The changelog shows continuing shell integration and file-operation improvements, including trash support and Windows installer work.
- 2024: Preview transformers, improved terminal key handling, and richer panels land in the 1.40+ series.
- 2025: Broot adds more filesystem, preview, watching, and image-rendering improvements.
- 2026-06-01: Changelog lists v1.57.0.

### Related projects

- Related command-line navigation and file-management tools include tree, fd, fzf, ranger, nnn, vifm, zoxide, broot's own shell function `br`, and terminal file-preview ecosystems built around Kitty or WezTerm graphics.

### Sources

- <https://dystroy.org/broot/>
- <https://github.com/Canop/broot#readme>
- <https://raw.githubusercontent.com/Canop/broot/main/CHANGELOG.md>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for broot. Nucleus package metadata is still published here so future coverage has a stable package URL.



## 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: ${XDG_CONFIG_HOME:-~/.config}/broot/conf.toml, ${XDG_CONFIG_HOME:-~/.config}/broot/conf.hjson
## Other Package-Manager Records

- Debian apt - broot - 1.46.3-2: normalized package name match | Debian stable package indexes: broot from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | tree view, file manager, configurable launcher | https://dystroy.org/broot
- Nix - broot: normalized package name match | nixpkgs package indexes: pkgs/by-name/br/broot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - broot - 1.58.0-r0: normalized package name match | Alpine Linux edge package indexes: broot from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | New way to see and navigate directory trees | https://github.com/Canop/broot
- apk - broot-bash-completion - 1.58.0-r0: normalized package name match | Alpine Linux edge package indexes: broot-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Bash completions for broot | https://github.com/Canop/broot
- apk - broot-doc - 1.58.0-r0: normalized package name match | Alpine Linux edge package indexes: broot-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | New way to see and navigate directory trees (documentation) | https://github.com/Canop/broot
- apk - broot-fish-completion - 1.58.0-r0: normalized package name match | Alpine Linux edge package indexes: broot-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Fish completions for broot | https://github.com/Canop/broot
- apk - broot-zsh-completion - 1.58.0-r0: normalized package name match | Alpine Linux edge package indexes: broot-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Zsh completions for broot | https://github.com/Canop/broot
- pacman - broot - 1.58.0-1: normalized package name match | Arch Linux sync databases: broot from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Fuzzy Search + tree + cd | https://github.com/Canop/broot
- zypper - broot - 1.49.1-1.6: normalized package name match | openSUSE Tumbleweed package metadata: broot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | A better way to navigate directories | https://dystroy.org/broot/
- MacPorts - broot: normalized package name match | MacPorts ports tree: sysutils/broot/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/broot: normalized package name match | Scoop official bucket manifest trees: bucket/broot.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Dystroy.broot: normalized package name match | Windows Package Manager source index: Dystroy.broot from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/broot.yml](https://github.com/mxcl/pkgdb/blob/main/combined/broot.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph