{"id":29272132,"url":"https://github.com/acook/lister","last_synced_at":"2026-04-07T04:31:19.290Z","repository":{"id":54523666,"uuid":"77577185","full_name":"acook/lister","owner":"acook","description":"list, sort, filter and display files and directories","archived":false,"fork":false,"pushed_at":"2023-02-25T20:08:07.000Z","size":166,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-07-05T00:11:35.898Z","etag":null,"topics":["command-line-tool","directory-lister","filetype","ls","theme-support","true-color"],"latest_commit_sha":null,"homepage":"https://github.com/acook/lister/#readme","language":"Crystal","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/acook.png","metadata":{"files":{"readme":"README.markdown","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,"zenodo":null}},"created_at":"2016-12-29T02:48:52.000Z","updated_at":"2023-04-29T23:45:36.000Z","dependencies_parsed_at":"2025-07-05T00:10:39.201Z","dependency_job_id":"d8894f76-55f7-411a-9230-3f51ff56c46c","html_url":"https://github.com/acook/lister","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/acook/lister","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acook%2Flister","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acook%2Flister/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acook%2Flister/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acook%2Flister/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/acook","download_url":"https://codeload.github.com/acook/lister/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/acook%2Flister/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31500397,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["command-line-tool","directory-lister","filetype","ls","theme-support","true-color"],"created_at":"2025-07-05T00:10:35.516Z","updated_at":"2026-04-07T04:31:19.269Z","avatar_url":"https://github.com/acook.png","language":"Crystal","funding_links":[],"categories":[],"sub_categories":[],"readme":"Lister\n======\n\nLister is a little directory lister that does filetype analysis!\n\n[![GitHub release](https://img.shields.io/github/release/acook/lister.svg?style=for-the-badge)](https://github.com/acook/lister/releases)\n[![CircleCI](https://img.shields.io/circleci/build/github/acook/lister?style=for-the-badge)](https://app.circleci.com/pipelines/github/acook/lister)\n\nKiller Features\n---------------\n\nLister can be used to get more information about your files or just to present it differently.\n\n### It's magic!\n\nWhat sets Lister apart from standard `ls` is that it's magic! I mean it's `libMagic`. It guesses the type of the file by its \"magic number\" or file contents instead of just by file extension.\n\n### It's colorful!\n\nLister supports 16 million colors in it's output. Seriously. And most modern terminal emulators [support it](https://gist.github.com/XVilka/8346728). It also supports 256 extended colors and standard 16 colors if you want to have a fallback just in case, or maybe you want to keep synchrony with your terminal palette.\n\n### It's configurable!\n\nYou can make your own themes!\n\nJust export the internal theme so you don't have to start from scratch:\n\n~~~shell\n$ lister --colors-export ~/my_new_theme.yml\n~~~\n\nThen modify the colors to your hearts content!\n\nAnd you can make Lister always use your color theme by setting an environment variable:\n\n~~~shell\n$ export LISTER_THEME=~/my_new_theme.yml\n~~~\n\nYou could also create a shorter alias and select your color theme like this:\n\n~~~shell\n$ alias l=lister --colors my_new_theme.yml\n~~~\n\nThis also means you can create multiple aliases with different themes for different use cases!\n\nUsage\n=====\n\n~~~shell\nlister 0.1.0\nAnthony M. Cook \u003cgithub@anthonymcook.com\u003e\nhttp://github.com/acook/lister\n\nlister is a file and directory listing utility which shows colorized and structured libmagic types.\n\nUSAGE:\n\tlister [OPTIONS] [PATH ...]\n\tlister --colors-export PATH\n\tlister --colors-list\n\nOPTIONS:\n\t--\t\t\tstop processing commandline options and interpret remaining arguments as paths\n\t-A\t\t\tshow hidden files (excluding . and ..)\n\t--colors FILE\t\tuse specified YAML file as color theme\n\t--colors-export FILE\texport internal color theme as YAML file\n\t--colors-list\t\tdisplay list of known themeable file types in the associated color from the current theme\n\t--color-depth DEPTH\tuse the 16, 256, or true color palette\n\t-h\t\t\tdisplay usage information (you're looking at it!)\n\t-K\t\t\tshow type names as seen by Lister\n\t-Km\t\t\tshow MIME types from libMagic\n\t-R\t\t\trecurse infinite\n\t--recurse DEPTH\t\trecurse to depth\n\t\u003cpaths\u003e\t\t\ta list of zero or more paths will scan PWD if no path supplied\n\nENVIRONMENT:\n\tLISTER_COLORS\t\tfull path to the Lister theme YAML file, can be overridden on the commandline with --colors\n~~~\n\nInstalling\n==========\n\nCheck out [the releases page](https://github.com/acook/lister/releases) for downloads and instructions!\n\nBuilding\n========\n\nYou'll need a copy of the code:\n- `git clone https://github.com/acook/lister`\n- `cd lister`\n\nThe setup script will install `crystal` for you if you're on a system with `brew` or `apt`:\n- `./scripts/setup`\n\nRun the build script:\n- `./scripts/build`\n\nPut the resulting binary somewhere in your path:\n- `mv bin/lister ~/bin/`\n\nTo build a release version, run the release script:\n- `./scripts/release`\n(if you don't have [Docker](https://www.docker.com/) installed, it will only build it for the local machine)\n\nCreated By\n=========\n\n\u003e Copyright 2016-2021 - Anthony M. Cook\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facook%2Flister","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facook%2Flister","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facook%2Flister/lists"}