Omarchy Theme Hook

A lightweight, clean solution to extending your Omarchy theme to other apps.

Overview

The Omarchy Theme Hook is a lightweight, clean solution to extending your Omarchy theme to other apps. It will check your Omarchy theme for the existence of any extended theme files and will install them automatically for you when a theme is applied. If a theme is applied that contains extended theme files, they will be copied to their proper folders. If the theme does not contain any extended theme files, a new set of each will be generated dynamically using the theme's Alacritty config and copied to their proper folders.

Installing

You can install the theme hook by running the following command:

curl -fsSL https://imbypass.github.io/omarchy-theme-hook/install.sh | bash

Updating

You can update the theme hook by running the following command, or by re-running the installation script:

thctl update

Theme Hook Controller (thctl)

The Theme Hook Controller (thctl) is a command-line tool that allows you to manage your Theme Hook installation. It provides a simple interface for updating the hook as well as toggling hooklettes on and off. You can access it via the terminal by running thctl.

Themed Apps

• Cava
• Cursor
• Discord
• Firefox
• GTK (requires adw-gtk-theme from the AUR)
• QT6
• Spotify
• Steam
• Superfile
• Vicinae
• VS Code
• Waybar
• Windsurf
• Zed
• Zen Browser (experimental - requires manual enabling of legacy userchrome styling)

Uninstalling

You can remove the theme hook by running the following command:

curl -fsSL https://imbypass.github.io/omarchy-theme-hook/uninstall.sh | bash

FAQ

I installed the hook, but none of my apps are theming!

1. The theme hook will generate and install themes, but cannot apply all of them.
2. You may need to manually set the theme to "Omarchy" one time for each app that supports theming.

My Firefox/Zen Browser isn't theming!

• Firefox and Zen Browser may require manual enabling of legacy userchrome styling.
• To do this, open the browser, go to about:config, search for toolkit.legacyUserProfileCustomizations.stylesheets, and set it to true.

My Discord isn't theming!

1. Make sure you are using a third-party Discord client, like Vesktop or Equibop.
2. Apply your desired theme in Omarchy.
3. Enable the Omarchy theme in Discord.

My Spotify isn't theming!

1. Make sure that you properly installed Spicetify, including any permission edits that may need to be made for Linux systems.
2. See a [note for Linux users].
3. Apply your desired theme in Omarchy.

My Spotify stopped theming!

A Spotify client update may have caused Spicetify to stop working. You can fix this either by running spicetify restore backup apply or by reinstalling Spotify and Spicetify, and running spicetify backup apply.

What if I encounter issues?

If you encounter any issues, please open an issue on the GitHub repository.

What theme is shown in the showcase?

Everpuccin. https://github.com/imbypass/omarchy-everpuccin-theme

Will you share your waybar configuration?

It's on GitHub. https://github.com/imbypass/omarchy-waybar-bepi

Contributing

I actively encourage everyone to contribute a theme for their favorite application. If you have a theme for an application, an upgrade to an existing script, or even just feature ideas, please open a pull or a feature request on the GitHub repository. I try my best to review and merge them quickly. As a general rule of thumb, try to keep any templates submitted limited to a single script file.