Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: 4 days 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 (7 months ago)
Default Branch: main
Last Pushed: 2025-01-13T19:50:11.000Z (about 1 month ago)
Last Synced: 2025-02-09T11:01:46.192Z (11 days ago)
Topics: c, color, command-line, files, ls, terminal, tools
Language: C
Homepage:
Size: 9.36 MB
Stars: 416
Watchers: 3
Forks: 13
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# facad

[![Documentation](https://img.shields.io/badge/documentation-view-f5b836.svg?style=flat-square)](https://yellow-footed-honeyguide.github.io/facad/)
[![versions](https://img.shields.io/repology/repositories/facad?style=flat-square&color=f5b836)](https://repology.org/project/facad/versions)
[![Homebrew](https://img.shields.io/homebrew/installs/dy/facad?style=flat-square&color=f5b836&label=homebrew%20installs)](https://formulae.brew.sh/formula/facad)

A modern, colorful directory listing tool for the command line.

![facad in action](assets/facad_2_18.jpg)

## 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
mkdir build && cd build
meson setup .. && ninja
# for system-wide installation (may require elevated privileges like `sudo`):
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: [email protected]
- GitHub: [@yellow-footed-honeyguide](https://github.com/yellow-footed-honeyguide)

## License
Distributed under the MIT License. See LICENSE for more information.