---
id: seedir
version: "0.5.1"
license: MIT
license_treatment: permissive
maintenance: aging
---

# seedir — Package for creating, editing, and reading folder tree diagrams.

License: permissive · Maintenance: aging · Downloads: 462.9K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 462.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

folder tree diagram, directory structure visualization, ascii tree output, file tree display, directory listing formatter, directory-visualization, cli-tool

[View on SkillFed](https://skillfed.io/packages/seedir) · [View on PyPI](https://pypi.org/project/seedir/)