https://github.com/yellow-footed-honeyguide/facad
A modern, colorful ls alternative for bringing clarity to the filesystem ☀️
https://github.com/yellow-footed-honeyguide/facad
c color command-line files ls terminal tools
Last synced: about 1 year ago
JSON representation
A modern, colorful ls alternative for bringing clarity to the filesystem ☀️
- Host: GitHub
- URL: https://github.com/yellow-footed-honeyguide/facad
- Owner: yellow-footed-honeyguide
- License: mit
- Created: 2024-07-29T04:21:26.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-28T12:22:27.000Z (about 1 year ago)
- Last Synced: 2025-05-08T10:17:33.270Z (about 1 year ago)
- Topics: c, color, command-line, files, ls, terminal, tools
- Language: C
- Homepage:
- Size: 9.29 MB
- Stars: 431
- Watchers: 3
- Forks: 14
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# facad
[](https://yellow-footed-honeyguide.github.io/facad/)
[](https://repology.org/project/facad/versions)
[](https://formulae.brew.sh/formula/facad)
A modern, colorful directory listing tool for the command line.
## Features
> Designed for both novice users and power users,
> facad feature set aims to enhance file management experience with
> a perfect blend of functionality and simplicity.
- Intuitive file type representation
- Sorted output with directories first
- Four-column layout for quick directory analysis
- Supports symlinks and executable files
- Sort extensions
- Unicode-aware formatting
## Getting Started
### Dependencies
- Pure C implementation without any dependency
### macOS
facad is available through Homebrew. To install, run:
```bash
brew install facad
```
### I use Arch btw?
Just use the script from AUR:
```bash
yay -S facad
```
### Build & Install from source
```bash
git clone https://github.com/yellow-footed-honeyguide/facad.git
cd facad
meson setup build && meson compile -C build
# now facad binary in build dir
# for system-wide installation (may require elevated privileges like `sudo`):
cd build && sudo ninja install
```
## Usage
Run `facad` command for default grid file listing
Run `facad -h/--help` command for help
Run `facad -v--version` command for version
Run `facad -l/--long` command for long listing output
Run `facad -a/--analytics` command for dir analytics output
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the Project
- Create your Feature Branch ( `git checkout -b feature/AmazingFeature` )
- Commit your Changes ( `git commit -m 'Add some AmazingFeature'` )
- Push to the Branch ( `git push origin feature/AmazingFeature` )
- Open a Pull Request
## Author
**Sergey Veneckiy**
- Email: s.venetsky@gmail.com
- GitHub: [@yellow-footed-honeyguide](https://github.com/yellow-footed-honeyguide)
## License
Distributed under the MIT License. See LICENSE for more information.