Inspired by cbonsai, zbonsai is a Zig-based terminal application that procedurally generates beautiful bonsai trees in your command line interface. zbonsai brings the zen of bonsai to your terminal, reimagined in the Zig programming language.
- Procedurally generated bonsai trees
- Customizable tree parameters
- Terminal-based user interface using libvaxis
- Command-line argument parsing with zig-clap
To install zbonsai, you'll need to have Zig 0.13.0 on your system. Then, follow these steps:
-
Clone the repository:
git clone https://github.com/JustinBraben/zbonsai.git cd zbonsai -
Build the project:
zig build -
Run zbonsai:
zig build run
Basic usage:
zig build run
For more options, use the --help flag:
zig build run -- --help
To generate and view the tree live:
zig build run -- -l
Generate tree live with verbose output.
zig build run -- -l -v minimal
- libvaxis: A Zig library for creating terminal user interfaces
- zig-clap: A command-line argument parser for Zig
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- Generating Bonsai
- Three different plant bases
- Instantly view generated tree
- Live view of tree generating by optionally passing
-l - Implement message box
- Implement print to terminal on completion
-p - Implement file saving and loading
- Add option to use different Random Number Generators
- Add benchmarking/testing
- Improve resizing
- Improve documentation
Note: This project is a work in progress and is primarily for learning purposes.