File & Folder Label Extension

Add custom labels (colors) to files and folders in the explorer view to make them stand out. Choose from circle type (🔴) and square type (🟥) badges.

Features

• Add labels to files and folders in the explorer view
• Select colors from a list to visually distinguish items
• Choose badge type (🔴 Circle Type / 🟥 Square Type)
• Multiple labels per file/folder (circle/square × color)
• Primary label is shown as the badge; when multiple labels are set, the badge is shown as primary emoji + “+”, and the tooltip shows all badge emojis
• Label picker (QuickPick) lets you toggle multiple labels at once; the last clicked label at save time becomes the primary
• Remove label functionality
• Clear all labels at once
• Multi-language support (English, Japanese and other major languages)

Usage

Editing Labels

1. Right-click a file or folder in the explorer view
2. Select "Edit Labels"
3. In the label picker, toggle the combinations of color × badge type (circle/square) you want to enable
   • Checked items are active labels, unchecked items are removed
   • Existing labels are pre‑selected when the picker opens
4. The last label you click (turn ON) before confirming becomes the primary label for that file/folder

Or, run the "Edit Labels" command from the command palette (Ctrl+Shift+P / Cmd+Shift+P)

Removing a Label

1. Right-click a file or folder with a label in the explorer view
2. Select "Remove Label"

Clearing All Labels

Run the "Clear All Labels" command from the command palette

Listing Labeled Files and Folders

You can list all files and folders that currently have labels and quickly reveal them in the explorer:

1. Open the command palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run the "Show Labeled Files/Folders" command
3. Select an item from the list (displayed with its badge and relative path)
4. The selected file/folder will be revealed in the explorer view

Customization

Color Settings

You can customize the color list in settings.json:

{
  "fileLabel.colors": [
    {
      "name": "Red",
      "color": "#ff6b6b",
      "backgroundColor": "#ff6b6b33"
    },
    {
      "name": "Blue",
      "color": "#4dabf7",
      "backgroundColor": "#4dabf733"
    }
  ]
}

• name: Display name of the color
• color: Badge color (hex color code)
• backgroundColor: Background color (hex color code with transparency)

Internationalization

This extension supports multiple languages:

• English (default)
• Japanese (日本語)
• Chinese (Simplified) (简体中文)
• Chinese (Traditional) (繁體中文)
• Spanish (Español)
• French (Français)
• German (Deutsch)
• Russian (Русский)
• Korean (한국어)
• Portuguese (Brazil) (Português)

The UI automatically adapts to your VSCode language setting.

Notes

• Due to VSCode API limitations, direct background color setting in the explorer view is not fully implemented
• Currently, visual distinction is achieved through colored badges
• Label information (including label order and primary label) is stored in the extension's global storage
• Context menu commands ("Edit Labels" / "Remove Label") appear when you right-click a file or folder in the explorer on the local filesystem (scheme: file).

Supported Labels

• Badge types:
  • 🔴 Circle Type
  • 🟥 Square Type
• Color × badge combinations:
  • Red: 🔴 / 🟥
  • Blue: 🔵 / 🟦
  • Green: 🟢 / 🟩
  • Yellow: 🟡 / 🟨
  • Purple: 🟣 / 🟪
  • Orange: 🟠 / 🟧

License

MIT