UI Themer

Your rating: None Average: 4.5 (24 votes)

UI Themer lets customize icons, fonts and pixel density in Sailfish OS.

Read before installing

  • For Sailfish OS 2.1 and above.
  • It requires Theme pack support to be installed.
  • Refresh the homescreen to apply settings.
  • Remember to restore default icons and fonts before performing a system upgrade.
  • For Sailfish X users: changing device pixel ratio needs testing.
  • The option 'Download themes' requires Storeman to be installed.
  • The overlay feature needs ImageMagick to be installed. You can install it via the first run wizard (you can start it from the Tools page pulley menu.

UI Themer


  • Icon theming.
  • Icon overlay.
  • Font theming.
  • Change device pixel ratio.
  • Change DPI for Alien Dalvik.
  • Change icon size.
  • Recovery tools.

Create custom theme packs

Documentation on how to create theme packs available here.


Languages supported:

Request a new language or contribute to existing languages on the Transifex project page.

Usage guide

A usage guide is available here.


Roadmap and features will be tracked on the Trello dashboard.


Thanks to Dax89 and luca247 for support and patience!


If you like my work, please consider to donate via PayPal.

Application versions: 
File sailfishos-uithemer-1.3.0-25.armv7hl.rpm132.23 KB01/12/2018 - 21:02
File sailfishos-uithemer-1.3.0-25.i486.rpm135.82 KB01/12/2018 - 21:02
File sailfishos-uithemer-1.3.1-1.armv7hl.rpm135.03 KB04/12/2018 - 15:14
File sailfishos-uithemer-1.3.1-1.i486.rpm138.79 KB04/12/2018 - 15:14
File sailfishos-uithemer-1.3.2-4.armv7hl.rpm133.64 KB07/12/2018 - 19:33
File sailfishos-uithemer-1.3.2-4.i486.rpm137.36 KB07/12/2018 - 19:33
File sailfishos-uithemer-1.3.3-6.armv7hl.rpm134.42 KB10/12/2018 - 18:17
File sailfishos-uithemer-1.3.3-6.i486.rpm138.04 KB10/12/2018 - 18:17
File sailfishos-uithemer-1.3.3-9.armv7hl.rpm134.46 KB12/12/2018 - 21:58
File sailfishos-uithemer-1.3.3-9.i486.rpm138.05 KB12/12/2018 - 21:58
File sailfishos-uithemer-1.3.3-10.armv7hl.rpm134.45 KB12/12/2018 - 22:04
File sailfishos-uithemer-1.3.3-10.i486.rpm138.07 KB12/12/2018 - 22:04

* Sun Dec 9 2018 1.3.3
- Added cover action to reapply current icons.

* Tue Dec 4 2018 1.3.2
- Added keyboard navigation.

* Tue Dec 4 2018 1.3.1
- Restore page redesigned.
- Dockbar redesigned.
- Updated translations.



DameCENO's picture

Just did, rebooted the device just to be sure.
Without UI themer and with version 4.0 installed the command returns the same output, while with version 2.0 the ui config.tx file is missing, only the screen-rotation.txt file is present at that path.
I think the issue has to be in the ui config.txt file, am no programmer just an educated guess.
Any other way I can assist? The patch is here on openrepos for testing purposes anyway

fravaccaro's picture

Ok, with no UI themer installed, do as root:
touch /etc/dconf/db/vendor.d/locks/ui-configs.txt
dconf update

then, as nemo:

dconf reset /desktop/sailfish/silica/theme_pixel_ratio

And try uninstalling 0.4 again.

DameCENO's picture

Great!!! Worked and fixed the slider issue in UI Themer!
But unlike before, the UI Themer no longer installs the 3 patches in patch manager, I guess I need to reinstall Tablet UI then...
Let me do that and report back

Worked just as expected, everything is back to normal with the settings icon gone in events view screen, thanks for the assistance, greatly appreciated just as every other single contribution you have made to Sailfish, you are appreciated

fravaccaro's picture

Thanks! I'm glad people like and use what I do, so I try to be as helpful as I can if there's any issue :)

fravaccaro's picture

Great! The patches have been taken apart indeed, as I'm working on the UI themer and it helps me to keep stuff tidy :)

fravaccaro's picture

To prevent conflicts Tablet UI patches don't install if there's UI themer 0.2 installed.  Unluckily I don't have a working Jolla 1, but people who tried UI themer 0.4 reported no issue with the slider (and I've not done anything to it apart from splitting packages, indeed)

alina's picture

I couldn't find what blocks brightness/volume sliders from displaying in the sidebar. Seems it's hard coded. Do you know any way to have them in the sidebar?

alina's picture

Since the sidebar patch is due to be used on the phone, I have some suggestions to fit better on Jolla phone:


line 62: leftMargin: Theme.paddingSmall
line 64: rightMargin: Theme.paddingMedium
line 71: height: item.height + Theme.paddingLarge

The margin changes will not affect large screens since the icons are center-aligned.

With two-column layout it will be better on JP1: FavoriteSettingsLoader.qml line 19:
property int columns: isLandscape ? 3 : 2

From left to right: (1) original design, (2) reduced margins, (3) suggested two columns in portrait

Comparing original sidebar margins with suggested changes

fravaccaro's picture

Looks neat, thanks :)

On the brightness slider: even the tablet has this feature missing, so I guess it was not coded at all for the sidebar. Digging a bit in the 'regular' quick panel may reveal the right piece of code to use.

alina's picture

Oh, so I consider this as a bug, since you choose them in settings shortcuts and they're displayed nowhere.

Edit: Albeit this seems logical, because the Silica slider has the left and right margins of Math.round(Screen.width/8).

alina's picture

Ha ha ha! I love Jolla! There's a variable to enable the sliders in quick settings. Just adding "showListFavorites: true" in favoriteSettingsLoader block, i.e. in line 73, will feature the sliders. See the screenshot – I have reduced the slider margins just for testing.

Edit: Ok, this is the workaround: After adding "showListFavorites: true" in "/usr/share/lipstick-jolla-home-qt5/eventsview/EventsViewSidebar.qml", line 73, you should replace Slider margins in "/usr/lib/qt5/qml/Sailfish/Silica/Slider.qml", lines 52, 53, with "Math.round(parent.width/8)"
This will reduce slider margins in sidebar while keeping them the same in other places.

fravaccaro's picture

Great! Thank you (again :D ) As a side note, it works even on the Jolla Tablet and it shows the volume slider, too.

Once I end the rest of the UI (I'm working on integrating the theme pack support), I'll release the sources :)

DameCENO's picture

Very useful patch as always, thanks @fravaccaro

kuba77's picture

On Nexus 4 with SFOS I get dependency error when installing:

nothing provides sailfish-content-graphics-jolla-z1.0

fravaccaro's picture

Thanks for the feedback. May you try out the new release?

kuba77's picture

New release works great :-) Thanks

malibu's picture

Excellent ! Thanks a lot for that !

Is there a way to remove the settings shortcut in eventsview now ?

fravaccaro's picture

I'm pretty sure there is one, just I don't know how :) Ancelad, as he already coded the Events view control, may know the answer, tho.

Ancelad's picture

You can use my code for free :)

fravaccaro's picture

Well, thanks, but I'm not that sure I know where to look at :D There's a reference for the settings icon in the sidebar qml, but hiding it makes the whole sidebar disappear.