English · Русский · Українська · Español · Português · Deutsch · Français · Italiano · Türkçe · Polski · Čeština · 한국어 · 日本語 · 中文 · हिन्दी · Tiếng Việt · Bahasa Indonesia · ไทย · Basa Jawa · Bahasa Melayu · বাংলা · العربية
Wallpapers by Mijuru — desktop app for Linux
Thousands of HD, 4K and 8K wallpapers from mijuru.com on your desktop. Set one in a single click, or let the app change them on a schedule.

Snap Store · App page on mijuru.com · Report a problem

This repository holds the user documentation and the issue tracker for the app. The app is free; its source code is not public.
Contents
Features
Gallery
- The whole mijuru.com catalogue: browse by category, or sort by newest, most popular or random.
- Filters: orientation (phones, or desktop/laptop/tablet), resolution (including For My Screen), colour and colour style.
- Live search over tags and categories. Press
/ to search, Esc to close.
- One, two or three columns for desktop wallpapers.
Wallpaper page
- Preview the wallpaper on a PC, laptop, tablet, two or three screens, a TV, or a phone lock/home screen.
- Similar wallpapers and an endless “Up next” feed.
- Likes, downloads, colours and tags. Click a tag or colour to see more like it.
Set and download
- Set as desktop wallpaper in one click.
- Download any size, up to 8K, grouped by aspect ratio (16:9, 16:10, 21:9, 32:9, 48:9, 4:3, 9:16 and more). Files go to your
Downloads folder, and Show in folder opens it.
Auto-change (playlist)
- Add wallpapers you like to the playlist.
- Change every 15 min, 30 min, 1 hour, 3 hours, once a day (at midnight), or at each login.
- Play them in order or at random. Random mode won’t repeat any of the last 10.
- Previous / Next / Pause / Set now. Reorder by dragging, sort, shuffle.
- After the computer sleeps, the wallpaper changes once instead of catching up on every missed change.
Desktop integration
- Tray icon with Next wallpaper, Pause/Resume, Open and Quit.
- Start with the system, hidden in the tray.
- Light, dark or system theme.
- Interface in 22 languages.

Requirements and compatibility
- Linux, x86-64 (amd64)
- Screen at least 1100 px wide
- Internet connection, to browse the catalogue
Which desktops can set the wallpaper:
| Desktop environment |
Snap |
Flatpak (coming soon) |
| GNOME 42+ (incl. Ubuntu) |
✅ Set · ✅ Browse & download |
✅ Set · ✅ Browse & download |
| KDE Plasma |
❌ Set · ✅ Browse & download |
✅ Set, via the system dialog · ✅ Browse & download |
| Cinnamon, Xfce, others |
❌ Set · ✅ Browse & download |
⚠️ Depends on the desktop’s wallpaper portal · ✅ Browse & download |
On desktops where the app can’t set the wallpaper, the Set button says “This desktop environment is not supported yet”. You can still download any wallpaper and set it in your system settings.
Planned: Windows and macOS.
Install
Snap Store (recommended)
sudo snap install wallpapers-by-mijuru
Or search for Wallpapers by Mijuru in Ubuntu App Center / Snap Store.
Flathub
Coming soon. The app ID will be com.mijuru.mijuru_desktop.
Start minimised to the tray
wallpapers-by-mijuru --hidden
Getting started
- Find a wallpaper. Open a category, use the filters, or press
/ and type, for example, mountains.
- Set it. On the wallpaper page, click Set as desktop wallpaper. To use a particular size, pick it first.
- Build a playlist. Click Add to auto-change on every wallpaper you like.
- Turn on auto-change. Open the playlist and choose an interval and an order (in order or random).
- Let it run in the background. With auto-change on, closing the window hides the app to the tray. Turn on Start with the system so the playlist keeps going after a restart.
FAQ
Is it free?
Yes. No ads, no account, no subscriptions.
Do I need an account?
No. Your playlist and settings stay on your computer.
Can I use the wallpapers commercially?
No. Wallpapers from mijuru.com are free for personal use only. Resale and commercial use are not allowed.
Does it work on KDE, Xfce or Cinnamon?
In the Snap version you can browse and download, but not set the wallpaper. The Flatpak version (coming soon) sets it through the system wallpaper portal, which works on KDE. On other desktops, download the wallpaper and set it in your system settings.
Can I have a different wallpaper on each monitor?
Not yet. The same image goes on every monitor, scaled to fill. For ultrawide or multi-monitor setups you can download 32:9 or 48:9 sizes.
Can auto-change pick from a whole category?
Not yet. Auto-change uses only the wallpapers you added to your playlist.
Why did the app quit when I closed the window?
The app stays in the tray only while auto-change is running: auto-change is on, the playlist is not empty, and your desktop is supported. Otherwise closing the window quits the app.
Does auto-change work offline?
Partly. Wallpapers already saved on your computer can still be shown. If the next one isn't saved yet, the app shows *"No connection — will retry later"* and tries again.
Where are downloaded files saved?
In your `Downloads` folder, as `-x.`. If a file with that name already exists, the app adds `(2)`, `(3)` and so on.
</details>
Is there a version for Windows or macOS?
Both are planned. Watch this repository, or check [mijuru.com/desktop-app](https://mijuru.com/desktop-app), for news.
Which languages are supported?
22: English, Русский, Українська, Español, Português, Deutsch, Français, Italiano, Türkçe, Polski, Čeština, 한국어, 日本語, 中文, हिन्दी, Tiếng Việt, Bahasa Indonesia, ไทย, Basa Jawa, Bahasa Melayu, বাংলা, العربية. You can change it in **Settings → Language**.
## Troubleshooting
| Problem | What to do |
|---|---|
| **Set** button says *"This desktop environment is not supported yet"* | The Snap version sets wallpapers only on GNOME. Download the wallpaper and set it in your system settings, or use the Flatpak version once it is released. |
| No tray icon on GNOME | GNOME needs the *AppIndicator* extension to show tray icons. Ubuntu ships it; on other distributions, install *AppIndicator and KStatusNotifierItem Support*. |
| Flatpak: nothing happens when I click **Set** | The first time, your system asks for permission. The app window must be in focus for that dialog to appear. If you refused, the app shows *"portal: refused"*; allow the app in your system's privacy settings and try again. |
| Flatpak: **Start with the system** turned itself off | The system's background permission was revoked. Turn the option back on and allow it when asked. |
| *"Too many downloads, try again in N s"* | The server limits how fast you can download. Wait the time shown. Auto-change retries on its own. |
| *"No connection — will retry later"* | Check your internet connection. Auto-change will retry automatically. |
| My playlist is empty after an update or crash | If the playlist file was damaged, the app keeps a backup next to it, named `playlist.json.bak-`, and starts with an empty playlist. Please [report it](https://github.com/mijuru-dev/wallpapers-desktop-app/issues/new/choose). |
| Nothing happens when I launch the app a second time | Only one copy runs at a time. Launching it again brings the existing window to the front; check the tray. |
## Privacy
- **No accounts, no analytics, no crash reporting, no ads.**
- The app talks only to **mijuru.com**. It sends:
- your interface language,
- your search terms and filters,
- the app name and version, so the server can tell which app the request comes from.
- Links to Google Play or mijuru.com carry UTM tags, and only when you click them.
- **Stored on your computer:**
- settings (`settings.json`) and playlist (`playlist.json`) in the app's data folder,
- a thumbnail cache of up to 300 MB, oldest files removed first,
- full-size wallpapers for your playlist. In the Snap version they are kept in `~/snap/wallpapers-by-mijuru/common/`. Files are removed once they leave the playlist.
- an autostart entry in `~/.config/autostart/`, if you turned on *Start with the system*.
The website's privacy policy: <https://mijuru.com/privacy-policy>.
## Feedback
| What | Where | |
|---|---|---|
| 🐞 **Something doesn't work** | [Report a problem](https://github.com/mijuru-dev/wallpapers-desktop-app/issues/new/choose) | GitHub Issues |
| 💡 **Idea or suggestion** | [Share an idea](https://github.com/orgs/mijuru-dev/discussions/categories/ideas) | GitHub Discussions |
| ❓ **Question** | [Ask in Q&A](https://github.com/orgs/mijuru-dev/discussions/categories/q-a) | GitHub Discussions |
| ✉️ **Private matter** | [m@mijuru.dev](mailto:m@mijuru.dev) | Email |
**Issues are for problems only** — ideas, suggestions and questions live in [Discussions](https://github.com/orgs/mijuru-dev/discussions), where everyone can vote 👍 for the ideas they like most.
Please write in English so everyone can find and follow the conversation — a machine translation from your language is perfectly fine. Before posting, search existing issues and discussions: a 👍 on an existing one helps more than a duplicate.
🚩 To report a wallpaper that breaks copyright (DMCA) or is otherwise inappropriate, use **Report image** on that wallpaper's page.
## More wallpapers on mijuru.com
The full collection lives on the website — handy when you want to pick a wallpaper on another device or a size the app doesn't show:
- [Desktop wallpapers by resolution — 4K, 2K, Full HD, ultrawide](https://mijuru.com/wallpapers/resolutions)
- [Wallpaper packs — themed collections](https://mijuru.com/wallpapers/packs)
- [Phone wallpapers by brand — iPhone, Samsung, Xiaomi and more](https://mijuru.com/wallpapers/device-brands)
- [Avatars and profile pictures for Instagram, Discord, TikTok](https://mijuru.com/avatars)
## Other Mijuru apps
- 🌐 **[mijuru.com](https://mijuru.com):** the full catalogue in a browser
- 🤖 **[Android app](https://play.google.com/store/apps/details?id=com.mijuru.wallpaper):** phone wallpapers for your home and lock screen
- 🧩 **Browser extension:** a new wallpaper on every new tab. Available for [Chrome](https://chromewebstore.google.com/detail/mijuru-wallpapers/jlkpdnlkhknaifdjfjdepbfmklfpamfh), [Edge](https://microsoftedge.microsoft.com/addons/detail/mijuru-wallpapers/cdnegcioifbeoldnojbgcopnklpneodo) and [Firefox](https://addons.mozilla.org/firefox/addon/mijuru-wallpapers/).
- 🏠 **[mijuru.dev](https://mijuru.dev):** everything we build
## License
Wallpapers by Mijuru is free proprietary software. You can use it for personal and commercial purposes. You may not copy, modify, decompile or redistribute it, except that the Snap Store and Flathub may distribute it unmodified. It comes "as is", without warranty.
Wallpapers are subject to [mijuru.com](https://mijuru.com) terms.
Documentation in this repository © 2026 Mijuru.