Terminal Icons

파일 유형별 아이콘 자동 표시

터미널에서 파일과 폴더를 나열할 때 각 항목의 이름과 확장자를 분석해 Nerd Fonts의 유니코드 글리프를 활용한 아이콘을 자동으로 매핑합니다. 잘 알려진 파일명이나 폴더에 대해서는 우선적으로 특정 아이콘을 적용하고, 매칭되지 않는 항목은 범용 아이콘으로 표시됩니다.

아이콘 테마와 컬러 테마 지원

여러 아이콘 테마와 컬러 테마를 제공하며, 현재 적용된 테마를 확인하거나 테마를 전환하는 명령어를 지원합니다. 사용자가 직접 새로운 컬러 테마나 아이콘 테마를 만들어 커뮤니티에 제출할 수도 있습니다.

PowerShell 명령어 통합

Get-ChildItem, Get-Item 등 기존 PowerShell 명령어와 함께 자연스럽게 사용됩니다. Format-List, Format-Wide 등 다양한 출력 형식에서도 아이콘이 정상적으로 표시됩니다.

다운로드·설치 방법

PowerShell Gallery에서 직접 설치할 수 있습니다.

Install-Module -Name Terminal-Icons -Repository PSGallery

Scoop 패키지 관리자를 통해서도 설치가 가능합니다.

scoop bucket add extras

scoop install terminal-icons

설치 후에는 Import-Module -Name Terminal-Icons 명령어로 모듈을 불러와야 합니다.

기본 사용법

모듈을 불러온 후 Get-ChildItem 명령어를 사용하면 현재 디렉토리의 파일과 폴더 목록에 아이콘이 포함되어 표시됩니다.

Import-Module -Name Terminal-Icons

Get-ChildItem

특정 파일에 대한 정보를 조회할 때도 동일하게 아이콘이 표시됩니다.

Get-Item ./README.md

테마 관리 명령어

• Get-TerminalIconsTheme – 현재 적용된 아이콘 및 컬러 테마를 확인합니다.
• Get-TerminalIconsIconTheme – 사용 가능한 아이콘 테마 목록을 확인합니다.
• Get-TerminalIconsColorTheme – 사용 가능한 컬러 테마 목록을 확인합니다.
• Set-TerminalIconsTheme – 아이콘 및 컬러 테마를 설정합니다.
• Show-TerminalIconsTheme – 현재 테마가 적용된 상태의 예시 디렉토리와 파일을 보여줍니다.
• Add-TerminalIconsIconTheme – 현재 사용자에 대해 아이콘 테마를 추가합니다.
• Add-TerminalIconsColorTheme – 현재 사용자에 대해 컬러 테마를 추가합니다.
• Remove-TerminalIconsTheme – 지정된 테마를 제거합니다.

이런 경우에 유용합니다

PowerShell 터미널에서 자주 파일 목록을 확인하는 개발자나 시스템 관리자에게 유용합니다. 파일 이름만으로는 유형을 빠르게 구분하기 어려운 상황에서 아이콘을 통해 Markdown, Python 스크립트, 라이선스 파일, 폴더 등을 한눈에 식별할 수 있습니다.

스크립트를 관리하거나 여러 디렉토리를 탐색할 때 파일 유형을 빠르게 파악해야 하는 워크플로우에 적합합니다.

지원 환경·시스템 요구사항

PowerShell 모듈이며, Nerd Fonts 커스텀 폰트가 반드시 설치되어 있어야 합니다. Nerd Fonts는 파일별 유니코드 글리프를 포함하고 있어 아이콘 표시에 사용됩니다.

Windows 기본 콘솔에서 사용 시 Nerd Fonts가 올바르게 인식되지 않을 수 있습니다. VSCode 터미널, ConEmu, Terminus 같은 타사 터미널을 사용하면 더 안정적으로 동작합니다.

최신 버전·업데이트

현재 최신 버전은 0.11.0입니다.

제한 사항·확인 사항

• Nerd Fonts 커스텀 폰트가 설치되어 있지 않으면 아이콘이 올바르게 표시되지 않습니다.
• Windows 기본 콘솔 환경에서는 Nerd Fonts 인식 문제로 아이콘이 깨져 보일 수 있습니다. Mark Wragg의 빠른 안내 문서나 Nerd Fonts 관련 이슈(#269)를 참고해 추가 설정이 필요할 수 있습니다.
• 파일 유형이 매칭되지 않는 항목은 범용 아이콘으로 대체되어 표시됩니다.

화면으로 보는 주요 기능

파일 목록 보기

터미널 창에서 디렉토리 내용을 보여주는 목록입니다. 각 파일과 폴더 이름 옆에 파일 유형을 나타내는 아이콘이 표시됩니다. 예를 들어 'build.ps1'에는 스크립트 아이콘, 'CHANGELOG.md'와 'README.md'에는 문서 아이콘, 'LICENSE'에는 라이선스 아이콘이 표시됩니다.

파일 목록 보기

터미널 창에서 디렉토리 내용을 보여주는 목록입니다. 폴더와 파일 이름 옆에 각각 다른 아이콘이 매핑되어 파일 유형을 한눈에 구분할 수 있습니다.