https://github.com/yellow-footed-honeyguide/facad

A modern, colorful directory listing tool for the command line 🗃️
https://github.com/yellow-footed-honeyguide/facad

c cli directory-listing linux ls-alternative terminal unix

Last synced: about 1 month ago
JSON representation

A modern, colorful directory listing tool for the command line 🗃️

• Host: GitHub
• URL: https://github.com/yellow-footed-honeyguide/facad
• Owner: yellow-footed-honeyguide
• License: mit
• Created: 2024-07-29T04:21:26.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-02T14:30:18.000Z (about 1 month ago)
• Last Synced: 2024-10-03T06:53:00.722Z (about 1 month ago)
• Topics: c, cli, directory-listing, linux, ls-alternative, terminal, unix
• Language: C
• Homepage:
• Size: 1.6 MB
• Stars: 271
• Watchers: 2
• Forks: 7
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# facad

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

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

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

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

## Features

- 🎨 Emoji-based file and directory icons

- 📁 Sorted output with directories first

- 🔗 Supports symlinks and executable files

- 🧩 Compact grid display

- 📏 Customizable column width

- 🌐 Unicode-aware formatting

### Building from Source

Clone and Build:

```

git clone https://github.com/yellow-footed-honeyguide/facad.git

cd facad

mkdir build && cd build

meson setup ..

ninja

```

For system-wide installation:

```

sudo ninja install

```

## Usage

Run `facad` command for default grid file listing

Run `facad -l` command for long listing output

Run `facad -a` command for dir analytics output

Run `facad -h` command for help

Run `facad -v` command for version

## 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.