Guidelines and HOWTOs/Change the default wallpaper

  1. Copy the old wallpaper from the breeze repo to the plasma-workspace-wallpapers repo. Don't forget to copy the whole Next folder, rename it appropriately, and also update the CMakeLists.txt file!
  2. Generate multiple sizes/aspect ratios for new wallpaper with [breeze repo]/wallpapers/generate_wallpaper_sizes.py.
    1. If the Mobile versions look ugly, manually make better-looking versions by cropping, rotating, etc.
  3. Replace existing wallpaper images in [breeze repo]/wallpapers/Next/contents with new one. Don't forget screenshot.png!
  4. Edit [breeze repo]/wallpapers/Next/metadata.desktop to reflect the new name, and include the name and email address for the author
  5. Compile breeze
  6. Create a new user account named "Konqi", log into it, switch the language to English
  7. Run kscreenlocker_greet --testing and take a screenshot with no window decorations
  8. Open Dolphin, the "About KDE" window, and Kickoff. Take a full-screen screenshot
  9. Switch the global theme to Breeze Dark to dark and do it again
  10. Switch the global theme to Breeze Twilight and do it again
  11. Log back into your original user account and copy the screenshots into an accessible place.
  12. Set your login screen to display the new wallpaper
  13. Run sddm-greeter --test-mode --theme ~/kde/usr/share/sddm/themes/breeze/ and take a screenshot without window decorations
  14. Replace the Breeze, Breeze Dark, and Breeze Twilight Global Theme preview images in plasma-workspace with the new ones you took in the Konqi account
  15. Replace the lockscreen preview image in plasma-workspace with the new one you took in the Konqi account
  16. Replace the SDDM preview image in plasma-workspace with the new one you just took
  17. git push all your changes

This is a very fiddly, time-consuming, and complicated process. https://phabricator.kde.org/T13629 tracks improving it.


This page was last edited on 1 September 2021, at 22:21. Content is available under Creative Commons License SA 4.0 unless otherwise noted.