seedir

What it is and what it does

seedir is a utility for generating visual representations of folder hierarchies as ASCII tree diagrams. It wraps filesystem traversal with formatting options—you call a single function and get a styled tree output that you can customize by depth, item count, and folder exclusion patterns.

The package depends only on natsort for natural sorting of directory entries. It's designed for quick inspection of directory structures in scripts, documentation, or terminal output, with support for different visual styles (lines, boxes, emoji with optional dependency). The aging maintenance status suggests the core functionality is stable but not actively developed.

Use it for:

• Generate folder structure diagrams for documentation or README files
• Inspect directory layouts in scripts without external tools
• Create visual tree output for project structure reporting
• Limit tree depth and item count to avoid overwhelming output on large directories

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Generates ASCII tree diagrams of folder structures with customizable styling, depth limits, and filtering options.

Yes. Low install friction, permissive MIT license, no known vulnerabilities, and a stable single dependency make this a safe choice for anyone needing quick folder tree visualization. The aging maintenance is not a blocker since the core feature is straightforward and unlikely to break.

Install

seedir on PyPI

pip install seedir

uv add seedir

poetry add seedir

Installing seedir

Before you install

Low friction install with a single runtime dependency (natsort). Repository shows ongoing maintenance with a recent commit in June 2025, though the package is aging relative to its first release in 2020.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install seedir

import seedir as sd
sd.seedir(style='lines', itemlimit=10, depthlimit=2)

Verify before relying

• Whether the 'emoji' style mentioned in docs is available by default or requires the optional emoji dependency
• Specific Python version compatibility (requires_python is unspecified in metadata)

Package facts

Evidence: seedir-0.5.1-py3-none-any.whl

Tags

More Utilities packages