UI Themer

Your rating: None Average: 4.7 (41 votes)

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

Read before installing

  • For Sailfish OS 2.1.4 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.
  • Easy mode GUI enabled by default. If you want more control, disable it via the Options page.

UI Themer


  • Icon theming.
  • Icon overlay.
  • Font theming.
  • Sound 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.


  • Partially based on Icon pack support GUI
  • App icon by Free Vectors.
  • Keyboard navigation based on Piepmatz by Sebastian Wolf.
  • Thanks to Dax89 for helping with C++ and QML code, this app would not exist without him.
  • Thanks to Eugenio_g7 for helping with the One-click restore service.
  • Thanks to all the testers for being brave and patient.


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

Application versions: 
File sailfishos-uithemer-2.1.0-5.armv7hl.rpm162.27 KB09/01/2019 - 21:16
File sailfishos-uithemer-2.1.0-5.i486.rpm166.01 KB09/01/2019 - 21:16
File sailfishos-uithemer-2.1.1-2.armv7hl.rpm163.1 KB14/01/2019 - 00:55
File sailfishos-uithemer-2.1.1-2.i486.rpm166.82 KB14/01/2019 - 00:55
File sailfishos-uithemer-2.1.2-7.armv7hl.rpm170.08 KB04/02/2019 - 02:34
File sailfishos-uithemer-2.1.2-7.i486.rpm173.82 KB04/02/2019 - 02:34
File sailfishos-uithemer-2.1.3-3.armv7hl.rpm173.11 KB13/02/2019 - 17:24
File sailfishos-uithemer-2.1.3-3.i486.rpm176.88 KB13/02/2019 - 17:24
File sailfishos-uithemer-2.1.4-2.armv7hl.rpm173.74 KB16/02/2019 - 21:09
File sailfishos-uithemer-2.1.4-2.i486.rpm177.54 KB16/02/2019 - 21:09
File sailfishos-uithemer-2.1.5-4.armv7hl.rpm177.27 KB21/02/2019 - 18:14
File sailfishos-uithemer-2.1.5-4.i486.rpm181.05 KB21/02/2019 - 18:14
File sailfishos-uithemer-2.2.0-6.armv7hl.rpm211.23 KB24/03/2019 - 05:39
File sailfishos-uithemer-2.2.0-6.i486.rpm215.12 KB24/03/2019 - 05:39
File sailfishos-uithemer-2.2.0-7.armv7hl.rpm222.49 KB09/04/2019 - 14:55
File sailfishos-uithemer-2.2.0-7.i486.rpm220.71 KB09/04/2019 - 14:55
File sailfishos-uithemer-2.2.1-1.armv7hl.rpm233.77 KB20/04/2019 - 20:36
File sailfishos-uithemer-2.2.1-1.i486.rpm237.61 KB20/04/2019 - 20:36
File sailfishos-uithemer-2.2.1-2.armv7hl.rpm233.76 KB20/04/2019 - 20:43
File sailfishos-uithemer-2.2.1-2.i486.rpm237.58 KB20/04/2019 - 20:43
File sailfishos-uithemer-2.2.1-3.armv7hl.rpm238.88 KB14/12/2019 - 23:35
File sailfishos-uithemer-2.2.1-3.i486.rpm242.81 KB14/12/2019 - 23:35

* Sat Apr 20 2019 2.2.1 - Services now take in consideration overlay settings. - Minor fixes. - Updated translations.

* Tue Apr 9 2019 2.2.0-7
- Minor fixes.
- Updated translations.

* Mon Mar 11 2019 2.2.0-5
- Minor fixes.
- Updated translations.

* Sun Mar 10 2019 2.2.0-3
- Cover redesigned.
- Links updated.
- Updated translations.

* Thu Feb 28 2019 2.2.0-2
- Updated translations.

* Sun Feb 24 2019 2.2.0-1
- Redesigned theme applying.
- Added sound themes.
- New iconography.

* Thu Feb 21 2019 2.1.5-4
- Updated translations.

* Tue Feb 19 2019 2.1.5
- Initial support for Android DPI settings on XA2.
- Updated translations.

* Sat Feb 16 2019 2.1.4
- Cover redesigned.
- Preview theme on cover.

* Sun Feb 10 2019 2.1.3
- Backup/restore icons.
- Different UI modes.

* Mon Jan 14 2019 2.1.2
- Added active theme on cover.

* Fri Jan 11 2019 2.1.1
- Bump Theme pack support dependency.
- Added dconf default settings.
- Added easy mode.
- UI tweaks.

* Sat Jan 5 2019 2.1.0
- [EXPERIMENTAL] Service for running one-click restore before system upgrades.



fravaccaro's picture

Can you try to reinstall the package? As far as it's been reported, it works on the Jolla 1.

DameCENO's picture

I had to unistall it and revert back to 0.2-1 will try to update and get back to you. another question : is it safe to have ui themer and Tablet ui both installed? with what happened had to unistall tablet ui altogether.


And to make things clearer, all patches that come with the patch work flawlessly, just that it breaks the pixel ratio slider which doesn't change from the default value. Everything else works fine


Confirmed, the problem is with the version 0.4-1 of this patch, as I didn't install the Tablet UI this time aroiund. All patches work fine but the pixel ratio slider remains on the default value no matter what I do, homescreen refresh, even reboot, nothing changed. This default value of the pixel ratio option now seems too big for me, that is how cool this patch is. Hope the next version will fix this, and I am ready to assisst in providing what ever info you might need to get it done. Going back to 0.2-1 I can't do without this awesome patch

fravaccaro's picture

May you please run this command with UI thener 0.4 installed and without it?   ls /etc/dconf/db/vendor.d/locks/

DameCENO's picture

The command with the version 0.2 of the UI themer installed return the following output



As I have my hands full at the moment, will run the command with the version 0.4 installed in an hour or so when I leave work and reach home

The command with the version 0.4 installed returns the following output
screen-rotation.txt ui-configs.txt

fravaccaro's picture

Ok, may you repeat that command with no UI themer installed and with 0.4?

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.