logo-ls

Modern ls command with vscode like File Icon and Git Integrations. Written in Golang

1,174

View on GitHub

Top Related Projects

colorls

5,030

A Ruby gem that beautifies the terminal's ls command, with color and font-awesome icons. :tada:

nnn

20,254

n³ The unorthodox terminal file manager

Quick Overview

logo-ls is a modern, feature-rich alternative to the traditional ls command for listing directory contents. It enhances the file listing experience by displaying colorful icons, Git status information, and file permissions in a visually appealing format.

Pros

Visually appealing output with colorful icons for different file types
Integrated Git status information for repositories
Customizable display options and sorting methods
Cross-platform compatibility (Linux, macOS, Windows)

Cons

Requires installation of additional software (not a built-in command)
May be slower than the standard ls command for very large directories
Limited support for some advanced ls features
Dependency on external icon fonts for optimal display

Getting Started

Install logo-ls:

# For macOS using Homebrew
brew install logo-ls

# For other systems, download the appropriate binary from the GitHub releases page

Basic usage:

# List files in the current directory
logo-ls

# List files with long format
logo-ls -l

# List all files, including hidden ones
logo-ls -a

# Sort files by size
logo-ls --si

Customize the output:

# Display Git status information
logo-ls --git

# Show only directories
logo-ls -d

# Use tree-like output
logo-ls --tree

For more advanced usage and configuration options, refer to the project's README and documentation on the GitHub repository.

Competitor Comparisons

exa

24,005

A modern replacement for ‘ls’.

Pros of exa

Written in Rust, offering better performance and memory safety
More extensive feature set, including Git integration and extended attributes
Larger community and more frequent updates

Cons of exa

Larger binary size due to more features
Steeper learning curve with more options and flags

Code comparison

exa:

pub fn print_dir(dir: &Dir, options: &Options) -> io::Result<()> {
    let mut files = Vec::new();
    for entry in dir.files() {
        files.push(entry?);
    }
    // ... (sorting and filtering logic)
    for file in files {
        print_file(&file, options)?;
    }
    Ok(())
}

logo-ls:

func printDir(path string, opts *Options) error {
    entries, err := ioutil.ReadDir(path)
    if err != nil {
        return err
    }
    // ... (sorting and filtering logic)
    for _, entry := range entries {
        printFile(entry, opts)
    }
    return nil
}

Both projects aim to enhance the traditional ls command, but exa offers a more comprehensive feature set at the cost of a larger binary and potentially more complex usage. logo-ls, written in Go, focuses on simplicity and visual enhancements with icons, making it more accessible for users seeking a straightforward upgrade to the standard ls command.

colorls

5,030

A Ruby gem that beautifies the terminal's ls command, with color and font-awesome icons. :tada:

Pros of colorls

More extensive customization options for colors and icons
Supports tree view for directory structure visualization
Includes additional features like file/directory sorting and git status integration

Cons of colorls

Written in Ruby, which may have slower performance compared to Go
Requires Ruby and additional gem dependencies to be installed
More complex setup and configuration process

Code Comparison

colorls (Ruby):

def show
  @contents = Dir.entries(@input).reject { |x| x =~ /^\./ }
  @contents.sort! { |a, b| a.downcase <=> b.downcase }
  @contents.each do |content|
    init_entry_data(content)
    display_entry
  end
end

logo-ls (Go):

func (f *File) String() string {
    return fmt.Sprintf("%s%s%s%s%s%s%s%s%s",
        f.permissions, f.nlink, f.owner, f.group,
        f.size, f.date, f.name, f.arrow, f.link)
}

Both projects aim to enhance the standard ls command with colorized output and icons. colorls offers more features and customization options but requires Ruby and has a more complex setup. logo-ls, written in Go, focuses on simplicity and performance, making it easier to install and use out of the box.

nnn

20,254

n³ The unorthodox terminal file manager

Pros of nnn

Full-featured file manager with extensive functionality beyond listing files
Highly customizable with plugins and keybindings
Faster performance for large directories

Cons of nnn

Steeper learning curve due to more complex interface
Less visually appealing output compared to logo-ls's colorful icons
Requires more setup for optimal usage

Code Comparison

nnn (main loop):

while ((opt = getopt_long(argc, argv, OPSTR, long_options, NULL)) != -1) {
    switch (opt) {
    case 'A':
        cfg.showdetail = 1;
        break;
    case 'b':
        cfg.nobatch = 1;
        break;
    // ...
}

logo-ls (main function):

func main() {
    flag.Parse()
    args := flag.Args()
    if len(args) == 0 {
        args = append(args, ".")
    }
    for _, path := range args {
        printDir(path)
    }
}

Both projects use command-line argument parsing, but nnn's implementation is more complex due to its broader feature set. logo-ls focuses primarily on listing files with icons, resulting in simpler code structure.

lf

8,350

Terminal file manager

Pros of lf

Full-featured terminal file manager with extensive functionality
Highly customizable with keybindings and configuration options
Supports remote file systems and archive browsing

Cons of lf

Steeper learning curve due to more complex features
Requires more system resources compared to logo-ls
May be overkill for users who only need basic file listing

Code Comparison

lf (Go):

func (f *File) Name() string {
    if f.dirCache != nil {
        return f.dirCache.name
    }
    return f.Path
}

logo-ls (Go):

func (f *File) Name() string {
    return f.FileInfo.Name()
}

Summary

lf is a comprehensive terminal file manager with advanced features, while logo-ls focuses on enhancing the standard ls command with icons and colors. lf offers more functionality but may be more complex for casual users, whereas logo-ls provides a simpler, visually appealing file listing experience. The code comparison shows that lf implements custom file naming logic, while logo-ls relies on the standard Go file information structure.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

logo-ls

modern ls command with beautiful Icons and Git Integrations . Written in Golang

Command and Arguments supported are listed in HELP.md

Features
Usage
- Flags
  - -1
  - -a (or) --all
  - -A (or) --almost-all
  - -D (or) --git-status
  - -l, -o, -g, -G
  - -R (or) --recursive
  - -? (or) --help
  - Sorting:
    - -t, -S, -X, -U, -v and -r (--reverse)
  - -T (or) --time-style=value
  - -i (or) --disable-icon
  - -c (or) --disable-color
- Combination of flags
- Multiple Files and Directories
Prerequisites
Installation
Recommended configurations
Updating
Icon Set
Contributing
License

Features

:arrow_up: TOC

This project is build to add esthetics to ls(coreutiles) command

Over 250+ icons :sunglasses:
Supporting 600+ files, extensions and directories
16 Million, true colors supported
Git Status Integration
:racehorse: Near native speed. (thanks to Golang)
Language agnostic binaries

This project is highly inspired by ls(coreutiles) and color ls. The project tries to find a happy path between speed and aesthetics.

Usage

:arrow_up: TOC

All supported flags can be found by using help flag $ logo-ls -?. The same has been provided as HELP.md.

The project also has its manpage which can be accessed by man logo-ls

Flags

Almost all flags are same as that of the classic ls command and behave similarly. The project can be used as a drop-in replacement for the ls(coreutiles)

With -1: List one entry per line

With -a (or) --all : Does not ignore entries starting with '.'

With -A (or) --almost-all : Does not ignore entries starting with '.', except ./ and ../

With -D (or) --git-status: Add Git Status to the listed Files and Directory
- Note: As much I would love to make this the default behavior of the command but showing git status is an intensive task and may slow (a tiny bit) the command itself. If you want you can make alias to the command with -D applied to it.

With -l: Shows in long listing format other similar commands are:
- -o: like -l, but do not list group information
- -g: like -l, but do not list owner
- -G (or) --no-group: in a long listing, don't print group names

With -R (or) --recursive: list subdirectories recursively

With -? (or) --help: print the help message
- similar message can be found at HELP.md.

Sorting: There are many sorting flags available [default is alphabetic order]
- With -t: sort by modification time, newest first
- With -S: sort by file size, largest first
- With -X: sort alphabetically by entry extension
- With -U: do not sort; list entries in directory order
- With -v: natural sort of (version) numbers within text
- With -r (or) -reverse: reverse order while sorting

With -T (or) --time-style=value: set time/date format in long formats (-l, -o, -g). There are many options to chose from all are listed in HELP.md.

With -i (or) --disable-icon: don't print icons of the files

With -c (or) --disable-color: don't color icons, filenames and git status
- Note: use a combination of -ic to print output to a file $ logo-ls -ic > t.txt

For all available commands see manpage or HELP.md

Combination of flags

This project uses getopt which is a golang variant of the classic getopt utility used in ls(coreutiles). Thus any combination of flags are possible and can be used.

Multiple Files and Directories

You can provide multiple files and directories as command argument [default to PWD] and all will be displayed accordingly.

Prerequisites

:arrow_up: TOC

For proper working of logo-ls the following should be set

UTF-8: The terminal should be UTF-8 encoded (Can display Unicode-Code Point)
True Color Support: The terminal can display color (16 Million Colors). for more information of True Color and supported Terminals see here
Nerd Fonts: Nerd fonts are required to display Icons on screen. Basically Nerd Fonts patches your current font i.e., the last few unicode points (approx 2,824 out of 143,859) in the font are replaced with nerdy icons :nerd_face:. The complete patching process is given here

Installation

:arrow_up: TOC

Installation is very easy and straight forward with many options to choose from.

As of now almost all installation methods require downloading resources from the Github Release page of the project, so to be a bit more secure consider Checking the Signature of logo-ls_SHA512sums.txt text file and then use this file to check weather the resource have been tampered. This complete process is explained in more detail in Check the downloaded Resource section below. (This is a recommended step and not at all required)

Debian (.deb package)

If you are on Debian or any other Debian based distribution then installation is simple.

Step 1

Download the .deb package from Github Release Page. Available OS_Architectures include: i386, amd64, arm64 and armV6. Check your downloaded resource(s) if you like.

Step 2

Use the dpkg -i path/to/downloaded/resource/ to install the binary and the manpage

Red Hat (.rpm package)

If you are on Red Hat or any other Red Hat based distribution (like fedora) then installation is simple.

Step 1

Download the .rpm package from Github Release Page. Available OS_Architectures include: i386, amd64, arm64 and armV6. Check your downloaded resource(s) if you like.

Step 2

Use the rpm -i path/to/downloaded/resource/ to install the binary and the manpage

Arch linux

Simply run yay -S logo-ls. (Or use the AUR helper of your choice)

Alternatively you can clone the PKGBUILD and build the package manually:

git clone https://aur.archlinux.org/logo-ls.git
cd logo-ls
makepkg -si

MacOS (Darwin)

To install logo-ls on darwin you have to download the binary. Support for Homebrew will come soon

Step 1

Download logo-ls_Darwin_x86_64.tar.gz from Github Release Page.

Step 2

Extract a gzipped archive in the current directory.

$ tar -xzf logo-ls_Darwin_x86_64.tar.gz

This will produce logo-ls_Darwin_x86_64 directory in the current directory with the following files: HELP.md, LICENSE, logo-ls and logo-ls.1.gz

Step 3

Install the binary logo-ls by placing it in /usr/local/bin

$ cd logo-ls_Darwin_x86_64
$ sudo cp logo-ls /usr/local/bin

Step 4

If you want the man page of logo-ls place logo-ls.1.gz in /usr/local/share/man/man1/

$ sudo cp logo-ls.1.gz /usr/local/share/man/man1/

Linux

To install logo-ls on any other Linux Distribution you have to download the binary.

Step 1

Download the .tar.gz archive from Github Release Page. Available OS_Arch include: i386, x86_64 (amd64), arm64 and armV6. Check your downloaded resource(s) if you like.

Step 2

Extract a gzipped archive in the current directory.

$ tar -xzf logo-ls_Linux_[ARCH].tar.gz

This will produce logo-ls_Linux_[ARCH] directory in the current directory with the following files: HELP.md, LICENSE, logo-ls and logo-ls.1.gz

Step 3

Install the binary logo-ls by placing it in /usr/local/bin

$ cd logo-ls_Linux_[ARCH]
$ sudo cp logo-ls /usr/local/bin

Step 4

If you want the man page of logo-ls place logo-ls.1.gz in /usr/share/man/man1/

$ sudo cp logo-ls.1.gz /usr/share/man/man1/

go get

If you have Golang installed on your system then the logo-ls can be downloaded and installed using the the go cli tool provided by the language

Step 1

The go cli installs the binary in the directory specified by $GOBIN env variable [default: ~/go/bin/]. In order to call logo-ls from anywhere in user-space, this directory which holds the binary must be present in $PATH env variable.

$ echo $PATH

Step 2

Now simply install the binary using go get in home directory

$ cd ~
$ go get github.com/Yash-Handa/logo-ls

Build from Source

It is quite simple to build the command from source. You should have Golang installed on your system.

Step 1

Clone this repository.

$ git clone https://github.com/Yash-Handa/logo-ls.git

Step 2

cd into the directory logo-ls. Then run go mod tidy to download the dependencies and after that go build to build your system specific binary

$ cd logo-ls
$ go mod tidy
$ go build

the go build command will produce logo-ls executable binary in the current directory.

Step 3

Place the logo-ls executable in a directory reachable from $PATH env variable.

$ sudo cp logo-ls /usr/local/bin

Step 4

If you want the man page of logo-ls place logo-ls.1.gz in /usr/share/man/man1/

$ sudo cp logo-ls.1.gz /usr/share/man/man1/

Check the downloaded Resource

After downloading the Resource(s) from the Github Release Page follow the below steps to check its authenticity.

Step 1

Download logo-ls_SHA512sums.txt.sig and logo-ls_SHA512sums.txt from Github Release Page and place them in the same directory as of the downloaded resource(s)

Step 2

Receive the public key of the signing party from keyserver.ubuntu.com server. This will add the developer's public key to your keyring.

$ gpg2 --keyid-format long --keyserver keyserver.ubuntu.com --recv-keys 0x28182066bcacccb2

gpg: key 28182066BCACCCB2: "Yash Handa (logo-ls) <yashhanda7@yahoo.com>" not changed
gpg: Total number processed: 1
gpg:              unchanged: 1

Step 3

check the signature on logo-ls_SHA512sums.txt

$ gpg2 --keyid-format long --verify logo-ls_SHA512sums.txt.sig logo-ls_SHA512sums.txt

gpg: Signature made Tue 08 Sep 2020 10:21:52 PM IST
gpg:                using RSA key D9498B225223344C0205FDF528182066BCACCCB2
gpg: Good signature from "Yash Handa (logo-ls) <yashhanda7@yahoo.com>" [ultimate]

A Good signature means that the checked file was definitely signed by the owner of the keyfile stated (if they didnât match, the signature would be reported as BAD)

Step 4

Use logo-ls_SHA512sums.txt file to verify the authenticity of the downloaded resource(s)

$ sha512sum -c logo-ls_SHA512sums.txt 2>&1 | grep OK

logo-ls_Linux_x86_64.tar.gz: OK
logo-ls_Linux_arm64.tar.gz: OK
logo-ls_Darwin_x86_64.tar.gz: OK
logo-ls_Linux_i386.tar.gz: OK
logo-ls_Linux_armv6.tar.gz: OK

Recommended configurations

:arrow_up: TOC

To add some short command (say, ils or ls) with some flag options by default, add this to your shell configuration file (~/.bashrc, ~/.zshrc, etc.) :

alias ils='logo-ls'
alias ila='logo-ls -A'
alias ill='logo-ls -al'
# equivalents with Git Status on by Default
alias ilsg='logo-ls -D'
alias ilag='logo-ls -AD'
alias illg='logo-ls -alD'

Updating

:arrow_up: TOC

As of now Updating is exactly similar as installation for Debian (.deb package), Red Hat (.rpm package), MacOS (Darwin) and Linux

Icon Set

:arrow_up: TOC

Contributing

:arrow_up: TOC

The project is always open to contributions. Especially for:

More Icons
Better ways to distribute software
Translations to other Languages (linguistic)

License

:arrow_up: TOC

The project is licensed under MIT. The Licence is available here.

Top Related Projects

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

Top Related Projects

Quick Overview

Pros

Cons

Getting Started

Competitor Comparisons

Pros of exa

Cons of exa

Code comparison

Pros of colorls

Cons of colorls

Code Comparison

Pros of nnn

Cons of nnn

Code Comparison

Pros of lf

Cons of lf

Code Comparison

Summary

Convert designs to code with AI

README

logo-ls

Table of contents

Features

Usage

Flags

Combination of flags

Multiple Files and Directories

Prerequisites

Installation

Debian (.deb package)

Step 1

Step 2

Red Hat (.rpm package)

Step 1

Step 2

Arch linux

MacOS (Darwin)

Step 1

Step 2

Step 3

Step 4

Linux

Step 1

Step 2

Step 3

Step 4

go get

Step 1

Step 2

Build from Source

Step 1

Step 2

Step 3

Step 4

Check the downloaded Resource

Step 1

Step 2

Step 3

Step 4

Recommended configurations

Updating

Icon Set

Contributing

License

Top Related Projects

Convert designs to code with AI