Treeing — ASCII tree → directory/file generator

Turn directory-tree text (e.g. output from the tree command) into real folders and empty files.

Features

• Common tree output formats: Unicode box-drawing, pipe style, Windows tree, space-indented trees.
• Automatic indent repair (disable with --no-fix or the GUI checkbox).
• Both a GUI and a CLI.
• Cross-platform: Windows, macOS, Linux.
• User-visible strings live in treeing/strings.json (bootstrap errors in treeing/strings.bootstrap.json).

Preview

Screenshot: Windows, English UI, parsing a sample project tree.

Quick start

Install from PyPI

pip install treeing
treeing -i tree.txt -o ./out   # CLI
treeing-gui                    # GUI

The 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).

Run from source

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 help

Run a prebuilt executable

Prebuilt 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):

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 — Windows

Build executables yourself

pip install -r requirements-build.txt
python build.py --target all          # outputs to dist/<platform>/

Documentation

See docs/USER_GUIDE.md for a unified guide covering source runs and prebuilt executables on Windows, macOS ARM, macOS x86, and Linux.

Legal

• Licence — MIT; see LICENSE.
• Privacy Policy — see PRIVACY.md.
• Terms of Use — see TERMS.md.

AI Disclosure

Parts of this source code were written with assistance from AI coding tools.