README file from
GithubVault Palette
Vault Palette is inspired by Mithadon's original plugin, Mithadon/obsidian-color-folders-files. This project expands that idea into a broader vault styling tool for folders, files, and tags.
Customize the appearance of folders, files, and tags in Obsidian through a context menu and plugin settings panel.
Features
- Right-click any file or folder to customize its appearance.
- Use optional background colors, border colors, text colors, bold, italic, and opacity.
- Keep folder text styling separate from the styling applied to files inside that folder.
- Apply folder styles to subfolders.
- Apply a separate file text style to all files inside a folder.
- Use stable rainbow colors for file names inside a styled folder.
- Save and apply presets.
- Detect vault tags automatically.
- Set one shared tag text color and per-tag background colors.
- Import and export plugin settings.
Usage
- Right-click any file or folder in the file explorer.
- Select Customize appearance.
- Adjust the folder or file appearance.
- For folders, optionally enable Apply custom file text style and configure the file text color, bold, and italic settings.
- Click Apply.
Presets
Presets save the full style package:
- Main item style: background, border, text color, bold, italic, and opacity.
- Folder behavior: apply to subfolders.
- File behavior: optional custom style for files inside the folder.
- Rainbow file names.
When a preset is applied to a folder, the main item style affects the folder and the file behavior affects files inside that folder. When the same preset is applied directly to a file, only the main item style is used.
Tags
Open the plugin settings and switch to the Tags tab. Vault Palette detects tags from Obsidian's metadata cache and lets you set:
- One shared text color for all tags.
- A separate background color for each detected tag.
Manual Installation
- Download
main.js,manifest.json, andstyles.cssfrom a release. - Create this folder inside your vault:
.obsidian/plugins/vault-palette/. - Copy the three downloaded files into that folder.
- Restart Obsidian or reload plugins.
- Enable Vault Palette in Settings > Community plugins.
Development
Install dependencies:
npm install
Build the plugin:
npm run build
For local testing, copy main.js, manifest.json, and styles.css into:
<your-vault>/.obsidian/plugins/vault-palette/
Support
If Vault Palette helps your Obsidian workflow, you can support development here:
Credits
Vault Palette is inspired by Mithadon's Color Folders and Files plugin. The original project is licensed under the MIT license.