Turn directory-tree text (e.g. output from the tree command) into real folders and empty files.
- Common
treeoutput formats: Unicode box-drawing, pipe style, Windowstree, space-indented trees. - Automatic indent repair (disable with
--no-fixor the GUI checkbox). - Both a GUI and a CLI.
- Cross-platform: Windows, macOS, Linux.
- User-visible strings live in
treeing/strings.json(bootstrap errors intreeing/strings.bootstrap.json).
Screenshot: Windows, English UI, parsing a sample project tree.
pip install treeing
treeing -i tree.txt -o ./out # CLI
treeing-gui # GUIThe CLI needs only the Python standard library. The GUI uses tkinter; on Linux install it with sudo apt-get install python3-tk (it ships with Python on Windows and macOS).
python -m venv .venv
# Windows: .\.venv\Scripts\pip install -r requirements-build.txt
# Unix: .venv/bin/pip install -r requirements-build.txt
python -m treeing.main # GUI
python -m treeing.main -i tree.txt -o ./out # CLI
python -m treeing.main --help # CLI helpPrebuilt binaries are attached to each release (Windows, Linux, macOS ARM, macOS x86). Pick the archive for your platform (replace vX.Y.Z with the actual version):
| Platform | Archives |
|---|---|
| Windows |
treeing-cli-windows-vX.Y.Z.zip, treeing-gui-windows-vX.Y.Z.zip
|
| Linux |
treeing-cli-linux-vX.Y.Z.tar.gz, treeing-gui-linux-vX.Y.Z.tar.gz
|
| macOS (Apple Silicon) |
treeing-cli-macos-arm64-vX.Y.Z.tar.gz, treeing-gui-macos-arm64-vX.Y.Z.tar.gz
|
| macOS (Intel) |
treeing-cli-macos-x86_64-vX.Y.Z.tar.gz, treeing-gui-macos-x86_64-vX.Y.Z.tar.gz
|
CLI and GUI are packaged separately; download whichever you need. Verify against SHA256SUMS.txt in the same release.
treeing-gui # GUI — Linux / macOS
treeing-gui.exe # GUI — Windows
treeing-cli -i tree.txt -o ./out # CLI — Linux / macOS
treeing-cli.exe -i tree.txt -o ./out # CLI — Windows
treeing-cli --help # CLI help — Linux / macOS
treeing-cli.exe --help # CLI help — Windowspip install -r requirements-build.txt
python build.py --target all # outputs to dist/<platform>/See docs/USER_GUIDE.md for a unified guide covering source runs and prebuilt executables on Windows, macOS ARM, macOS x86, and Linux.
- Licence — MIT; see LICENSE.
- Privacy Policy — see PRIVACY.md.
- Terms of Use — see TERMS.md.
Parts of this source code were written with assistance from AI coding tools.
