2.8 KiB
Theme Engine FAQ
Frequently asked questions and solutions for common issues.
Why are my colors not changing after activating a profile?
This is the most common issue.
Usually this happens because a Community Theme (such as Minimal or other installed themes) is overriding the variables managed by Theme Engine.
Recommended Solution
-
Open:
Settings → Appearance → Themes -
Select:
Default -
Return to Theme Engine.
Your profile colors should now apply correctly.
Alternative Solution (Customize Existing Themes)
If you want to continue using another community theme:
-
Switch Obsidian temporarily to the Default theme.
-
Open Theme Engine.
-
Click:
Import / Paste (.css) -
Select:
Import from installed theme -
Choose the desired theme.
Theme Engine creates an editable profile based on that theme.
Why is my background visible but parts of the UI remain dark?
Theme Engine uses automatic transparency handling.
When a background is active, important variables are automatically adjusted, including:
--background-primary--sidebar-background--background-secondary
This allows your image or video background to become visible through the interface.
What is the difference between Profile Snippets and Global Snippets?
Profile Snippets
Profile snippets belong to one profile only.
Characteristics:
- Activate only with their profile
- Included when exporting profiles
- Useful for profile-specific styles
Example:
h1 {
color: red;
}
Global Snippets
Global snippets remain active across all profiles.
Characteristics:
- Always active
- Not tied to a specific profile
- Useful for universal customization
Example:
body {
font-family: Inter;
}
What are Snapshots?
Snapshots are a safety mechanism.
When using:
Pin
Theme Engine saves:
- Colors
- Snippets
- CSS
- Rules
- Related settings
If you later dislike your changes:
Reset to Pinned
restores the previous saved state instantly.
I used the old Color Master beta. How can I keep my profiles?
Automatic migration was removed to comply with Obsidian plugin guidelines.
To migrate manually:
- Close Obsidian.
- Open:
.obsidian/plugins/obsidian-color-master/
- Copy:
data.json
- Paste into:
.obsidian/plugins/theme-engine/
- Restart Obsidian.
Still having problems?
If you encounter unexpected behavior:
- Export your important profiles first.
- Open:
Theme Engine → Advanced Settings
- Use:
Reset Plugin
If problems continue:
- Open a GitHub issue
- Include screenshots if possible
- Mention your Obsidian version and plugin version