# Theme 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 `@themepadd` directive from each installed theme's `theme.css` and 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 1. Open Obsidian and go to **Settings → Community plugins**. 2. If restricted mode is on, select **Turn on community plugins**. 3. Select **Browse** and search for **Theme PADD**. 4. Select **Install**, then **Enable**. ### BRAT [BRAT](https://github.com/TfTHacker/obsidian42-brat) installs plugins directly from their GitHub repository and auto-updates them on each release. 1. Install **BRAT** from **Settings → Community plugins → Browse** and enable it. 2. Open the command palette (`Ctrl+P` (Windows) or `Command+P` (macOS)) and run **BRAT: Add a beta plugin for testing**. 3. Enter the repository URL: `https://github.com/Jalad25/theme-padd`. 4. Choose whether to track the latest release or the latest commit, then select **Add Plugin**. 5. 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 1. Download `main.js`, `manifest.json`, and `styles.css` from the latest release. 2. In your vault, create the folder `.obsidian/plugins/theme-padd/` if it does not already exist. 3. Copy the downloaded files into that folder. 4. Open Obsidian, go to **Settings → Community plugins**, and enable **Theme PADD**. ## Usage 1. Install a theme with Theme PADD support from **Settings → Appearance → Themes**. 2. Open **Settings → Theme PADD** and expand the theme to tweak its settings. ## License GNU Affero General Public License v3.0. See [LICENSE](LICENSE) for details.