{"id":20425352,"url":"https://github.com/catseye/tree","last_synced_at":"2026-04-17T03:34:40.581Z","repository":{"id":16259123,"uuid":"19007195","full_name":"catseye/tree","owner":"catseye","description":"MIRROR of https://codeberg.org/catseye/tree : Display filesystem's directory structure as an indented tree","archived":false,"fork":false,"pushed_at":"2023-09-10T10:42:37.000Z","size":14,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-15T15:12:23.214Z","etag":null,"topics":["filesystem-visualization"],"latest_commit_sha":null,"homepage":"https://catseye.tc/node/tree","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/catseye.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2014-04-21T21:13:16.000Z","updated_at":"2023-10-27T09:21:58.000Z","dependencies_parsed_at":"2025-01-15T15:08:49.590Z","dependency_job_id":"7efc32f8-dff4-463b-97e0-14d7d18c6cba","html_url":"https://github.com/catseye/tree","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2Ftree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2Ftree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2Ftree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catseye%2Ftree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catseye","download_url":"https://codeload.github.com/catseye/tree/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241966977,"owners_count":20050324,"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-visualization"],"created_at":"2024-11-15T07:13:01.790Z","updated_at":"2026-04-17T03:34:35.535Z","avatar_url":"https://github.com/catseye.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"`tree`\n======\n\n_Version 1.2_\n\nThis is Cat's Eye Technologies' `tree`, a command-line tool that displays an\nindented directory tree, similar to \"The Tree Command for Linux\" except simpler.\nIt:\n\n*   is written in Python (Python 3 by default; also tested with 2.7)\n*   is small and has no dependencies besides Python\n*   is in the public domain (see `UNLICENSE`)\n*   is really quite crude\n*   displays a summary of the directory structure by default (because to\n    me, that's the point of this sort of tool: give me a conceptual overview of\n    the directory structure at this point in the filesystem, so I can orient\n    myself)\n*   never follows symbolic links\n*   always outputs a `/` after each directory name\n*   doesn't have any ASCII art (yet; it might someday as the lines do make\n    it a bit easier to \"read\" the tree)\n*   has no build/install system; either copy it to somewhere on your\n    search path, or alter your search path to include the `script` directory\n    in this repo, or use some system that solves this problem, like\n    [shelf](http://catseye.tc/node/shelf).\n\nUsage\n-----\n\n    tree [-f|--full] [-a|--all-files] [-1|--1-line] [-c|--count]\n         [-w|--max-width \u003cint\u003e] [-x|--exclude \u003clist\u003e] [DIRECTORY]\n\nIf DIRECTORY is not supplied, the current directory is assumed.\n\nThe `--full` option lists each file in a directory on its own line.\n\nThe `--all-files` option includes files whose names begin with a\n`.` character, which would otherwise be hidden.\n\nThe `--1-line` option lists a summary of the files in each directory\non one line, truncating the line if it is longer than the max-width.\n\nThe `--count` option causes a count of files in each directory to\nbe display instead of listing the files themselves.\n\nIf none of those options are given, all files in a directory are\nlisted compactly over multiple lines, in a \"block\".\n\nThe `--max-width` option can be used to set the length of truncation\nor block-wrapping.  It defaults to the width of the terminal window\nas returned by `stty size`, if that program can be run, otherwise 75.\n\nThe `--exclude` option sets the list of directory names to not descend\ninto (a comma-separated list).  It defaults to `venv`, `node_modules`,\n`__pycache__`, and `.git`.\n\nRelated work\n------------\n\n*   [The Tree Command for Linux](http://mama.indstate.edu/users/ice/tree/) —\n    GPL'ed and feature-bloated and has no automated build system (you're\n    supposed to edit the Makefile by hand.)\n*   [pyr/tree](https://github.com/pyr/tree) — fine if you're running OpenBSD\n    I suppose, but I gave up on trying to port it to NetBSD and Linux and\n    wrote this instead.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatseye%2Ftree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatseye%2Ftree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatseye%2Ftree/lists"}