https://github.com/j3lte/vscode-folder-customization
VSCode Extension to customize your folder and subfolders based on a specific path. Set a color, text badge, emoji badge or tooltip for any folder in your workspace.
https://github.com/j3lte/vscode-folder-customization
customization folder folder-tooling vscode vscode-extension
Last synced: 3 days ago
JSON representation
VSCode Extension to customize your folder and subfolders based on a specific path. Set a color, text badge, emoji badge or tooltip for any folder in your workspace.
- Host: GitHub
- URL: https://github.com/j3lte/vscode-folder-customization
- Owner: j3lte
- License: mit
- Created: 2024-08-09T15:38:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-12T18:31:07.000Z (over 1 year ago)
- Last Synced: 2025-10-29T16:44:25.353Z (3 months ago)
- Topics: customization, folder, folder-tooling, vscode, vscode-extension
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=j3lte.folder-customization
- Size: 12.7 MB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Folder Customization
Set a color, text badge, emoji badge or tooltip for any folder in your workspace.
This extension allows you to customize your folders in your workspace settings, by setting a color, badge (text or emoji) and tooltip. This is visible in the Explorer view and the tabs.
## Features
Right click on a folder in the Explorer view and select `Folder Customization` to open the context menu.
Select an emoji badge for a folder.
Select a color for a folder.
| **Features** |
| ------------------------------------------------- |
| Customize the color of a folder (256 ANSI Colors) |
| Set a text badge for a folder |
| Set an emoji as text badge for a folder |
| Set a tooltip for a folder |
## Requirements
This extension does not have any additional requirements. Internally it uses the `vscode.git` extension to determine if it should set a color or not.
## Usage
> Right click on a folder in the Explorer view and select `Folder Customization` to open the context menu.
| Command | Description |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| `Set Color` | _Set the color of the folder. This will colorize the folder (and all subfolders) in the Explorer view and the tabs (name)._ |
| `Clear Color` | _Clear the color of the folder while keeping the badge and tooltip._ |
| `Set Text Badge` | _Set a text badge for the folder. This will show next to the name of a file/folder. Note that a Text Badge can only be **2** letters._ |
| `Set Emoji Badge` | _Set an emoji badge for the folder. This will show next to the name of a file/folder._ |
| `Clear Badge` | _Clear the badge of the folder while keeping the color and tooltip._ |
| `Set Tooltip` | _Set a tooltip for the folder. This will show when hovering over a file/folder in the Explorer view._ |
| `Clear Tooltip` | _Clear the tooltip of the folder while keeping the color and badge._ |
| `Block Color` | _Block the parent folder from setting a color._ |
| `Block Badge` | _Block the parent folder from setting a badge._ |
| `Clear All Folder Customizations` | _Clear all customizations of the folder._ |
| `Reset Workspace` | _Clear all customizations of all folders in the workspace._ |
## Extension Settings
### Folders
This extension wlll save the configuration for every folder in `folder-customization.folders` in your workspace settings. This has the following keys:
| Key | Description |
| --------- | ----------------------------------------------------------------------- |
| `path` | Path of the folder |
| `color` | Color of the folder (`foldercustomization.AnsiColor0-255`) _(optional)_ |
| `badge` | Badge text of the folder _(optional)_ |
| `tooltip` | Tooltip of the folder _(optional)_ |
> These settings don't have to set by hand, you can use the context menu (see **Usage**) in the Explorer view to set these settings per folder.
> Note: When `color` or `badge` is set as `"__blocked__"`, it means it will block the parent folder from setting a color, or badge. This doesn't work for `tooltip`.
### Other settings
- `folder-customization.colorChangedFolders` - _Color changed folders in the Explorer view._ (default: `false`)
## Release notes
Please see the [changelog](CHANGELOG.md) for the information about the latest updates.
## Following extension guidelines
The extension follows the [Extension Guidelines](https://code.visualstudio.com/api/references/extension-guidelines) that are provided by Microsoft