Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 230 Commits
.github		.github
.vscode		.vscode
Terminal-Icons		Terminal-Icons
docs/en-US		docs/en-US
media		media
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE		LICENSE
README.md		README.md
build.ps1		build.ps1
psakeFile.ps1		psakeFile.ps1
requirements.psd1		requirements.psd1

Repository files navigation

Terminal-Icons

A PowerShell module to show file and folder icons in the terminal.

GitHub Actions	PSGallery	License

Overview

Terminal-Icons is a PowerShell module that adds file and folder icons when displaying items in the terminal.This relies on the custom fonts provided byNerd Fonts.

You must be using one of the fonts provided by Nerd Fonts for this module to work as these fonts include tons of custom glyphs/icons that are referenced by their unicode number.

How Does this Work?

It uses a customformat.ps1xml file that inspects the items being displayed and looks up their appropriate icon based on name or extension.Icons for well-known files/folders are attempted to be used first before displaying an icon based on the file extension.Any files/folders that are not matched are shown using a generic file or folder icon.

Installation

To install the module from thePowerShell Gallery:

Install-Module-Name Terminal-Icons-Repository PSGallery

You can also install it fromScoop:

scoop bucket add extrasscoop install terminal-icons

Usage

Import-Module-Name Terminal-IconsGet-Item ./README.mdGet-ChildItemGet-ChildItem|Format-ListGet-ChildItem|Format-Wide

Commands

Command	Description
Add-TerminalIconsColorTheme	Add a Terminal-Icons color theme for the current user.
Add-TerminalIconsIconTheme	Add a Terminal-Icons icon theme for the current user.
Format-TerminalIcons	Prepend a custom icon (with color) to the provided file or folder object when displayed.
Get-TerminalIconsColorTheme	List the available color themes.
Get-TerminalIconsIconTheme	List the available icon themes.
Get-TerminalIconsTheme	Get the currently applied color and icon theme.
Remove-TerminalIconsTheme	Removes a given icon or color theme.
Set-TerminalIconsColorTheme	DEPRECATED Set the Terminal-Icons color theme.
Set-TerminalIconsIconTheme	DEPRECATED Set the Terminal-Icons icon theme.
Set-TerminalIconsTheme	Set the Terminal-Icons icon and/or color theme.
Show-TerminalIconsTheme	List example directories and files to show the currently applied color and icon themes.

Screenshots

Get-ChildItem-Path.-Force

Tips

If using the default console in Windows and not something like VSCode, ConEmu, Terminus, etc., you may have issues getting a nerd font to be recognized correctly.Try following thisquick guide byMark Wragg.Issue #269 on Nerd Fonts has more information.

Contributions

Any ideas on how to improve this module are welcome.If you have ideas for an appropriateglyph to display for a well-known folder or file, or a particular file extension, please raise anissue.If you'd like to submit an entirely new color or icon theme, take a look at the existing oneshere andhere, create your new file(s) named what ever you like, and submit a pull request.