This repository has been archived by the owner. It is now read-only.

colorls-cr

Crystal toy app for colorizing LS output

colorls-cr

A command line tool, written in Crystal for adding icons to ls output, similar to colorls.

Example output:

image

Installation

  • Install crystal
  • Install a powerline font for your terminal
    • Download & install a release from Nerd Fonts; or
    • Install a powerline font using homebrew (brew cask install font-droid-sans-mono-for-powerline)
  • Install the termbox libraries
    • For macOS, try brew install termbox
    • For Linux or macOS, you can also try:
  • Clone this repo with git clone https://github.com/jaydorsey/colorls-cr && cd colorls-cr
  • Run shards install to install application dependencies
  • Build the binary with crystal build src/colorls.cr --no-debug --release

Usage

Put the generated binary in your $PATH, and run colorls. You can setup an alias:

alias ls="colorls --report"

Run colorls -s to generate a default configuration file. By default, the file is placed in ~/.config/colorls-cr/config.yaml

Uninstallation

  • Delete the binary
  • Delete the config file rm -rf ~/.config/colorls-cr/

Icons & colors

To customize icons & colors, add a ~/.config/colorls-cr/config.yaml or ~/.colorls-cr.yaml file with your icon & color mappings. An example yaml file is generated at ~/.config/colorls-cr/config.yaml when you run colorls -s

Available colors can be any string supported by Colorize

Icons can be any Unicode mapping for your font. Use the nerdfonts cheatsheet to look up code points if you're using Nerd Fonts

Contributing

Contributions in the form of bug reports, pull requests, documentation updates, and feature requests are welcome.

Please open an issue for any of the above.

Repository

colorls-cr

Owner
Statistic
  • 3
  • 1
  • 6
  • 0
  • 1
  • almost 5 years ago
  • April 29, 2019
License

MIT License

Links
Synced at

Sun, 22 Dec 2024 09:58:38 GMT

Languages