arborix 1.0.0

A beautifully structured CLI tree viewer with exports

Arborix

A beautifully structured CLI tree viewer with export capabilities

---

Overview

Arborix is a minimalist, yet feature-rich command-line utility that renders directory trees in a clean and human-readable format. It leverages UTF-8 icons to intuitively represent various file types and offers multi-format export options for versatile use cases.

Key Features

• 📁 Unicode icons for different file types
• 📄 Export to .txt, .json, and .html (with embedded CSS)
• 🧠 Sorting by name, size, or date
• 🫥 Toggle hidden files
• 🌈 Colored terminal output
• 🔍 Depth limitation for focused navigation
• 📊 Directory statistics on demand

---

Installation

Choose from the following methods:

From GitHub

pip install git+https://github.com/mallikmusaddiq1/arborix.git
cd arborix
pip install .

From PyPI

pip install arborix

---

Usage

Launch Arborix from your terminal:

arborix [path] [options]

Command-line Options

• -d, --depth <int>: Set tree depth limit (e.g., --depth 3)
• --txt <file>: Export tree view to .txt
• --json <file>: Export tree structure to .json
• --html <file>: Export to .html with embedded styles
• --sort <name|size|date>: Sort directory entries (default: name)
• -H, --hidden: Include hidden files and folders
• --no-icons: Disable Unicode icons
• --color: Enable ANSI-colored output
• --stats: Display summary of files and directories
• -v, --version: Show tool version and author information

---

Example Commands

Generate a basic tree with stats and export:

arborix . --depth 2 --txt output.txt --stats

Export to JSON with colored output and hidden files:

arborix . --json structure.json --color --hidden

Generate icon-free HTML output for a directory:

arborix /path/to/dir --html index.html --no-icons

Display version and credits:

arborix --version

---

File Type Icons

Icon	Category	File Types
📁	Folder	Directories
📸	Image	jpg, png, svg, psd
🎵	Audio	mp3, wav, flac, ogg
🎬	Video	mp4, mkv, avi, mov
📄	Text & Code	txt, py, java, html
🗜️	Archive	zip, rar, tar, 7z
⚙️	Executable	exe, bin, jar, sh
🔤	Font	ttf, otf, woff, woff2
🗄️	Database	sql, sqlite, db
📊	Presentation	ppt, pptx, odp
📈	Spreadsheet	xls, xlsx, ods
📖	PDF & E-books	pdf, epub, mobi
📐	CAD & 3D Models	dwg, stl, obj
📦	Miscellaneous	torrent, tmp, cfg
💾	Virtual Machines	vmdk, vmx, vdi
🎮	Game Files	rom, nes, gba
🔬	Scientific Data	hdf, npy, pdb
✍️	Markup & Docs	md, tex, adoc
📦	Other	Unrecognized extensions

---

Author

Mallik Mohammed Musaddiq

GitHub: @mallikmusaddiq1

Email: [e-mail]

---

License

This project is licensed under the MIT License. Refer to the LICENSE file for full details.