Skip to content
Chapters
  1. Welcome to Omarchy!
  2. Getting Started
  3. Coming From Mac or Windows
  4. Navigation
  5. The Top Bar
  6. Themes
  7. Hotkeys
  8. Unified Clipboard & History
  9. Reminders
  10. Notices
  11. Text Extraction & Dictation
  12. Screenshots & Recording
  13. Toggles, Idle & the Screensaver
  14. Omarchy CLI
  15. Terminal
  16. Neovim
  17. AI
  18. Development Tools
  19. Shell Tools
  20. Shell Functions
  21. TUIs
  22. GUIs
  23. Browsers
  24. Commercial apps/services
  25. Web Apps
  26. Gaming
  27. Filling out PDFs
  28. Windows VM
  29. Other Packages
  30. Updates
  31. Dotfiles
  32. Shell Plugins
  33. Monitors
  34. Keyboard, Mouse, Trackpad
  35. Networking
  36. System sleep
  37. Hardware authentication
  38. Fonts
  39. Backgrounds
  40. Prompt
  41. Branding
  42. Common tweaks
  43. Making your own theme
  44. Mac support
  45. Troubleshooting
  46. FAQ
  47. System snapshots
  48. Security
  49. Omarchy on...
  50. Dual Boot Install
  51. Unattended Installs

Manual

Backgrounds

Every theme ships with its own set of backgrounds, and you can add extras of your own in ~/.config/omarchy/backgrounds/[theme]. If you want to add an extra background image to, say, the nord theme, you just put the file in ~/.config/omarchy/backgrounds/nord.

You can do this most easily by going to Install > Style > Background in the Omarchy Menu. That’ll bring up the folder where the backgrounds for that theme is stored. Hit Super + Shift + F to start another file manager, find your background, copy it over. Now it’ll be included in the choices of backgrounds you can select between using Super + Ctrl + Space.

Backgrounds can be videos as well as stills. Drop an mp4, m4v, mov, webm, mkv, or avi file in the same folder and it appears alongside the images. Videos are played by the OWE wallpaper engine. It decodes the video once for all monitors and plays its sound through the default audio output, and it stops playback whenever nothing can see it. The lock screen draws the same decode, muted, through OWE. A video wallpaper still costs far more power than a still one.

You can find a huge collection of cool curated backgrounds on https://github.com/dharmx/walls.

Video backgrounds keep a cached still on the lock screen while playback is paused or unavailable. Animated GIFs play on the desktop and show a still frame on the lock screen.