# Welcome to the Arcticons Knowledge base

A place to find answers to your Arcticons related questions!

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td>FAQ</td><td><a href="/pages/v6uneHK2Sn949qt6xcvR">/pages/v6uneHK2Sn949qt6xcvR</a></td><td></td><td><a href="/files/rZfwiSLmAVJBHUsEdout">/files/rZfwiSLmAVJBHUsEdout</a></td></tr><tr><td>Troubleshooting</td><td><a href="/pages/LmeGmp7LbSAbHwG7tyWE">/pages/LmeGmp7LbSAbHwG7tyWE</a></td><td></td><td><a href="/files/dktQmATCUktm9GhfT0yB">/files/dktQmATCUktm9GhfT0yB</a></td></tr><tr><td>Icon Requests</td><td><a href="/pages/6WXAkgw2aVV5TWor6kUv">/pages/6WXAkgw2aVV5TWor6kUv</a></td><td></td><td><a href="/files/nwWET1Ipt0ECnkQUeXYx">/files/nwWET1Ipt0ECnkQUeXYx</a></td></tr><tr><td>Contribute</td><td><a href="/pages/qcukGS71PA9b7xyzf6RL">/pages/qcukGS71PA9b7xyzf6RL</a></td><td></td><td><a href="/files/5KGY1mmqKC6jqtdr3qG6">/files/5KGY1mmqKC6jqtdr3qG6</a></td></tr><tr><td>Feedback &#x26; Suggestions</td><td><a href="/pages/6gasjRTYPTy1GscS22VO">/pages/6gasjRTYPTy1GscS22VO</a></td><td></td><td><a href="/files/4F0MysgAkHcaeVOYMjyr">/files/4F0MysgAkHcaeVOYMjyr</a></td></tr><tr><td>Donate</td><td><a href="/pages/FOv5gsPA5JFwNYEOb09L">/pages/FOv5gsPA5JFwNYEOb09L</a></td><td></td><td><a href="/files/Ued1yxjv0jjhOk0SJl5d">/files/Ued1yxjv0jjhOk0SJl5d</a></td></tr></tbody></table>


# FAQ

## How do I use Arcticons

You'll need a launcher that supports custom icon packs to start with. Supported launchers are listed here:

{% content-ref url="/pages/2lPRdHEr7UuwWICqYbbG" %}
[Supported Launchers](/faq/supported-launchers)
{% endcontent-ref %}

You can also watch the two-minute tutorial on how to create a minimal home screen:

{% embed url="<https://youtu.be/KEBlCKulQp8>" %}

## How do I apply Arcticons

There are two ways of applying Arcticons. In the app, you can press the “Apply” button. It will automatically detect the launcher you're using and apply the icons to it.

Alternatively, you can apply the icon pack in the Launcher's setting as well.

## My launcher isn't included in the apply section

Not every launcher supports direct apply, and some of them can't be accessed directly from the app. You can apply Arcticons manually in the individual launcher settings.

## Material You colors

To utilize Material You colors, you must own a device running Android 12\* or higher. In addition to that, you also require a launcher that supports it.&#x20;

See the [supported launchers](/faq/supported-launchers) section.

{% hint style="info" %}
*Material icons generally require Android 12 although some launchers may allow for dynamic icons to work for pre-Android 12 devices.*
{% endhint %}

## How do I change my Material You color palette?

This is the same for most modern phones. Go to your *system's settings → Wallpaper and style → Color palette.* There can you find some different color options, and the option to use your wallpaper colors.

Some launchers (like [Kvaesitso](https://github.com/MM2-0/Kvaesitso)) do offer further customization of the colors to get the exact look that you want.&#x20;

## How can I replace icons with an alternate icon?

It depends on which launcher you're using. Not every launcher supports icon editing. With most launchers, you can edit an icon by tapping & holding the icon or double tapping it. Then click on the icon again. You will get a popup letting you choose a source, select Arcticons, scroll through the list or click on the open in-app button in the top-right corner.&#x20;

## Is there an Arcticons version that switches between dark & light mode?

Yes. Check out [Arcticons Day & Night!](https://arcticons-team.github.io/Arcticons/#daynight) It's not available on Google Play due to their repetitive app policy.

## Can you make a custom color option inside Arcticons?

No. due to the limitations of Android, we're unable to change the appearance of colors with a button click. However, some launchers allow for the user to override the color.&#x20;

Alternatively, you can use [Icon Pack Studio](https://www.iconpackstudio.com/) to alter the icons' appearance.&#x20;

## Does Arcticons offer autogenerated icons for missing ones?

No. Arcticons only has handcrafted icons for the best quality possible. However, if you do want autogenerated icons for the missing ones, you can take a look at [Iconeration](https://f-droid.org/packages/com.kaanelloed.iconeration/).

## What are dynamic calendar icons?

Dynamic calendar icons are icons that change depending on what day it is. Many launchers do support this feature, check the [Supported Launchers ](/faq/supported-launchers)page to see which.&#x20;

## Why are Read & Write External Storage permissions required?

It's used to write & read cache, and collect the icon request data.

## Why is the Set Alarm permission required?

It's used to launch the clock app from the clock widgets.

## Can't find what you're looking for?

Get in touch! → <hello@arcticons.com>


# Icon Requests

With every release, you'll be able to request some missing icons that aren't included yet in Arcticons.

The most requested icons can be found on our [Request Dashboard](https://www.arcticons.com/dashboard/requests).

## Regular requests

These requests are free for everyone. But have a little chance to get made because of the huge numbers of requests.

You can request icons with our in-app tool:

1. Open Arcticons
2. Press the symbol in the upper-left corner and select `Icon Request`
3. Choose the missing apps you wish to submit, it's also possible to select/deselect all missing apps
4. Press the plane symbol and choose the app in the pop-up menu to send the icon request
5. Now you can check the information that will be sent via email, and if everything looks fine, simply send the email, and it's done!

In case you accidentally close the app during the process, and want to clean the cache, there is an option named `Clear Icon Request Data` in `Settings` to do that.

## Priority requests

If you want to see your icons within the next release cycle, you can buy requests via [Ko-Fi](https://Ko-fi.com/donno_), with this your icon will be the first one in the queue.


# Supported Launchers

## Icon Pack Launcher compatibility

This page gives you an overview of what Android launchers and apps support Arcticons (and other icon packs).&#x20;

Some launchers have more icon pack options than others, Arcticons Material You and Day & Night use newer Android features that are not supported by every launcher, for example.

If the launcher that you're using doesn't work with Arcticons (or other icon packs), that's a launcher issue. We'd suggest leaving feedback to the launcher developers instead of us.

## Launchers

The list is a **work in progress**, feel free to let me know if I missed something or if it isn't correct [here](https://github.com/Arcticons-Team/Arcticons/issues/1874).

🟩 = **Supported**\
🟥 = **Unsupported**\
⚙️ = **Reapply** You need to reapply the icon pack in the launchers settings.\
🕜 = **Delayed** You will need to wait a bit.\
⚠️ = **Old launcher** Can't test because it's made for an older Android version, it's paywalled or something else.

<table><thead><tr><th width="112">App</th><th>Icon Pack support</th><th>Material You</th><th>XML support (D&#x26;N)</th><th>Theme switching (D&#x26;N)</th><th>Theme switching (You)</th><th>Dynamic calendar</th></tr></thead><tbody><tr><td><a href="https://play.google.com/store/apps/details?id=ginlemon.flowerfree"><strong>Smart</strong></a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://github.com/LawnchairLauncher/lawnchair/releases"><strong>Lawnchair (alpha)</strong></a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://f-droid.org/en/packages/fr.neamar.kiss/"><strong>KISS</strong></a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=projekt.launcher">Hyperion</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.teslacoilsw.launcher">Nova</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://f-droid.org/en/packages/rocks.tbog.tblauncher/">TinyBit</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://android.izzysoft.de/repo/apk/de.monocles.launcher">Monocles</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://lamd.es/:ion-launcher">Ion</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td></tr><tr><td><a href="https://android.izzysoft.de/repo/apk/de.mm20.launcher2.release"><strong>Kvaesitso</strong></a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>🟩²</td><td>🟩</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=bitpit.launcher"><strong>Niagara</strong></a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=juniojsv.minimum">Minimum</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.mi.android.go.globallauncher">Mint</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=ru.execbit.aiolauncher">AIO</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩¹</td><td>🟩</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.stario.launcher">Stario</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟩</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.ss.squarehome2">Square</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>🟩</td><td></td></tr><tr><td><a href="https://android.izzysoft.de/repo/apk/com.saggitt.omega">Neo</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td>🟩</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=org.n277.lynxlauncher">Lynx</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.pearlauncher.pearlauncher">Pear</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.nu.launcher">Newer</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.ss.launcher2">Total</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://f-droid.org/de/packages/com.vincent_falzon.discreetlauncher/">Discreet</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.transsion.XOSLauncher">XOS</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.transsion.hilauncher">Hios</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.shouter.widelauncher">Wide</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.atomicadd.tinylauncher">Mini Desktop</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://apt.izzysoft.de/fdroid/index/apk/dev.mslalith.focuslauncher">Focus</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://f-droid.org/en/packages/de.markusfisch.android.pielauncher/">Pie</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.nothing.launcher">Nothing</a></td><td>🟩</td><td>🟩</td><td>🟩</td><td>⚙️</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.mi.android.globallauncher">Poco</a></td><td>🟩</td><td></td><td>🟩</td><td></td><td></td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.gau.go.launcherex">Go Ex</a></td><td>🟩</td><td></td><td>🟩</td><td></td><td></td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.actionlauncher.playstore">Action</a></td><td>🟩</td><td>🟩</td><td>🟥</td><td>🟥</td><td>⚙️</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.microsoft.launcher">Microsoft</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.beforesoft.launcher">Before</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.powerpoint45.launcher">Lucid</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=nickrout.lenslauncher">Lens</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details/Launcher_iOS_16?id=com.babydola.launcherios">Launcher O</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.newlook.launcher">Newlook</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.atlantis.launcher">DNA</a></td><td>🟩</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td></td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.telenav.launcher">Vivid</a></td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=app.pinya.lime">Lime</a></td><td>🟩 paywalled</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=apptech.arc">Arc</a></td><td>🟩 paywalled</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.bllocosn">Ratio</a></td><td>🟩 paywalled</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.qqlabs.minimalistlauncher">Minimalist phone</a></td><td>⚠️paywalled</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=shubh.ruthless">Ruthless</a></td><td>⚠️ old</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=jp.co.a_tm.android.launcher">+Home</a></td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td><td>⚠️</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.aurhe.ap15">Ap15</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td>LineageOS</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td>GrapheneOS</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td>K</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.artarmin.launcher">ABC</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td>Simple/<a href="https://github.com/FossifyOrg/Launcher">Fossify</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://github.com/jspw/Ubuntu-Launcher">Ubuntu</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://github.com/oxters168/OxShell/">Ox Shell</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://play.google.com/store/apps/details?id=com.victorygroup.launcher">V</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr><tr><td><a href="https://f-droid.org/en/packages/peterfajdiga.fastdraw/">Fast Draw</a></td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td><td>🟥</td></tr></tbody></table>

¹  **AIO:** In order for theme switching to work, you must enable the *Monochrome icons* option.

² **Kvaesitso:** Material You icons only work with the settings *Themed icons* and *Enforce themed icons* enabled.

***

### Supported Apps

➖ = not yet tested/confirmed \
✖️ = further testing not planned | Feedback wanted

| App                                                                                                          | Icon Pack support | Material You | XML support (D\&N) | Theme switching (D\&N) | Theme switching (You) |
| ------------------------------------------------------------------------------------------------------------ | ----------------- | ------------ | ------------------ | ---------------------- | --------------------- |
| [Appbar](https://play.google.com/store/apps/details?id=rk.android.app.appbar)                                | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Pixel Launcher (Mods)](https://github.com/KieronQuinn/PixelLauncherMods)                                    | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Icon Request](https://github.com/Kaiserdragon2/IconRequest)                                                 | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Icon Pack Studio](https://play.google.com/store/apps/details?id=ginlemon.iconpackstudio)                    | 🟩                | 🟩           | 🟩                 | 🟥                     | 🟥                    |
| [Big Icons - Live Tiles](https://play.google.com/store/apps/details?id=rk.android.app.bigicons)              | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Notification Shortcuts](https://play.google.com/store/apps/details?id=rk.android.app.notificationshortcuts) | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Taskbar](https://github.com/farmerbb/Taskbar)                                                               | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [MicoPacks](https://github.com/ukanth/micopacks)                                                             | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Folder in Folder](https://play.google.com/store/apps/details?id=com.ss.folderinfolder)                      | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Popup Launcher](https://play.google.com/store/apps/details?id=com.ss.popuplauncher)                         | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [Popup Widget](https://play.google.com/store/apps/details?id=com.ss.popupWidget)                             | 🟩                | 🟩           | 🟩                 | ➖                      | ➖                     |
| [MIUI-ify](https://play.google.com/store/apps/details?id=com.tombayley.miui)                                 | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Tile Shortcuts](https://play.google.com/store/apps/details?id=com.tombayley.tileshortcuts)                  | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Bottom Quick Settings](https://play.google.com/store/apps/details?id=com.tombayley.bottomquicksettings)     | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Smart Dock](https://github.com/axel358/smartdock)                                                           | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Sesame](https://play.google.com/store/apps/details?id=ninja.sesame.app.edge)                                | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Folder Widget](https://play.google.com/store/apps/details?id=pub.hanks.appfolderwidget)                     | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Jina Drawer](https://play.google.com/store/apps/details?id=com.mobeedom.android.jinaFS)                     | 🟩                | ➖            | ➖                  | ➖                      | ➖                     |
| [Shortcut Maker - Pin Shortcuts](https://play.google.com/store/apps/details?id=com.bhanu.pinshortcutsfree)   | 🟩                | ✖️           | ✖️                 | ✖️                     | ✖️                    |
| [X Icon Changer](https://play.google.com/store/apps/details?id=io.hexman.xiconchanger)                       | 🟩                | ✖️           | ✖️                 | ✖️                     | ✖️                    |
| [Icon Packer](https://play.google.com/store/apps/details?id=cn.ommiao.iconpacker)                            | 🟩                | 🟥           | 🟥                 | 🟥                     | 🟥                    |
| [Hail](https://github.com/aistra0528/Hail)                                                                   | 🟩                | 🟥           | 🟥                 | 🟥                     | 🟥                    |
| Pixel Launcher (Stock)                                                                                       | 🟥                | 🟥           | 🟥                 | 🟥                     | 🟥                    |
| [App-(Launcher/Drawer)](https://github.com/FossifyOrg/App-Launcher)                                          | 🟥                | 🟥           | 🟥                 | 🟥                     | 🟥                    |
| [Blue Line Console](https://github.com/nhirokinet/bluelineconsole)                                           | 🟥                | 🟥           | 🟥                 | 🟥                     | 🟥                    |


# Donate

Providing a free icon-pack for everyone can cost a lot of time and effort. So if you like our work, consider donating!

* [Liberapay](https://liberapay.com/Donno/donate) (Team project)
* [Ko-Fi](https://ko-fi.com/donno_) (Priority requests)


# Feedback & Suggestions

You are free to suggest a new feature over at our [GitHub page](https://github.com/Arcticons-Team/Arcticons/discussions/new?category=ideas), we're always happy to see where we can improve.

If you have specific questions, you can ask our [Matrix-community](https://matrix.to/#/#arcticons-central:matrix.org) or mail at <hello@arcticons.com>, we'll try our best to answer your questions there!


# Troubleshooting

Answers to common errors you may experience while using Arcticons.

## Shuffled icons on an Oppo/ ColorOS phone

There's this weird bug that shuffles all your icons when using icon packs in combination with a ColorOS phone. Follow these steps to fix it:

1. Open Settings
2. Navigate to 'App management'
3. Navigate to 'App list', search and select 'System Launcher'
4. Select 'Storage usage'
5. Press on 'Clear cache'

## Samsung One UI

To use Arcticons (and other icon packs) on your Samsung device you have to install the Theme Park companion app from the Galaxy Store.

Inside the Theme Park app:

1. Tap "Icon"
2. Tap "Create New"
3. Tap the blue "Iconpack" button
4. Choose Arcticons from the list

Repeat these steps each time you update Arcticons (or install a new app), new icons won't be mapped automatically.

## Material You colors aren't updating

Colors might not update when you change your wallpaper or switch to dark mode. This is something that your launcher controls and changes. Most of them handle it differently, sometimes you might have to reapply the icon pack in order for it to work. Check the [Supported Launchers ](/faq/supported-launchers)to see more details.

## Manually selected icons don't follow the Material You color schemes

This is because most launchers create a static image from the icon when you select it. Sadly, there's nothing we can't do about it. So, we suggest letting the launcher developers know that you want this feature.&#x20;

## Calendar icons aren't working

This is because your launcher (probably Microsoft or Open Launcher) doesn't support dynamic calendar icons. Check the [Supported Launchers ](/faq/supported-launchers)page for alternatives.

## Clock widget doesn't open clock app

This happens in old versions of the app, so make sure to update to the latest possible version.

## Icons appearing blank on Lineage 18

This is a still unfixed bug from LineageOS. There's sadly nothing to do about it besides switching to a different launcher. Check the [Supported Launchers ](/faq/supported-launchers)page for alternatives.

## Graphene OS, LineageOS and other stock launchers

Graphene OS doesn't have any support for Arcticons or other icon packs out of the box. We can't do anything about that, and we suggest leaving feedback to the developers of the project instead. \
Check the [Supported Launchers ](/faq/supported-launchers)page for alternatives.

## Is there a difference between the Google Play version and others?

Yes. Due to Google's policies, we aren't allowed to have an explicit donate button that links to other sites. The releases from F-Droid, Accrescent & GitHub do have donate buttons.

## Can't find what you're looking for?

Get in touch! → <hello@arcticons.com>


# Contribute

## GitHub guide

Uploading your work to GitHub might sound tricky, so here's a small guide

{% content-ref url="/pages/qoCxGfdDDfSAnlgVLhp2" %}
[GitHub guide](/contribute/github-guide)
{% endcontent-ref %}

## The Arcticons style

Icons have to look consistent, so we have a basic set of principles

{% content-ref url="/pages/t9ydcPxkuNLU6GyD0X2v" %}
[Creating icons](/contribute/creating-icons)
{% endcontent-ref %}

## Vector editor guides

You can create icons with the vector edit software of your choosing.

{% content-ref url="/pages/eTCJtEdsBDWizDlauob4" %}
[Vector editing software](/contribute/vector-editing-software)
{% endcontent-ref %}

## Contribute without designing or coding

You can even help out without any knowledge of designing or coding, check out how here.

{% content-ref url="/pages/QTEdxQtWXtNVJqQHPLD8" %}
[Updating existing apps](/contribute/updating-existing-apps)
{% endcontent-ref %}

{% content-ref url="/pages/yaTAmO9PfD193Rw4yoLk" %}
[Categorize icons](/contribute/categorize-icons)
{% endcontent-ref %}

{% content-ref url="/spaces/2RrVVBRQ3dxPE4yo9gYS/pages/XPFoeHXxHxJS78gNClU5" %}
[Building the app yourself](/contribute/building-the-app-yourself)
{% endcontent-ref %}


# GitHub guide

## Forking Arcticons

* Go to the GitHub page <https://github.com/Arcticons-Team/Arcticons/> in a browser.
* In the top-right corner, click the **Fork** button. You'll get your very own clone of Arcticons! (You need a GitHub account for this).

I'd recommend using [GitHub Desktop ](https://github.com/apps/desktop)to make Git less difficult.

* Download & Install GitHub Desktop, and login with your credentials
* Click on `Add > Clone repository` and select your Arcticons repo. This will create a folder with the Arcticons project.

Now you have your local Arcticons project. This means you can add icons and edit the appfilter.

## Adding your icons

After having your icons created, you can export them as SVG files to the `/newicons` directory.

In this folder, you'll also see a file named `appfilter.xml` To tie the icon to the app, you will need to add some lines of code to this file. These lines of code can be gathered with [Icon Request](https://play.google.com/store/apps/details?id=de.kaiserdragon.iconrequest).

1. Download [Icon Request](https://play.google.com/store/apps/details?id=de.kaiserdragon.iconrequest) on your phone
2. In the app, tap *update existing***.**
3. Select Arcticons when asked to choose an icon pack.
4. Select the apps that you want to add.
5. Tap the share icon in the top-right corner and send it to yourself.

Now you can add these lines to the appfilter. You don't have to worry about putting everything in alphabetical order, just paste it somewhere. It gets sorted automatically with every release.

## Uploading to GitHub

Now, when you open your GitHub Desktop window, you'll see a summary of the changes that you've made.&#x20;

1. Give your commit a small summary.
2. Press the Current branch button, then create a new branch. Give it a name and press Create.
3. Publish your branch and commit the changes.
4. Now you can create a pull request by pressing the button. This will open the GitHub site again.
5. Create your pull request and you're done!

There you go, now all you have to do is wait for it to be merged into the app.

***

Alternatively, you can also do it all in your browser:

## Uploading in Browser

* Go to the GitHub page <https://github.com/Arcticons-Team/Arcticons/> in a browser.
* In the top-right corner, click the **Fork** button. You'll get your very own clone of Arcticons! (You need a GitHub account for this).
* Once in your fork, click "newicons" directory.
* Click "Add file" > Upload files > choose your files.
* Select your masterpiece(s) and commit changes (you can add a commit message if you want).
* There will be a dialog "… is 1 commit ahead of Arcticons-Team/Arcticons:main".
* Click "Contribute" > "Open pull request".
* Type the pull-request message (e.g., name of the icons).
* Click "create pull request".

There you go! Just wait for your changes to be merged into the app, and be happy, you are a contributor!


# Creating icons

## The Arcticons style

When creating icons, there are three key points to test your design to:

* **Recognizable**: There needs to be a clear link with the app, such as the word mark or logo.
* **Minimalistic**: Try using as fewer lines as possible, resulting in an easy-to-read icon.
* **Elegant**: Strive for the best-looking design you can make with the source material that you're working with. This is a bit of a personal preference, but make adjustments when necessary to keep your design clean.&#x20;

## Basic principles

* The size of your document should always be **48×48 px**.
* Every line has a stroke thickness of **1 px** and the color should always be #ffffff (white).
* Dots are **1,5×1,5 px** and have a fill (and no stroke) that should also be white.
* The maximum size of your icon should fit into the template circle icon (43×43 px).
  * Square-like icons should fit into the square template (37×37 px).
  * Rectangular icons should fit into the rectangle templates (31×39 px).

<figure><img src="/files/OeeZ7kBpWdaDQTWTq2UZ" alt="" width="563"><figcaption></figcaption></figure>

* We have created our own font for Arcticons icons, all letters, numbers and other glyphs have to use it for consistency.

{% hint style="info" %}
You can find the font as an SVG file inside the template folder.
{% endhint %}

* All lines should have **rounded caps** & **rounded corners**.

<figure><img src="/files/i16ib5qUEvslo8kxsvnw" alt="" width="563"><figcaption></figcaption></figure>

* Try to keep icons as simple as possible, unnecessary lines make icons harder to read.&#x20;

<figure><img src="/files/RH5B38hloHZJu4zIPa9w" alt="" width="563"><figcaption></figcaption></figure>

## Exporting & making them work

Export your icons as SVG files.

Make sure to remove the reference image before exporting.

We don't accept icons that are rastered (PNG, WebP), are too cluttered or don't follow the basic principles.&#x20;

## Start creating

{% content-ref url="/pages/eTCJtEdsBDWizDlauob4" %}
[Vector editing software](/contribute/vector-editing-software)
{% endcontent-ref %}

## Uploading to GitHub.

{% content-ref url="/pages/qoCxGfdDDfSAnlgVLhp2" %}
[GitHub guide](/contribute/github-guide)
{% endcontent-ref %}


# Credit Yourself

Give yourself an entry at the bottom of `generated/contributors.xml` to be included in the credits!

Just add this before the `</resources>` tag and edit the values

```
<contributor
    name="Contributor Name"
    contribution="Icon Creator."
    image="assets://contributors/yourImageName.png"
    link="https://linktoyourpage" />
```

For the name parameter enter your name or username

For the contribution parameter write what you have contributed (Icon Creator)

For the image you have multiple options&#x20;

* leave it empty `""`
* add a Link to your picture `"https://linktoyourpicture"`
* save your image in `app/src/main/assets/contributors/` and  link to it with `"assets://contributors/'yourImageName.png'"`

For the link parameter you can set the link to your GitHub profile or your website.


# Vector editing software

The easiest way to start is to navigate to the template folder, and use those as a basis.

We've written some guides for different vector editors.

{% content-ref url="/pages/KqvD56f1Un5ZgHgkgL6h" %}
[Inkscape](/contribute/vector-editing-software/inkscape)
{% endcontent-ref %}

{% content-ref url="/pages/i2q6iirokWZ4ojZbco92" %}
[Vector Asset Creator](/contribute/vector-editing-software/vector-asset-creator)
{% endcontent-ref %}


# Inkscape

If you want a great way to get started contributing to this icon pack, here is a simple guide to get started using Inkscape!

### Setting up Inkscape for icon creation

* Install [Inkscape](https://inkscape.org)
* In the navigation menu, go to *File > Document Properties* and set it to look like this: Note the Display Units set to `px`, the width and height set to `48px`, the scale set to `1x`, and the view box set to 48 by 48.

<figure><img src="/files/01UjmSEBX9CXXBTsgrTv" alt="" width="360"><figcaption></figcaption></figure>

* Import a base icon or a template to start with. To do so, just go to *File > Import* and select the file you want. You can also drag and drop any file from your file manager of choice.

## Start drawing

Inkscape comes with countless tools that can help you achieve basically everything you want, this can be an overwhelming number of things to learn. However, thanks to Arcticons simplicity, you only need to know a few tools to get started.

### Using the bezier tool

If you have not changed the Inkscape's shortcuts, pressing the **B** key will let you create straight and curve lines (also called **strokes**), your mouse will change the icon to a little pencil. When using this tool, you can click from point to point, click and drag, or click, click and keep pressed. You can also press **Control** while dragging the mouse to stick to certain angles. To **finish** drawing, press **Enter** or join your last node to the first one. You can learn more about this tool on your own.

### Creating shapes

Usually, you will want to make shapes instead of drawing everything by hand, if that's the case, you can use the **E** **R** and **\*** to make Ellipses, rectangles and polygons. These have many options, like corner radius, changing the height or width, but beyond that, they can be a bit limited if you want to modify other aspects. You select it, and click Path > Object to Path. This will make it a normal stroke, and you will be able to work more freely on it.

### Selecting and resizing objects

Occasionally, you will have many objects and strokes on top of each other, you can use **Alt**, **Shift, and** **Control** to modify the behavior of the selection tool, which is accessed by first pressing the **S** key.

### Modifying existing objects

If you want to change the position of a node, you can use the **N** key to be able to edit the path of any object. Remember that if you aim to edit a shape, you have to convert it to an object. If you click once, you can also move the object, but by clicking twice you will be able to rotate the object. Again, using any of the modifier keys can change the behavior of this tool. Feel free to experiment.

<figure><img src="/files/1s5uum1nbGSYxkzpVrq9" alt=""><figcaption></figcaption></figure>

### Align and distribute paths and nodes

You can access this menu by pressing **Control + Shift + A**, and here you will see many options to align your objects in relation to the selected area, the full-page and other reference points.

### Stroke styling

To make your strokes white, just select it, and go to the bottom color bar, hold the Shift key and click the white square. You can click on the X to make the color transparent in case you added a fill color accidentally. You should also make sure the stroke width stays at 1px. Use **Control + Shift + F** to view the *Fill and Stroke* menu and go to *Stroke style* and set the width to 1px. Keep in mind that if you resize and object, you might alter this value.

## Exporting

To export your file, you just have to save by going to *File > Save* or just hitting **Control + S**.

Usually, Inkscape will add a lot of metadata that will get cleaned up by the maintainers, but if you want to get rid of it yourself, you can use a tool like SVGOMG. Or you can also do File > Save as and select Optimized SVG. There are many options you can enable/disable, and you can figure them out on your own., there are many options you can enable/disable, you can figure them out on your own.

## Uploading

Follow the guide on the page below.

{% content-ref url="/pages/qoCxGfdDDfSAnlgVLhp2" %}
[GitHub guide](/contribute/github-guide)
{% endcontent-ref %}


# Vector Asset Creator

So you have decided to contribute to Arcticons, using your Android device. Vector asset creator is one of the easiest ways to create simple vectors.

## Getting started

* Install [Vector Asset Creator](https://play.google.com/store/apps/details?id=com.inglesdivino.vectorassetcreator)
* Set the canvas size to be 48dp by 48dp from the navigation pane

## Begin drawing

* Add a reference image **\[navigation pane > background > image]**
* Add some lines using the “Add stroke” tool from the toolbar at the top. e.g., **\[Add stroke > circle]** You'll notice that the fill color is white, and the stroke color is black.
* Click the fill color tool and slide the fill-opacity slider all the way left, now the fill-color should be transparent.
* Click the stroke color tool **\[More > stroke color]**, and set it to any convenient color. e.g., for contrast.
* Similarly, set stroke width as per convenience.
* Keep adding strokes, and finish the drawing.

## Exporting

* Remove the background image \[navigation > background > clear]
* Click the “Select” tool and select the entire image.
* Click the “Resize” tool and pull the bottom-right corner to resize the icon to fit the canvas perfectly.
* From the navigation pane, select “Export” > SVG > turn off “include background color”
* The icon should be saved at Downloads/Vector Asset Creator/


# Updating existing apps

## The basics

You can help the project without any knowledge of how to create icons or code. Each app and its icon corresponds to a line in a file called the *appfilter.xml*. These lines look like this:

{% code overflow="wrap" %}

```xml
<item component="ComponentInfo{com.donnnno.arcticons/com.donnnno.arcticons.activities.MainActivity}" drawable="arcticons"/>
```

{% endcode %}

The first part tells us which app we're working with:

<mark style="color:red;">`com.donnnno.arcticons`</mark><mark style="color:blue;">`/com.donnnno.arcticons.activities.MainActivity`</mark>

And the last part corresponds to the icons:

<mark style="color:blue;">`drawable="`</mark><mark style="color:red;">`arcticons`</mark><mark style="color:blue;">`"/>`</mark>

We can change the *drawable* name to the name we want, as long as there's an icon for it.

You can find the appfilter file located inside `newicons/appfilter.xml`

## Add possible updates

Knowing the basics, we can add new entries to the appfilter.

Apps change their code constantly, that means that often the link with the icon breaks, that's why there's the [possible updates](https://arcticons.com/dashboard/updatable) tab at our request dashboard.

<figure><img src="/files/Df1hrauBFoIf0vj4NJok" alt=""><figcaption></figcaption></figure>

On your local copy of Arcticons, open the appfilter.xml and search for the package name.

<figure><img src="/files/dRcCXxzpz4Hlh8M5wqFV" alt=""><figcaption></figcaption></figure>

As you can see, the package name is in there, so we can paste our update by pressing the copy button, and pasting it above or below the existing entry.

<figure><img src="/files/IHhGJyq7MBKvDUIPeCkj" alt=""><figcaption></figcaption></figure>

Be sure to change the drawable name so that it's the same as the already existing one, in our case "browser".

### Get the Appfilter code for your app

You want to update an appfilter code for an app installed on your phone and don't  know how to get it.&#x20;

{% content-ref url="/pages/zXdndZH0tcSlcMAV6oCj" %}
[Gather the Appfilter code for an installed App](/contribute/the-iconrequest-app/gather-the-appfilter-code-for-an-installed-app)
{% endcontent-ref %}

## Connect generic apps to existing icons

There are many apps that don't *need* their own icon because they can use a generic one. This gives Arcticons the ability to have support for even more apps.

By searching through our [massive request list](https://arcticons.com/dashboard/requests) for apps that have similar icons to existing ones, you can link them. Below there are examples of what we consider generic apps:

* bible&#x20;
* browser&#x20;
* calendar&#x20;
* camera&#x20;
* chess
* cleaner&#x20;
* clock&#x20;
* contacts&#x20;
* download&#x20;
* gallery&#x20;
* launcher&#x20;
* keyboard&#x20;
* kwgt&#x20;
* mail
* mediaplayer&#x20;
* messages&#x20;
* music&#x20;
* office&#x20;
* phone&#x20;
* quran&#x20;
* sudoku
* vpn&#x20;
* wallpaper&#x20;
* weather

View the GitHub guide on how to add updates to the appfilter:

{% content-ref url="/pages/qoCxGfdDDfSAnlgVLhp2" %}
[GitHub guide](/contribute/github-guide)
{% endcontent-ref %}


# Categorize icons

The in-app categories help people find the icons they need quicker. Some icons are categorized automatically with a prefix in the name like `calendar_` or `folder_`, which works for icons like those. However, to give all names the prefix of games\_ for example, would add an unwanted attribute to the name.

That's why certain categories are curated by hand:

* Games
* System apps&#x20;

You can help by expanding these categories, it's even pretty easy to do, with no coding or creating skills required.

1. The categories are located inside `generated/`, there you will find `games.xml` & `system.xml`.
2. Click on one of the files and then on the edit button.
3. Add the names of the icons to the list (in alphabetical order).&#x20;
   1. You can easily search for icons using our search site.
4. Click commit changes, add a small description and create the pull request.

Please let us know if you would like to see more categories by creating a [GitHub issue](https://github.com/Arcticons-Team/Arcticons/issues/new).


# The IconRequest App

The IconRequest app is a tool to get appfilter codes and app icons extracted.

You can get it here <https://github.com/Kaiserdragon2/IconRequest>.

{% content-ref url="/pages/zXdndZH0tcSlcMAV6oCj" %}
[Gather the Appfilter code for an installed App](/contribute/the-iconrequest-app/gather-the-appfilter-code-for-an-installed-app)
{% endcontent-ref %}

{% content-ref url="/pages/0k1qn8KIltlDNEKNmPxe" %}
[Get Appfilter and Icons](/contribute/the-iconrequest-app/get-appfilter-and-icons)
{% endcontent-ref %}


# Gather the Appfilter code for an installed App

### How to gather the Appfilter code for an App installed on your Phone

Open [IconRequest](/contribute/the-iconrequest-app) and click on "Update Existing" .

<figure><img src="/files/WYpKDEGD2tlhogZ1Mqbf" alt="" width="563"><figcaption><p>IconRequest Main View</p></figcaption></figure>

After that you will be presented with a screen that looks like this.

<figure><img src="/files/1nVVc9gb2o7HPp0ZyhC6" alt="" width="563"><figcaption><p>IconRequest Update Page</p></figcaption></figure>

Select the app that you would like to update the appfilter code. And then click the share button to share it with your preferred app. Or you could click the copy button to have the code copied to your clipboard.(This is helpful if you are asked to post the appfilter code in an Github Issue)


# Get Appfilter and Icons

Open [IconRequest](/contribute/the-iconrequest-app) and Select the "Request New" option.

<figure><img src="/files/WYpKDEGD2tlhogZ1Mqbf" alt="" width="563"><figcaption><p>Icon Request Main</p></figcaption></figure>

After that you will be presented with a screen that looks like this.

<figure><img src="/files/cuQAWhVF8JOWsAbNbuMd" alt="" width="563"><figcaption><p>IconRequest Request New</p></figcaption></figure>

Select the app that you would like to create Icons for. And then click the share button to share it with your preferred app. Or you could click the save button to save the zip file one your device.


# Building the app yourself

## Building the app

**Prerequisites**: Android Studio and python3  installed on your device.

1. Place the created icons in the `/newicons` folder and add the new Component Info codes in the `appfilter.xml`, you can gather it with [icon request](https://github.com/Kaiserdragon2/IconRequest/releases/) (see [Updating existing apps](/contribute/updating-existing-apps)).
2. Change the `versionCode` and `versionName` in the `/app/build.gradle` file.
3. Open the repo in Android Studio. It will take a while to sync/load everything for the first time.
4. Choose the build flavor that you want&#x20;
5. In the top bar on the right side, you will see a dropdown menu next to a green play button.

   <figure><img src="/files/KutqUNQGb1PbImbXJ0D0" alt="" width="297"><figcaption></figcaption></figure>
6. It's important to check for possible errors in your icons or appfilter entries, click on the dropdown menu and click on **RunChecks**. The Build tab at the bottom will show possible entries or icons to fix.
7. In the left sidebar, you will find the build variants button, choose the variant that you want<br>

   <figure><img src="/files/MuWkK95vRoPESawqe3XZ" alt="" width="341"><figcaption><p>Build Variants tab in Android studio</p></figcaption></figure>
8. Click on the dropdown menu and click on **Prepare New Release**, and then the green play button. Wait for the process to finish.
9. Plug your phone and allow USB debugging in your phone's developer settings.
   1. `Settings > About phone > Build number`
10. Click on the dropdown menu and click on **App**, then the green play button to run the app on your phone!
    1. You can also generate an APK file in Android studio:
       * `Toolbar > Build > Make project (the hammer icon)`
         * For a [normal APK](https://developer.android.com/studio/run/): `Toolbar > Build > Build bundle(s)/APK(s) > Build APK(s)`
         * For a [signed APK](https://developer.android.com/studio/publish/app-signing): `Toolbar > Build > Build bundle(s)/APK(s) > Generate signed bundle/APK`

### Choosing your build flavors

The app is built as a debug version (`com.donnnno.arcticons.debug`) by default.

To choose another variant: `Build Variants`(on the left sidebar) `> *Active Build Variant* > select from the menu.`


# Other platforms

Arcticons has some availability on other platforms as well.


# Linux

This is a version of Arcticons for Linux desktop managers like GNOME and KDE. It uses the existing icons made for Android (plus ones made just for desktop), so many applications are already covered.

Join development on [Codeberg](https://codeberg.org/Arcticons/Arcticons-Linux).

{% content-ref url="/pages/N4ueFVCwpqNI73BGYtJT" %}
[Installation](/other-platforms/linux/installation)
{% endcontent-ref %}

{% content-ref url="/pages/Gi49sqXD1nofaz8t5xU9" %}
[Contribute](/other-platforms/linux/contribute)
{% endcontent-ref %}

{% content-ref url="/pages/JfGkRhNTtP7fkeoufcwQ" %}
[Advanced: Generate your own flavour of Arcticons](/other-platforms/linux/advanced-generate-your-own-flavour-of-arcticons)
{% endcontent-ref %}

<figure><img src="/files/qomAivwDd47G9VlHDMXv" alt=""><figcaption></figcaption></figure>


# Installation

## AUR

For Arch-based distributions, Arcticons is available via the [`arcticons-icon-theme`](https://aur.archlinux.org/packages/arcticons-icon-theme) and [`arcticons-icon-theme-git`](https://aur.archlinux.org/packages/arcticons-icon-theme-git) packages on the AUR.

## KDE

1. In **System Settings**, under **Appearance & Style**, go to **Global Theme > Icons**, then click the **Get New…** button.
2. In the pop-up, search for *Arcticons* and install. Close the pop-up.
3. Select the installed icon pack and click **Apply**. Enjoy!

## GNOME

1. Follow manual installation (below).
2. Ensure that **Gnome Tweaks** is installed. Under **Appearance**, in the **Icons** dropdown, select *Arcticons*. Enjoy!
3. To change the icons for Qt applications in GNOME as well, you need [`qt5ct`](https://sourceforge.net/projects/qt5ct/)/[`qt6ct`](https://github.com/trialuser02/qt6ct).

## Manual installation

1. Download the pack either from [openDesktop](https://opendesktop.org/p/2343140) (and extract `arcticons-$VERSION.tar.gz`) or the [`arcticons-light`](https://codeberg.org/Arcticons/Arcticons-Linux/src/branch/main/arcticons-light) and/or [`arcticons-dark`](https://codeberg.org/Arcticons/Arcticons-Linux/src/branch/main/arcticons-dark) folder(s) from Codeberg.
2. Move into `~/.local/share/icons` for a user-wide installation or into `/usr/share/icons` for a system-wide installation.


# Contribute

## Forking the Repository

1. In a web browser, open the [Arcticons-Linux](https://codeberg.org/Arcticons/Arcticons-Linux/) Codeberg repository.
2. You'll need to have a Codeberg account to click the **Fork** button in the top-right corner. You'll get your very own clone of Arcticons-Linux!
3. For simplicity, you probably want to use a Git GUI such as [Desktop Plus](https://desktop-plus.org/) (a fork of GitHub Desktop), [Gittyup](https://murmele.github.io/Gittyup/), or [Gitnuro](https://gitnuro.com/) (all suggestions are open source and cross-platform), though many others should also work.
4. Sync a local version of your fork.

Now you have your local Arcticons-Linux project. This means you can add icons and edit `mappings.yaml`.

## Preparing the codebase

For generating the icons, you may need to do a `git submodule init` followed by `git submodule update` to pull the Arcticons repo, which will be pulled into the `.arcticons` folder.

We are using [uv](https://docs.astral.sh/uv/) for the dependency management of the Python scripts. Run `uv sync --dev` in the Arcticons-Linux repo folder to prepare the environment.

## Contributing your own icons

To contribute icons, which don't fit into the Android icon pack, you can place them into the `icons_linux` folder.

For matching the Arcticons style, you can follow the Android creation guide here:

{% content-ref url="/pages/t9ydcPxkuNLU6GyD0X2v" %}
[Creating icons](/contribute/creating-icons)
{% endcontent-ref %}

You need to export the icon with black lines (stroke color `#000`) inside the `icons_linux` folder.

## Mapping the icons

Under Linux, there is no single nomenclature for the app names, and so the icons are often needed in multiple places to account for different packaging systems etc.

For that, we have a mapping file called `mapping.yaml`, in which the icon names are mapped to different destinations.

Here is an example of a mapping:

```yaml
browser:
  - apps/org.gnome.Epiphany
  - categories/applications-internet
  - categories/applications-network
```

The `browser` icon is mapped to three destinations. To add a new icon, just add the icon name as a new section and then the destination(s) as a list.

You can run `uv run scripts/validate_mapping.py` to validate the mapping file for correct syntax.

### Finding the icons

There are multiple locations for icons on Linux, but there is an icon search script which helps to find mappings.

Run `uv run scripts/icon_search.py <keyword>` to find icons containing the keyword as well as desktop files. This searches the most common places. You can use the parameters `-v` to see from which files the mappings were found, `--no-icons` to only search desktop files and `--no-desktop` to only search icon folders.

One way to find them (on KDE), is by opening the properties for the app.

* The name should match with the name inside the mappings.yaml file.
* The prefix to the name corresponds to the location of the app.

<figure><img src="/files/qwbXVgmkwsIHakWqOqDz" alt="" width="348"><figcaption></figcaption></figure>

## Generating icons

Run `uv run scripts/generate_icons.py -c generate-icons.toml` to generate the icons.

## Necessary information for a PR

### New icons

* You can create a PR as soon as you place the new icons inside the `icons_linux` directory. If you don't want to edit the mapping file, you can just give the mapping in the PR description.
* You can edit the mapping file to include the mappings just at the bottom of the file. While generating the icons, the mapping file will be sorted automatically.
* If you like, you can also generate the icons on your machine to include them in the PR. Be aware that for this to work, you need to have the main Arcticons repo pulled as a submodule; additionally, you need to have [Inkscape](https://inkscape.org/) installed.

### New mappings

* If adding the mapping for an icon which doesn't exist yet in the mapping file, adding it to the bottom of the file is perfectly fine, it will be sorted automatically when generating the icons.
* If adding a mapping to an icon which is already in the file, you can add the mapping to the list. It will be sorted automatically when generating the icons.

## Uploading to Codeberg

Now you'll see a summary of the changes that you've made.&#x20;

1. Give your commit a small summary to describe the work you did.
2. Press the Current branch button, then create a new branch. Give it a name and press Create.
3. Publish your branch and commit the changes.
4. Create a pull request and you're done!

There you go, now all you have to do is wait for it to be merged into the Linux theme.


# Advanced: Generate your own flavour of Arcticons

You can generate your own flavour of Arcticons!

To generate your own flavour of Arcticons, you need your environment prepared as described in [Preparing the codebase](/other-platforms/linux/contribute#preparing-the-codebase)

Afterwards, you need to create a TOML file containing one or more sections like this:

```toml
[arcticons-dark]
name="Arcticons Dark"
comment="A Line-based icon pack. (Version for dark themes)"
inherits="breeze-dark,Adwaita,hicolor"
overwrite=false
archive=false
src_color="#000"
color="#fff"
line_weight=2
src_paths=["icons_linux", ".arcticons/icons/black"]
```

* The section name is the destination folder.
* `name` is the name which will be put into the `index.theme`
* `comment` is the description which will be put into the `index.theme`
* `inherits` is the list of themes, which this theme will inherit (for icons which are not in this theme yet)
* `overwrite` describes whether the destination folder will be deleted or the generator will try to update the icons.
* `archive` describes whether an archive file of the destination folder should be created (Currently not working)
* `src_color` is the color of the source icons (the source icons used by Arcticons-Linux are `#000`)
* `color` is the color which should be applied to the icons. Possible values are all color recognized by CSS/SVG
* `line_weight` is the thickness of the strokes
* `src_paths` describes the paths where the generation script should look for icons, ordered by preference

To generate the icons, run `uv run scripts/generate_icons.py -c <your_toml_file>`


# OnionOS

A version specifically made for handhelds running the OnionOS system, like the Miyoo Mini Plus.

This version is created and maintained by [JoelChrono](https://joelchrono.xyz/).

You can download it on [Itch.io](https://joelchrono.itch.io/arcticons-game-systems-icon-pack), the source code is available on [Codeberg](https://codeberg.org/Arcticons/Arcticons-OnionOS).

<figure><img src="/files/ctvHhclmXmaleF48ko76" alt="" width="480"><figcaption><p>Game Selection Screen - JoelChrono</p></figcaption></figure>


# iPhone

The icons from the Android project with a black rounded square added as a background.

Note: this was an experiment to provide PNGs for anyone who wants it, and doesn't include iOS-specific icons. If you are an iPhone user and are willing to contribute, please contact us!

Available on [Codeberg](https://codeberg.org/Arcticons/Arcticons-iOS).


# Work with Arcticons

{% content-ref url="/spaces/2RrVVBRQ3dxPE4yo9gYS/pages/FJPFTBq2xZ9O3nSKU7hi" %}
[Arcticons for Business](/work-with-arcticons/arcticons-for-business)
{% endcontent-ref %}

{% content-ref url="/pages/Z4yG6oEfvvx48gCLhyUt" %}
[Launcher developers](/work-with-arcticons/launcher-developers)
{% endcontent-ref %}

{% content-ref url="/pages/qcukGS71PA9b7xyzf6RL" %}
[Contribute](/contribute)
{% endcontent-ref %}


# Arcticons for Business

Looking to use Arcticons for business purposes and need tailored icons?

Get in touch! → <hello@arcticons.com>


# Launcher developers

Looking to bundle your launcher with Arcticons?&#x20;

Get in touch! → <hello@arcticons.com>