Adding Icons to your Home Screen

Automatic Add

When you create a Lite App within Hermit, it will attempt to add the icon to your home screen automatically. (You can turn this off in Settings if you want to.)

Automatic Add works on many launchers, but not all. Hermit follows the Android API correctly, and if Automatic Add does not work on your phone, please contact the developer of your launcher app and report this bug.


If Automatic Add does not work on your phone, you can add the icon manually.

  1. After adding a Lite App in Hermit, go back to your home screen.
  2. Touch an empty area and hold it (long-click).
  3. Press the “Widgets” button to add a new widget.
  4. Scroll down and pick “Hermit > Create a Lite App” from that list.
  5. From the list that appears, pick the Lite App you want to create a Lite App for.
  6. Boom, good-looking icon on your home screen!

Custom App Icons with Hermit

Use your own icons in Hermit!

  1. Launch your Hermit Lite App.
  2. Swipe in from the right edge to reveal the “Quick Settings” sidebar.
  3. In the Quick Settings list, scroll all the way to the bottom.
  4. Tap on the “More Customization” button.
  5. Under “Theme”, find the current icon, and tap on it to change.
  6. Pick an icon and set it as your new icon!

Transparency Issues?

Some photo picker apps (i.e. the external app that is used above to select an icon) do not support transparency. We recommend using Google Photos or a file picker app (instead of a photo picker app) to choose the icon so that it will retain transparent areas of the icon correctly.

Icons on Android O look bad

Android O forces app developers to use the new Shortcuts API, which makes your icons smaller and adds needless Hermit branding to it. We don’t like it either, but we have no choice.

There’s no sugar-coating this; we really liked how icons on your home screen looked before Android O. But we have no say in the matter; to make Hermit work on Android O, we have to go with this new API.

For a wonderfully pretty outcome on Android O, we recommend using the Touch and Hold technique (see above).