AnuPpuccin

Personal theme for Obsidian :3

Voted Best Theme in Gems of the Year 2022 awards 🎉

Notice

AnuPpuccin is currently on hiatus!
I have been busy with endsems and projects, thus I haven't been able to dedicate time to fix bugs and issues and I'm really sorry for that 😅. Thank you for your understanding!

## Preface Please do note that I've made this theme for myself, and it may not fit your use cases. However, I've made most of the configuration completely optional so that the experience remains as close to vanilla if you choose to do so. Most of the in-application variables are recolored so that your custom snippets can be used easily with the theme. This theme makes heavy use of the style settings plugin, which controls most of the features in the theme. The theme is perfectly usable even without style settings, but it's only a fraction of what it actually is with the plugin.

I will respond to feature/code removal only if there is substantial evidence of it being a direct copy of the original code and not just a simple imitation. (Please keep this point in mind before accusing me of being a low-effort theme developer.) ### If you like my theme: I've made this theme primarily for my own purposes and it's completely free, but if you do like it enough to consider throwing a few coins in my hat, here's a link.
## License AnuPpuccin is licensed under the GPL-3.0 license which allows you to modify the code freely, however the Copyright and license notices must be preserved in your CSS. If you redistribute a part of my code, please credit my theme in your CSS file, and specify which code you are using. **Please keep my Buy Me a Coffee link in your README if you do so.**

Installation

Normal Installation

Go to your theme folder (.obsidian/themes) and run:

git clone https://github.com/AnubisNekhet/AnuPpuccin.git

Updating

Go to your AnuPuccin folder (.obsidian/themes/Anuppuccin) and run:

git pull

Building

Clone the github repo and run sass src/base.scss theme.css in the root folder.

## Community Contributions AnuPpuccin has a [Discussions](https://github.com/AnubisNekhet/AnuPpuccin/discussions/categories/snippets) page dedicated to snippets that add a personal touch to your obsidian setup. If you want to share your customizations, feel free to do so! ## Features ### Custom palette

The theme supports various palettes (5 in the base theme and even more if you use the extended colorschemes snippet) which include many popular colorschemes such as Catppuccin and Dracula. These are heavily integrated into the theme as they are directly used to stylize various UI elements. ### Layouts Anuppuccin currently supports 2 layout variants.

### Rainbow folders The theme comes with a toggleable rainbow folder snippet which color-codes your folders as per their order in the filesystem.
It's great if you need to easily distinguish between folders or if you want to make your vault look a bit prettier (Both in my case :P)

#### Full rainbow theme This snippet makes the rainbow theme apply to the first layer of the root directory, aka only direct children.
You can choose if it applies to root files as well and customise the indentation border color.
#### Simple rainbow theme This snippet makes the rainbow theme apply to every folder in your filesystem, and the order is determined by the children's place in the parent folder.
You can toggle if the recolor applies to the title, the collapse border, the collapse icon and you can append a small icon to the folder title as well.
### Alternate tabs

### Customisable Decorations

Bold and italic colors can be toggled on and off and can be customised according to the palette as well. ### Callouts

The theme comes with many custom callout styles (which can be toggled so they won't interfere with your own callout snippet).
The snippet also includes support for using the colors of your selected palette which means that the callouts don't ever look out of place :)
If you use the admonition plugin/have custom callout colors, they won't be affected by the recolor as it only targets vanilla callouts. However, you can make them use AnuPpuccin's palette to support dynamic per-palette theming.
### Custom checkboxes & Speech bubbles

Anuppuccin's custom checkboxes try to mimic the original checkbox design as much as possible, while still being optional incase you want to use your own checkbox snippet. Speech bubbles have been provided which are useful for language learners and RPG vault users alike.
Custom checkboxes have been designed to match those provided by the Primary theme for ease of migration and consistency. | Syntax | Description | | ------- | --------------- | | `- [ ]` | Unchecked | | `- [x]` | Checked | | `- [>]` | Rescheduled | | `- [<]` | Scheduled | | `- [!]` | Important | | `- [-]` | Cancelled | | `- [/]` | In Progress | | `- [?]` | Question | | `- [*]` | Star | | `- [n]` | Note | | `- [l]` | Location | | `- [i]` | Information | | `- [I]` | Idea | | `- [S]` | Amount | | `- [p]` | Pro | | `- [c]` | Con | | `- [b]` | Bookmark | | `- ["]` | Quote | | `- [u]` | Up | | `- [d]` | Down | | `- [w]` | Win | | `- [k]` | Key | | `- [f]` | Fire | | `- [0]` | Speech bubble 0 | | `- [1]` | Speech bubble 1 | | `- [2]` | Speech bubble 2 | | `- [3]` | Speech bubble 3 | | `- [4]` | Speech bubble 4 | | `- [5]` | Speech bubble 5 | | `- [6]` | Speech bubble 6 | | `- [7]` | Speech bubble 7 | | `- [8]` | Speech bubble 8 | | `- [9]` | Speech bubble 9 | ### Colorful Frames

Adapted from Kepano's Minimal theme, colorful frames add some pop to your vault by displaying your accent color on the top-most bar. ### Simplified markdown embeds Markdown embeds have an alternate styling with an animated variant which can be toggled globally using style settings or individually using alt names for embeds, for example: `![[embed|alt-name]]` | Embed style | Alt name | | ----------- | -------- | | Seamless | seamless | ## Colorschemes used **Note**: Colorschemes that aren't in the base theme can be used through the [extended colorschemes](https://github.com/AnubisNekhet/AnuPpuccin/blob/main/snippets/extended-colorschemes.css) snippet.
**Important**: Some colorschemes have been been modified to fit the Catppuccin color value style, which means there will be some changes made to make the theme feel more natural. | Theme | Light Mode | Dark Mode | Extra Notes | | --------------------------------------------------------- | ---------- | --------- | --------------------------------------------------------------------------------------------------------------------------- | | [Atom](https://github.com/kognise/obsidian-atom) | Yes | Yes | Accent value is hardcoded into the theme. | | [Catppuccin](https://github.com/catppuccin/catppuccin) | Yes | Yes | There are 4 variants of the dark theme, namely: Frappe, Macchiato, Mocha and Mocha Old.
The light theme is called Latte. | | Coffee | No | Yes | Custom colorscheme | | [Biscuit](https://github.com/Biscuit-Colorscheme/biscuit) | Yes | Yes | - | | [Everforest](https://github.com/sainnhe/everforest) | Yes | Yes | - | | [Dracula](https://github.com/dracula/dracula-theme) | No | Yes | - | | [Gruvbox](https://github.com/morhetz/gruvbox) | Yes | Yes | - | | [Nord](https://github.com/arcticicestudio/nord) | Yes | Yes | A custom darker variant of the dark theme is included as well.
Accent value is hardcoded into the theme. | | Notion | Yes | Yes | - | | [Kanagawa](https://github.com/rebelot/kanagawa.nvim) | No | Yes | - | | [Rosé Pine](https://github.com/rose-pine/rose-pine-theme) | Yes | Yes | The second variant of the dark theme, namely Rosé Pine dawn hasn't been implemented yet. | | [Rosebox](https://github.com/KraXen72/rosebox) | No | Yes | Accent value is hardcoded into the theme. | | [Royal Velvet](https://github.com/caro401/royal-velvet) | No | Yes | - | | Sandy Beaches | Yes | No | Provided by [melnhh](https://github.com/melnhh) | | [Solarized](https://github.com/altercation/solarized) | Yes | Yes | - | | [thorns](https://codeberg.org/rini/thorns) | No | Yes | - |

Previews

Atom

Catppuccin

Latte

Frappe

Macchiato

Mocha

Mocha Old

Generic

Dark

AMOLED Dark

Coffee

Biscuit

Everforest

Dracula

Gruvbox

Nord

Nord Light

Nord Dark

Nord Darker (Custom Palette)

Notion

Kanagawa

Rosebox

Rosé Pine

Rosé Pine Dawn

Rosé Pine

Royal Velvet

Sandy Beaches

Solarized

Note: Themes are toggled via style settings, the default themes are **Latte** for light mode and **Mocha** for dark mode. ### Custom CSS Classes Inserting these css classes into your note frontmatter will style your notes individually. | CSS Class | Function | | --------------------------- | ------------------------------------------------------------- | | `heading-normal-toggle` | Disables color in headings | | `decorations-normal-toggle` | Disables color in text decorations like **bold** and _italic_ | | `hide-metadata` | Hides metadata | | `metadata-button` | Enables custom metadata button | ### Integrations - Excalidraw - Kanban - Style Settings #### Minimal Features AnuPpuccin does not come with any code provided by [Minimal](https://github.com/kepano/obsidian-minimal), however it does contain styling and style settings support for certain features that can be compiled via CSS. You can buy Kepano a coffee here: ### Recommended Fonts - **Interface**: [Overpass](https://fonts.google.com/specimen/Overpass) - **Text**: [Rubik](https://fonts.google.com/specimen/Rubik) - **Headings**: [Noto Serif](https://fonts.google.com/noto/specimen/Noto+Serif) ### Special thanks to: - [Paul Ryley](https://github.com/pryley) for countless contributions to the theme and amazing sense of design in general. - [Chuck Harmston](https://github.com/chuckharmston) for his amazing alternate tabs snippet. - [melnhh](https://github.com/melnhh) and Lunairee for their amazing colorschemes. - [EdualcLaiv](https://github.com/EdualcLaiv) for porting Royal Velvet to AnuPpuccin. - [xotea](https://github.com/xotea) for theming framework tweaks. - [raisabelatrix](https://github.com/raisabelatrix) for [rainbow tags](https://gist.github.com/raisabelatrix/eb383f7e19b59f951430c2f3c6ed80b0) variables. ## Credits and Acknowledgements - [@kepano's](https://github.com/kepano) [Minimal](https://github.com/kepano/obsidian-minimal) for the inspiration for [colorful frames](https://github.com/AnubisNekhet/AnuPpuccin/blob/main/src/modules/Features/colorful-frame.scss) and partial inspiration for style settings menus design, as well as style settings for the Minimal Cards snippet - [@ceciliamay's](https://github.com/ceciliamay) [Primary](https://github.com/ceciliamay/obsidianmd-theme-primary) for inspiration for [custom checkboxes](https://github.com/AnubisNekhet/AnuPpuccin/blob/main/src/modules/Features/custom-checkboxes.scss) and [floating vault title](https://github.com/AnubisNekhet/AnuPpuccin/blob/main/src/modules/Features/floating-title.scss) - [@SlRvb](https://github.com/SlRvb) for [ITS](https://github.com/SlRvb/Obsidian--ITS-Theme) frontmatter styling inspiration. - [@Akifyss](https://github.com/Akifyss) for their [border theme](https://github.com/Akifyss/obsidian-border) layout design.