https://github.com/joknarf/lsicon
fastest ls command enhancer (icons/colors/tree)
https://github.com/joknarf/lsicon
color icons ls nerd-fonts shell-plugin
Last synced: 26 days ago
JSON representation
fastest ls command enhancer (icons/colors/tree)
- Host: GitHub
- URL: https://github.com/joknarf/lsicon
- Owner: joknarf
- License: mit
- Created: 2025-11-16T08:34:01.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-03-07T08:24:21.000Z (about 2 months ago)
- Last Synced: 2026-03-28T00:36:49.144Z (about 1 month ago)
- Topics: color, icons, ls, nerd-fonts, shell-plugin
- Language: Awk
- Homepage: https://joknarf.github.io/joknarf-tools
- Size: 107 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://joknarf.github.io/joknarf-tools)
[](https://github.com/joknarf/lsicon/actions/workflows/release.yml)
[]()
[]()
[](https://shields.io/)
[](https://github.com/joknarf/lsicon/releases/latest)
# lsicon
Simplest and fastest `ls` command enhancer in less than 20K (only uses bash/ls/tree/awk)
Much faster than other "modern" tools (here /usr containing ~150000 files):
| Tool | Command | Time (wsl ubuntu) | Time (centos9) |
|------------|------------------------|--------------------|------------------|
| | | `tty notty` | `tty notty` |
| GNU ls | `ls -lR --color /usr ` | `10.250s 6.001s` | `2.011s 1.049s` |
| **lsicon** | `ls+ -lR /usr ` | `10.878s 6.096s` | `3.202s 1.269s` |
| lsd | `lsd -lR /usr ` | `27.941s 13.698s` | `8.564s 2.627s` |
| eza | `eza --icons -lR /usr` | `31.340s 28.509s` | `8.795s 4.751s` |
## features
* all GNU ls features except
* -T displays tree view
* currently fixed time format `+%y-%m-%d %H:%M`
* display colors/icons according to file types/extensions/permissions
* display symlink target according to target file types/permissions
* display broken symlink
* highlight current user/groups and permissions
* dir/files tree with `-T`
* easy customization for colors/icons/extensions
## Prerequisites
* GNU ls
* on BSD/MacOS/Alpine coreutils package needed
* GNU awk or mawk
* on BSD/MacOS/Alpine gawk or mawk package needed
* tree >= 1.6.0 (for tree view only)
* bash
* Nerd Font in your Terminal
## Install
You can use a plugin manager, like the famous [joknarf/thefly](https://github.com/joknarf/thefly)
```
. <(curl https://raw.githubusercontent.com/joknarf/thefly/main/thefly) install
fly add joknarf/lsicon
```
or Use your prefered method according to your OS:
```
brew install joknarf/tools/lsicon
```
```
sudo dnf install https://github.com/joknarf/lsicon/releases/latest/download/lsicon.rpm
```
```
curl -OL https://github.com/joknarf/lsicon/releases/latest/download/lsicon.deb
sudo dpkg -i lsicon.deb
```
```
curl -OL https://github.com/joknarf/lsicon/releases/latest/download/lsicon.apk
sudo apk add --allow-untrusted lsicon.apk
```
```
curl -OL https://github.com/joknarf/lsicon/releases/latest/download/lsicon.pkg
sudo installer -pkg lsicon.pkg -target /
```
or just clone the repo, and put `ls+*` files in dir in your PATH, or just create a link to `ls+`
```
git clone https://github.com/joknarf/lsicon
```
## Usage
The lsicon command `ls+` is used with exactly same options as GNU `ls`, except the `-T` or `--tree` will display directory/files tree.
Additional parameters for ls+ tree (`ls+ -T|--tree`):
* `-P` limit files matching pattern for tree view
* `-L` limit tree depth for tree view
* `-f` full file path in tree
* `--prune` when -I or -P hide directories without matching entries
```
ls+
ls+ -alrt
ls+ -Talrt -P '*.py|*.css' --prune
...
```
You may want to replace the `ls` command with ls+ using:
```
alias ls='ls+'
```
By default with stdout not a tty, `ls+` falls back to ls command, if want to pipe to pager (less...) with icons/colors:
```
ls+ --color |less -RESX
```
## Customize
You can customize all icons association :
- editing `ls+.icons`
- creating a `~/.config/ls+/icons` file
- format of file : ` . [....]`
You can customize all colors association :
- editing `ls+.colors`
- creating a `~/.config/ls+/colors` file
- format of file : ` . [....]`
You can customize all theme colors :
- editing `ls+.theme`
- creating a `~/.config/ls+/theme` file
- format of file : ` `
- creating an empty theme, will use standard 16 colors