Tigermen0710/gols

ls with icons, written in go

Enhanced Directory Lister (GOLS)

This program lists the files and directories in the current working directory with colored and icon-based outputs for different file types.

Features

• List files and directories plus symlinks.
• Supports showing hidden files or directories.
• Colored icons based on file types.
• List directories.
• Order (sort) files by time or size.
• Show a tree of current or any directory path.
• Size of files.
• Options to show directories or files only.
• Summary of files and directories.
• List file based on extention gols /path/to/dir/ .go to list all go files.
• Exlude files using there extention gols -x go,txt ....
• Use the extention to list files gols -e go to list golang files.

Table of Contents

• Installation
  • Dependencies
  • Using Git
    • Go
    • Makefile
  • AUR
  • XBPS-SRC
• Usage
  • No Options
  • With Options
• Flags
• Contributing

Installation

Dependencies

• Go Compiler: Install Go
• Nerd Fonts: Download Nerd Fonts

Clone the repository

Go

git clone https://github.com/Tigermen0710/gols
cd gols/
go build
sudo cp gols /usr/local/bin/
sudo cp gols.1 /usr/local/share/man/man1/ # To copy the man page.
gols

Makefile

git clone https://github.com/Tigermen0710/gols
cd gols/
make
sudo make install
gols

Note: gols is in the AUR and a template for Void Linux (xbps-src).

Arch

yay -S gols

Void

Assuming you have void-packages.

git clone https://github.com/elbachir-one/void-templates
cp -r void-templates/gols/ void-packages/srcpkgs/   # Copying the gols directory that has the template.
cd void-packages/
./xbps-src pkg gols
sudo xbps-install -R hostdir/binpkgs gols

Usage

No-Flags

gols

Flags

gols [FLAG] [DIRECTORY] [FILES]

Flags

flag	description	example
-?	display help options or flags
-a	show hidden files or directories
-A	show only hidden directories and files
-c	show all files in one column
-D	list only directories
-e	list files based on there extention
-f	show a summary of file and directories
-F	list files only
-h	Only for long listing to show the size in a human-readable format
-i	show directory icon on left
-g	Show the group only
-l	long listing
-m	only show symbolik links
-o	sort files by size
-O	show the owner of the file
-p	get only the permissions
-r	tree like listing, and d number to do the depth (gols -rd 1)
-s	show files size
-t	order all by time
-T	show only the time
-v	version number
-x	exclude files from the listing using there extention

Contributing

We always appreciate your contributions, problems, and feature suggestions. Your feedback is much appreciated, whether you're reporting bugs, proposing new features, or sharing your own enhancements. We value the time and work you invested in assisting us in improving this project.