gardebring / PowerColorLS

PowerShell script to display a colorized directory and file listing with icons

PowerColorLS

A PowerShell module that displays a colorized directory and file listing with icons. Inspired by colorls

Overview

PowerColorLS is a PowerShell module that displays a colorized directory and file listing with icons in the terminal. For the module to work, you must first install Terminal-Icons and setup the Nerd Fonts

Installation

To install the module from the PowerShell Gallery:

Install-Module -Name PowerColorLS -Repository PSGallery

Example usage

Import-Module PowerColorLS
PowerColorLS

List all files and directories including hidden ones and ones starting with '.' in long listing (wide) format

PowerColorLS -a -l

List all files and directories including hidden ones and ones starting with '.' in long listing (wide) format and also include directory size

PowerColorLS -a -l --show-directory-size

List files only, followed by list directories only

PowerColorLS -f
PowerColorLS -d

Listing files in a git directory displays git status as well

PowerColorLS

Help

To get help about available arguments, run:

PowerColorLS --help

Output of help command:

Usage: PowerColorLs [OPTION]... [FILE]...
List information about files and directories (the current directory by default).
Entries will be sorted alphabetically if no sorting option is specified.

        -a, --all               do not ignore hidden files and files starting with .
        -l, --long              use a long listing format
        -r, --report            shows a brief report
        -1                      list one file per line
        -d, --dirs              show only directories
        -f, --files             show only files
        -ds, -sds, --sds, --show-directory-size
                                show directory size (can take a long time)
        -hi, --hide-icons       hide icons

sorting options:

        -sd, --sort-dirs, --group-directories-first
                                sort directories first
        -sf, --sort-files, --group-files-first
                                sort files first
        -t, -st, --st
                                sort by modification time, newest first

general options:

        -h, --help         prints this help
        -v, --version      show version information

Alias to ls

Set-Alias -Name ls -Value PowerColorLS -Option AllScope