## Previews
๐ป Latte๐ชด Frappรฉ๐บ Macchiato๐ฟ Mocha
## About
Applies Catppuccin-themed code/file icons to file explorers on the following sites/platforms:
- [GitHub](https://github.com)
- [Gitlab](https://gitlab.com)
- [Gitea](https://gitea.com)
- [Forgejo](https://forgejo.org)
- [Bitbucket](https://bitbucket.org)
- [Tangled](https://tangled.org)
## Usage
### Marketplace
The extension is available on the [Chrome Web Store](https://chromewebstore.google.com/detail/catppuccin-for-web-file-e/lnjaiaapbakfhlbjenjkhffcdpoompki) and through [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/catppuccin-web-file-icons/).
> [!NOTE]
> The Microsoft Edge Add-ons extension store is no longer supported (past v1.5.0). Please switch to the Chrome Web Store instead.
### Manual
See the assets section at the bottom of [the latest release](https://github.com/catppuccin/web-file-explorer-icons/releases/latest) for pre-compiled zips of the extension. The Chrome zip will work for any Chromium browser (Microsoft Edge, Opera, Arc, etc.).
Chrome
1. Unzip the `catppuccin-web-file-explorer-icons--chrome.zip` asset from the latest release.
2. Open the Extensions page by navigating to `chrome://extensions`.
3. Enable Developer Mode (if not already enabled) by flipping the toggle switch labeled **Developer mode**.
4. Click the **Load unpacked** button and select the unzipped directory from Step 1.
Firefox
1. Open the Add-ons page by navigating to `about:addons`.
2. Click the cog/settings icon in line with the "Manage Your Extensions" heading, and select **Debug Add-ons**.
3. Click the **Load Temporary Add-on...** button and select the `catppuccin-web-file-explorer-icons--firefox.zip` asset from the latest release.
## Customization
This extension aims to provide the same configuration options as [catppuccin/vscode-icons](https://github.com/catppuccin/vscode-icons) does. The flavor of icons, custom associations, as well as the `monochrome` & `specificFolders` options, can be customized in the extension's popup window (click the extension icon in your browser toolbar to reveal the popup).
## ๐ FAQ
- Q: **_"How can I enable this extension on a custom domain?"_**\
A: See [fregante.github.io/webext-permission-toggle](https://fregante.github.io/webext-permission-toggle/?name=Catppuccin+for+Web+File+Explorer+Icons&icon=https://raw.githubusercontent.com/catppuccin/web-file-explorer-icons/main/src/assets/icon.png).
## Contributing
See [the contributing guide](./CONTRIBUTING.md).
## ๐ Thanks to
- [uncenter](https://github.com/uncenter)
- [material-extensions/material-icons-browser-extension](https://github.com/material-extensions/material-icons-browser-extension)