{"id":34667674,"url":"https://github.com/sivaprakashkrp/btrls","last_synced_at":"2026-01-13T20:44:03.662Z","repository":{"id":330741227,"uuid":"1120162393","full_name":"sivaprakashkrp/btrls","owner":"sivaprakashkrp","description":"A tabled ls command with Rust","archived":false,"fork":false,"pushed_at":"2026-01-13T00:02:39.000Z","size":208,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-13T04:02:40.689Z","etag":null,"topics":["ls","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/sivaprakashkrp.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-20T16:07:26.000Z","updated_at":"2026-01-13T00:02:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sivaprakashkrp/btrls","commit_stats":null,"previous_names":["sivaprakashkrp/btrls"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sivaprakashkrp/btrls","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sivaprakashkrp%2Fbtrls","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sivaprakashkrp%2Fbtrls/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sivaprakashkrp%2Fbtrls/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sivaprakashkrp%2Fbtrls/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sivaprakashkrp","download_url":"https://codeload.github.com/sivaprakashkrp/btrls/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sivaprakashkrp%2Fbtrls/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28399922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-13T14:36:09.778Z","status":"ssl_error","status_checked_at":"2026-01-13T14:35:19.697Z","response_time":56,"last_error":"SSL_read: 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":["ls","rust"],"created_at":"2025-12-24T19:23:10.126Z","updated_at":"2026-01-13T20:44:03.656Z","avatar_url":"https://github.com/sivaprakashkrp.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# `btrls`\nA tabled `ls` command developed in Rust with color-coded columns. The basic functionality of the `ls` command has been implemented in the release `v1.1.1`. \n\nWith `btrls` you can see the files and directories in a tabled format with the option to export the details of files and directories as **JSON** with the `--json` or `-j` flag.\n\n![A sample output image of `btrls` command](./images/btrls-sample.png)\n\n## Building the application\nClone the Repository. Make sure that you have `rustup` and `cargo` installed on you system. Then run the following command:\n```bash\ncargo build -r\n```\nThen you can find the application in the `\u003cPath-to-repo\u003e/target/release/btrls` or `\u003cPath-to-repo\u003e\\target\\release\\btrls.exe` (If you are on a Windows Machine).\n\n## Installation\nPlease refer to the releases section for the below mentioned files.\n### For Windows Systems\nIf you are on a Windows Machine, you can download the `btrls-v1.1.1.exe` executable file and add the location of the downloaded application to the System or User Environment Variables.\n\nAnd you can also compile the application from source by either downloading an archive or cloning the repository then building the application with `cargo`.\n\n### For Unix/Linux Systems\nIf you are on a Linux or Mac Machine, you can download any of the archives from the releases or clone the repository and run the `install.sh` script.\n\n**Note**: Make sure that your system already has `rustc` and `cargo` installed. \n\nFor `bash` shell, the install script will add `btrls` to `PATH` environment variable through `.bashrc` file. If you are using any other shell, you will have to do that manually.\n\n## Usage:\n```bash\nbtrls [OPTIONS] [PATH]\n```\n\n## Arguments:\n```bash\n[PATH=\".\"]\n```\n## Options:\n### JSON data\n```bash\n-j, --json\n```\nPresents the current directory in JSON format\n\n### View all files (including hidden)\n```bash\n-a, --all\n```\nDisplays all the files and directories (including hidden ones)\n\n### View Hidden Files only\n```bash\n-o, --only-hidden\n```\nDisplays the hidden files and directories only\n\n### List files and directories recursively\n```bash\n-r, --recursive\n```\nDisplays the sub-directories and files recursively.\n\n### List all files and directories (including hidden) recursively\n```bash\n-q, --recursive-hidden\n```\nDisplays the all sub-directories and files (including hidden ones) recursively\n\n### Setting Depth for Recursive Listings\n```bash\n-d \u003cVALUE\u003e, --depth \u003cVALUE\u003e\n```\nSets the recursion depth for the recursive listings. The default value of depth is 1.\n\n### List the attributes of a single file\n```bash\n-f, --file-info\n```\nProvides information about a single file\n\n### View Size of Directories (Recursive)\n```bash\n-s, --directory-size\n```\nRecursively calculates the size of directories (May take time)\n\n### Help\n```bash\n-h, --help\n```\nPrint help (see a summary with `-h`, detailed help with `--help`)\n\n### Version\n```bash\n-V, --version\n```  \nPrints version of btrls\n\n---\n\n*This project was started as a follow along to the video [Code Your Own CLI With Rust - Jonkero](https://youtu.be/5UA9UWWAagc?si=XNrHb2mqfUbid-dE).*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsivaprakashkrp%2Fbtrls","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsivaprakashkrp%2Fbtrls","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsivaprakashkrp%2Fbtrls/lists"}