1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
|
The current version of broot works on linux, mac and windows (win 10+).
!!! Note
**Windows users:** broot may need additional rights at first use in order to write its configuration file.
Some users on Windows also report problems with the colon. Remember that a space can be used instead of a colon.
You should also use a modern terminal, for example the [new Microsoft one](https://github.com/microsoft/terminal)
# From precompiled binaries
Binaries are made available at every release in [download](https://dystroy.org/broot/download).
The archives there contain all precompiled versions, as well as the licenses and other files. They're the prefered distribution way.
Direct links:
Target|Details|Download
-|-|-
Linux | clipboard support| [x86_64-linux](https://dystroy.org/broot/download/x86_64-linux/broot)
Android | clipboard support | [aarch64-linux-android](https://dystroy.org/broot/download/aarch64-linux-android/broot)
Linux/glibc | no clipboard support, compatible with older GLIBC | [x86_64-unknown-linux-gnu](https://dystroy.org/broot/download/x86_64-unknown-linux-gnu/broot)
Linux/musl | no clipboard support | [x86_64-unknown-linux-musl](https://dystroy.org/broot/download/x86_64-unknown-linux-musl/broot)
Raspberry | no clipboard support | [armv7-unknown-linux-gnueabihf](https://dystroy.org/broot/download/armv7-unknown-linux-gnueabihf/broot)
Windows 10+ | clipboard support | [x86_64-pc-windows-gnu](https://dystroy.org/broot/download/x86_64-pc-windows-gnu/broot.exe)
Shell completion | | [completion/](https://dystroy.org/broot/download/completion)
You may download previous releases on [GitHub releases](https://github.com/Canop/broot/releases).
When you download executable files, you'll have to ensure the shell can find them. An easy solution on linux is for example to put them in `/usr/local/bin`. You may also have to set them executable using `chmod +x broot`.
# From crates.io
You'll need to have the [Rust development environment](https://www.rustup.rs) installed and up to date.
Once it's installed, use cargo to install broot:
```bash
cargo install --locked broot
```
# From source
You'll need to have the [Rust development environment](https://www.rustup.rs) installed.
Fetch the [Canop/broot](https://github.com/Canop/broot) repository, move to the broot directory, then run
```bash
cargo install --locked --path .
```
If you want a custom compilation, have a look at the [optional features documentation](https://github.com/Canop/broot/blob/master/features.md).
!!! Note
If there's a compilation error, it most often means either that you're missing some compilation dependency (on ubuntu/debian try `sudo apt install build-essential`) or that you have an old version of the compiler, and you should update it (for example with `rustup update`).
# Third party repositories
Those packages are maintained by third parties and may be less up to date.
## Homebrew
brew install broot
## MacPorts
sudo port selfupdate
sudo port install broot
## Alpine Linux
apk add broot
*note: broot package is available in Alpine 3.13 and newer*
## APT / Deb
Ubuntu and Debian users may use this apt repository: [https://packages.azlux.fr/](https://packages.azlux.fr/)
## NetBSD
pkgin install broot
## Gentoo Linux
emerge broot
# Reinstall
To reinstall, just change the executable.
It's always been compatible with the previous configuration files but if your previous installation is old (especially if it's pre 1.14), you might want to get the new [configuration files](https://github.com/Canop/broot/resources/default-conf) which have more relevant sections.
The simplest solution is to remove your old configuration directory (or rename if you want to keep things) so that broot recreates it.
# After installation
Now you should [install the br shell function](../install-br/).
|