It’s ls + du + tree with interactive TUI on your terminal! gls is created to easily view, filter and search your files, folders and directories with their size whenever you need to open up some storage space. It wouldn’t be wrong to say that gls is a minimal yet powerful file manager CLI tool.

• Installation
• Usage
  • Default usage (TUI)
  • Text mode
• Features
  • TUI shortcuts
  • Configuration
  • Command line arguments
• How to Contribute

Installing gls on your machine is pretty simple: just clone the repo and install cmd/gls.go:

$ git clone https://github.com/ozansz/gls
$ cd gls
$ go install ./cmd/gls.go

After you run go install command, an executable file name gls is created in $GOPATH/bin. Now, you can simply run gls in terminal:

$ gls

There are two running modes of gls: TUI and text-based.

The TUI mode is interactive and you will be able to use all of the features of gls, such as searching by text/regular expression, traversing on the file tree, creating/opening/deleting files and many other things, until you close the program.

The text mode however, is fairly simple and is a literal combination of running tree and du altogether, with some additional features.

The command below runs gls with TUI, which is the default mode. It parses the file tree under the specified path along with the file and folder sizes on disk, then shows the tree view of the parsed tree.

gls -path ~/Downloads

The command below does the same parsing process as the command above does. Except, this one just dumps the parsed tree as a the tree command does with the file/folder sizes and permissions, to the terminal.

gls -nogui -path ~/Documents

gls includes (and still continues to include more) several features that mimic a normal file manager:

• List the files and folders under the specified path, in tree view
• Show current file info: size on disk, permissions, path, MIME type and last modification
• Sort the tree by the size on disk
• Search files/folders by name, using both plaintext and regular expressions
• Ignore specific files/folders by using regular expressions, similar to .gitignore style
  • Default ignore file is .glsignore, but infinitely many other ignore files can be specified through the CLI arguments
• Open files and folders by default programs or executables that you specify
• Copy/paste and move files and folders
• Remove files
• Create (similar to touch) and open files to edit
• Walk on the file tree, collapse and expand nodes easily

You can freely change the key bindings and shortcuts or configure the program for your needs from gui/core.go .

After your changes, run

go build cmd/gls.go

in the project directory.

In addition, if you think that your configurations or other changes seem necessary to improve the project, your contributions will be welcomed :)

-debug
    	Increase log verbosity
-fmt string
   		size formatter, one of bytes, pow10 or none (default "bytes")
-ignore string
    	Comma-separated ignore files that specify which files folders to exclude
-nogui
    	text-only mode
-path string
    	path to run on (required)
-sort
    	sort nodes by size (default true)
-thresh string
    	size filter threshold, e.g. 10M, 100K, etc.

You can also read this section from terminal by using gls without parameters.

You are very welcome to contribute to gls! Here are a few steps to guide you how to start contributing:

1. Check the open issues tab to see if there are any issue you may be interested in fixing. You can also list the issues with only the good-first-issue tag

2. Check the contributing guide for more explanation on setting up the development environment, opening the PR, etc.