{"id":23335882,"url":"https://github.com/ash-olorenshaw/lister","last_synced_at":"2026-04-26T20:31:32.187Z","repository":{"id":268954652,"uuid":"905977882","full_name":"Ash-Olorenshaw/Lister","owner":"Ash-Olorenshaw","description":"'ls' - but faster and in .NET","archived":false,"fork":false,"pushed_at":"2025-03-14T06:14:03.000Z","size":20,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T13:13:46.982Z","etag":null,"topics":["dotnet","filesystem","fsharp","ls","utility"],"latest_commit_sha":null,"homepage":"","language":"F#","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/Ash-Olorenshaw.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-12-19T22:39:53.000Z","updated_at":"2025-03-14T06:14:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"120485a6-c731-45cd-8211-d2a10ec7fb7e","html_url":"https://github.com/Ash-Olorenshaw/Lister","commit_stats":null,"previous_names":["ash-olorenshaw/lister"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ash-Olorenshaw%2FLister","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ash-Olorenshaw%2FLister/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ash-Olorenshaw%2FLister/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ash-Olorenshaw%2FLister/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ash-Olorenshaw","download_url":"https://codeload.github.com/Ash-Olorenshaw/Lister/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247657271,"owners_count":20974345,"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":["dotnet","filesystem","fsharp","ls","utility"],"created_at":"2024-12-21T02:10:48.386Z","updated_at":"2026-04-26T20:31:32.179Z","avatar_url":"https://github.com/Ash-Olorenshaw.png","language":"F#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lister\n*\"Everybody's a textfile, Dave\"*\n\n**Lister** is a small, lightweight, .NET recreation of the ls/gci/dir command from your OS/shell of choice.\n\nVery un-featureful (currently only has four meaningful flags), **Lister** is designed for compatibility, speed, and efficiency.\n\nOriginally designed for me to use with my NeoVim plugin - [Porthole.nvim](https://github.com/Ash-Olorenshaw/Porthole.nvim) - I've actually used **Lister** in \na number of settings just because I like that extra 100 or so ms it shaves off a query on low end hardware.\n\n\u003e ⚠️ **Note: Lister is not always faster than other options.** Lister's performance varies based on your hardware, shell of choice, etc. However, Lister is very consistent. On low end systems it tends to be considerably faster. However, on high end systems it *will* be slower than things like `ls` and `gci`, but the speed difference is usually so minimal that it is not noticeable.\n\n## Usage\n\n**Lister** is built on .NET (10) - if you don't have it installed, do the following:\n```nu-script\n# Windows\nwinget install Microsoft.DotNet.DesktopRuntime.10\n\n# Fedora\nsudo dnf install dotnet-runtime-10.0 -y\n\n# Ubuntu\nsudo apt-get update\nsudo apt-get install dotnet-runtime-10.0 -y\n```\nFor MacOS check out [this](https://learn.microsoft.com/en-us/dotnet/core/install/macos) page. For other Linux distros, follow these instructions [here](https://learn.microsoft.com/en-us/dotnet/core/install/linux-ubuntu).\n\nAfter .NET is installed, **Lister**'s usage is as follows:\n\n```\n[Lister.dll] REQUIRED: [\u003cfilepath\u003e] OPTIONAL: [-d/--directories] [-f/--files] [-c/--coloured/--colored] [-i/--ignore] [-h/--help]\n```\n\nOn all platforms, make sure you run the program with `dotnet` prepended to the command like this:\n```nu-script\ndotnet lister.dll ./examplefolder\n```\nThis is to stop Linux trying to run it with Wine and Windows complaining that it's a system element. \n\nYou can easily alias this in your shell of choice like this:\n\n```pwsh\n# PowerShell - in your $PROFILE\nfunction RunLister {\n\tdotnet \"/path/to/your/lister/install/Lister.dll\" @args\n}\n\nSet-Alias -Name lister -Value RunLister\n```\n```bash\n# Bash - in your .bashrc\nfunction RunLister {\n\tdotnet \"/path/to/your/lister/install/Lister.dll\" \"$@\"\n}\n\nalias lister=RunLister\n```\n\n## Building\n\nIf you want to build Lister yourself, do the following:\n\n```nu-script\n# download the files\ngit clone \"https://github.com/Ash-Olorenshaw/Lister.git\"\n\n# cd into the directory\ncd Lister\n\n# install all packages\ndotnet restore\n\n# compile\ndotnet publish -o ./releases/\n```\n\nAll you need out of the 'releases' folder then is usually just `FSharp.Core.dll`, `Lister.dll` and `Lister.runtimeconfig.json`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fash-olorenshaw%2Flister","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fash-olorenshaw%2Flister","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fash-olorenshaw%2Flister/lists"}