README file from
GithubTheme PADD
A PADD (Palette, Animation, Decoration, and Density) modifier for your themes.
Features
- Per-theme settings UI — themes that opt in get their own settings panel under Settings → Theme PADD, with controls defined by the theme author.
- Multiple input types — color pickers (hex/rgb/hsl), text, number, toggle, and dropdown selects, organized into sections.
- Live preview — settings apply to the DOM immediately as you tweak them.
- Values persist across theme updates — when a theme ships a new version of its settings spec, your customizations migrate forward by field id.
- Auto-discovery — Theme PADD reads the
@themepadddirective from each installed theme'stheme.cssand fetches the settings spec from the theme's GitHub release. No per-theme configuration needed. - Clear error reporting — if a theme's spec is malformed or can't be downloaded, the settings tab shows a readable error with a Copy button so you can share the details with the theme author.
Installation
Obsidian Community Plugins
- Open Obsidian and go to Settings → Community plugins.
- If restricted mode is on, select Turn on community plugins.
- Select Browse and search for Theme PADD.
- Select Install, then Enable.
BRAT
BRAT installs plugins directly from their GitHub repository and auto-updates them on each release.
- Install BRAT from Settings → Community plugins → Browse and enable it.
- Open the command palette (
Ctrl+P(Windows) orCommand+P(macOS)) and run BRAT: Add a beta plugin for testing. - Enter the repository URL:
https://github.com/Jalad25/theme-padd. - Choose whether to track the latest release or the latest commit, then select Add Plugin.
- Open Settings → Community plugins and enable Theme PADD.
To get future updates, run BRAT: Check for updates to all beta plugins from the command palette, or enable auto-update in BRAT's settings.
Manual
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - In your vault, create the folder
.obsidian/plugins/theme-padd/if it does not already exist. - Copy the downloaded files into that folder.
- Open Obsidian, go to Settings → Community plugins, and enable Theme PADD.
Usage
- Install a theme with Theme PADD support from Settings → Appearance → Themes.
- Open Settings → Theme PADD and expand the theme to tweak its settings.
License
GNU Affero General Public License v3.0. See LICENSE for details.