broot is developed by Denys Séguret, also known as Canop or dystroy.

Major updates are announced on Mastodon : @[email protected] and BlueSky: @dystroy.bsky.social

Sponsorship

broot is free for all uses.

If it helps your company make money, consider helping me find time to add features and to develop new free open-source software.

Discuss Broot in a chat room

The best place to chat about broot, to talk about features or bugs, is the Miaou chat.

There's a dedicated room:

If you're French speaking, you might prefer to directly come where other French speaking programmers hang:

Don't hesitate to come if you have a question.

You're also welcome to give any feedback. I like to read about how people use Broot.

Issues

We use GitHub's issue manager.

Before posting a new issue, check your problem hasn't already been raised and in case of doubt please come first discuss it on the chat.

Your wishes

Issues is also where I test new ideas. If you're interested in the directions broot takes, please come and vote on issues, or maybe comment. This would help me prioritize developments: if nobody's interested in a feature I'm not sure I want, I'll do something else.

Log

When something looks like a bug, especially keyboard problems, I need both to know the exact configuration (OS, terminal program, mainly) and to have the log. The log can be obtained this way:

1. start broot with BROOT_LOG=debug br
2. do the action which seems not to properly work, and nothing else
3. quit broot
4. go to the chat (or the GitHub issue if you already made one) and paste the content of the broot.log file

Benchmark

To get a precise idea of the time taken by operations in real broot use, it's often a good idea to run them with --cmd.

For example full text search performances can be measured (and compared to other tools) with

time broot -c "c/memmap;:pt" ~/code

Contribute

Broot is written in Rust. The current focus is linux+mac but I try to support Windows too (use a modern terminal like the new MS one).

If you think you might help, as a tester or coder, you're welcome, but please read Contributing to my FOSS projects.

Don't open a PR without discussing the design before, either in the chat or in an issue, unless you're just fixing a typo. Coding is the easy part. Determining the exact requirement and how we want it to be done is the hard part. This is especially important if you plan to add a dependency or to change the visible parts, eg the launch arguments.

This documentation...

... needs your help too.

Tell me what seems to be unclear or missing, what tricks should be added.

Or for simple corrections, head to the source