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

New way to see and navigate directory trees. Version 1.57.0 via Homebrew; verified 2026-06-01.

## 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/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-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
- **Package manager page:** <https://formulae.brew.sh/formula/broot>
- **Version:** 1.57.0
- **Source summary:** New way to see and navigate directory trees
- **Homepage:** <https://dystroy.org/broot/>
- **Repository:** <https://github.com/Canop/broot>
- **Upstream docs:** <https://dystroy.org/broot>
- **License:** MIT
- **Source archive:** <https://github.com/Canop/broot/archive/refs/tags/v1.57.0.tar.gz>
- **Last updated:** 2026-06-01T17:26:00Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- broot (cli)
- broot (alias)

## Dependencies

- libxcb

## Build dependencies

- 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.57.0
- Package-manager updated: 2026-06-01
- Local data: ok
- Upstream repository: https://github.com/Canop/broot
- Upstream latest detected: v1.57.0 (current)
## 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
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** broot
- **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 - 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.54.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.54.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.54.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.54.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.54.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.57.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.4: normalized package name match | openSUSE Tumbleweed package metadata: broot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-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


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [lndir](https://www.automicvault.com/pkg/brew/lndir/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [nfd2nfc](https://www.automicvault.com/pkg/brew/nfd2nfc/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [physfs](https://www.automicvault.com/pkg/brew/physfs/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [zoxide](https://www.automicvault.com/pkg/brew/zoxide/) - Shares av.db curated category or tags: cli, developer-tools, navigation.
- [fclones](https://www.automicvault.com/pkg/brew/fclones/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [fselect](https://www.automicvault.com/pkg/brew/fselect/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [fsql](https://www.automicvault.com/pkg/brew/fsql/) - Shares av.db curated category or tags: cli, developer-tools, filesystem.
- [gtree](https://www.automicvault.com/pkg/brew/gtree/) - Shares av.db curated category or tags: cli, developer-tools, directory-tree.

## Combined YAML source

View the package source record on GitHub. [combined/broot.yml](https://github.com/automic-vault/db/blob/main/combined/broot.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
