{"id":21233675,"url":"https://github.com/bdr-pro/drawyourdirs","last_synced_at":"2025-08-21T12:41:04.792Z","repository":{"id":228795403,"uuid":"774931830","full_name":"BDR-Pro/DrawYourDirs","owner":"BDR-Pro","description":"🌲 `drawyourdir` visualizes your folder structure in a pretty tree 🎨, respecting `.gitignore`, ignoring hidden files 🙈, and sorting by file size 📊. Set a file limit for neat output! 📁✨","archived":false,"fork":false,"pushed_at":"2024-03-20T16:26:49.000Z","size":11,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-21T18:37:20.005Z","etag":null,"topics":["filesystem","pip","python","script"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BDR-Pro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-20T13:13:39.000Z","updated_at":"2024-03-20T13:17:18.000Z","dependencies_parsed_at":"2025-01-21T18:38:33.285Z","dependency_job_id":"d59aa287-bea1-4aa5-8f5f-0cc2e4d092b1","html_url":"https://github.com/BDR-Pro/DrawYourDirs","commit_stats":null,"previous_names":["bdr-pro/drawyourdirs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FDrawYourDirs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FDrawYourDirs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FDrawYourDirs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BDR-Pro%2FDrawYourDirs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BDR-Pro","download_url":"https://codeload.github.com/BDR-Pro/DrawYourDirs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243676707,"owners_count":20329432,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["filesystem","pip","python","script"],"created_at":"2024-11-20T23:59:53.630Z","updated_at":"2025-03-15T02:43:51.072Z","avatar_url":"https://github.com/BDR-Pro.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DrawYourDir 🌳\n\nDraw a pretty tree of your directory structure with `drawyourdir`! This Python script prints a directory tree, respecting `.gitignore`, ignoring hidden files (if specified), ordering files by their size within directories, and limiting the number of files listed.\n\n## Installation\n\nClone this repository to your local machine:\n\n```bash\n\ngit clone https://github.com/BDR-Pro/DrawYourDirs.git\ncd drawyourdir\n\n```\n\n### linux / macOS\n\nTo install, run:\n\n```bash\n./install.sh\n```\n\nMake sure `install.sh` is executable:\n\n```bash\nchmod +x install.sh\n```\n\n### Windows\n\nTo install in powershell admin, run:\n\n```bash\n\n.\\install.ps1\n\n```\n\n## Usage\n\nTo draw the directory structure, navigate to your desired directory and run:\n\n```bash\ndrawyourdir \u003cargs\u003e\n```\n\nWhere `\u003cargs\u003e` can include:\n\n- `-p` or `--path`: Specify the directory path (default is the current directory).\n- `-l` or `--levels`: Define the maximum directory depth to display (default is 4).\n- `-i` or `--ignore`: Ignore files starting with a dot (hidden files).\n- `-g` or `--git`: Respect `.gitignore` file and ignore files specified within.\n- `-f` or `--files`: Limit the maximum number of files to list per directory, ordered by size.\n\n### Example\n\n```bash\ndrawyourdir -p C:\\Users\\YourName\\Documents\\Project -f 3 -i\n```\n\nThis command will print the directory tree for `Project`, listing up to 3 files per directory by size and ignoring hidden files.\n\n## Result Example\n\n```bash\nprime/\n|-- prime_linux (3.73 MB)\n|-- prime.exe (245.99 KB)\n|-- README.md (2.37 KB)\n|-- #####\nsrc/\n|-- main.rs (0.98 KB)\ntarget/\n|-- CACHEDIR.TAG (177 B)\ndebug/\n    |-- prime.pdb (2.47 MB)\n    |-- prime.exe (361.50 KB)\n    |-- prime.d (0.12 KB)\n    |-- #####\nbuild/\n    num-bigint-180e83325ed2829c/\n        |-- output (0.11 KB)\n        |-- root-output (0.09 KB)\n        |-- invoked.timestamp (0.05 KB)\n        |-- #####\n    num-bigint-b4afae5dfafc2711/\n        |-- build_script_build-b4afae5dfafc2711.pdb (1.58 MB)\n        |-- build_script_build.pdb (1.58 MB)\n        |-- build-script-build.exe (348.99 KB)\n        |-- #####\n    num-traits-4e17e6738bcb6d2e/\n        |-- build_script_build-4e17e6738bcb6d2e.pdb (1.57 MB)\n        |-- build_script_build.pdb (1.57 MB)\n        |-- build-script-build.exe (329.60 KB)\n        |-- #####\n    num-traits-59db63a5c24b3c3c/\n        |-- output (0.34 KB)\n        |-- root-output (0.09 KB)\n        |-- invoked.timestamp (0.05 KB)\n        |-- #####\n    windows_x86_64_msvc-866c1eb008cfce0f/\n        |-- output (0.13 KB)\n        |-- root-output (0.10 KB)\n        |-- invoked.timestamp (0.05 KB)\n        |-- #####\n    windows_x86_64_msvc-cfe3575fc0198c88/\n        |-- build_script_build-cfe3575fc0198c88.pdb (1.30 MB)\n        |-- build_script_build.pdb (1.30 MB)\n        |-- build-script-build.exe (156.91 KB)\n        |-- #####\ndeps/\n    |-- libclap_builder-3599b7507a581807.rlib (23.12 MB)\n    |-- libnum_bigint-4ddc0cff25ad5779.rlib (4.63 MB)\n    |-- libwindows_sys-27ee461ddd1810f9.rlib (3.25 MB)\n    |-- #####\n...\n\n```\n\n## License\n\n`drawyourdir` is open-sourced software licensed under the [MIT license](LICENSE).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fdrawyourdirs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbdr-pro%2Fdrawyourdirs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbdr-pro%2Fdrawyourdirs/lists"}