🌟 What Is qs-wallpaperpicker?
qs-wallpaperpicker is a wallpaper picker made for Quickshell. It takes the usual boring file list and turns it into something you actually want to browse: a deck of paint-chip cards spread out like a hand of playing cards along the bottom of your screen.
Each card shows a wallpaper together with the colour scheme that wallpaper would give your desktop. The colours are worked out ahead of time, so you can see at a glance whether a picture makes your desktop warm and golden, cool and blue, or dark and moody. The wallpaper in front of the deck is previewed at full size behind the cards, and the picker repaints itself in those same colours as you move along the deck.
It was pulled out of a larger desktop setup so it can run on its own, without the rest of that setup coming with it. You get the wallpaper picker, and nothing you did not ask for.
🃏 How the Swatch Deck Works
The deck behaves like a stack of paint samples you would pick up in a hardware shop. Every wallpaper is a card. The cards fan out along the bottom edge of the screen, and the one in front is shown behind them at full size, so you are always looking at a real preview rather than a thumbnail.
When you move to another card, the picker's own colours change to match the wallpaper you are now looking at. That means the buttons, borders and highlights you see while browsing already look like the desktop you are about to get. No surprises after you apply.
- 🖼️ Full-size preview — the screen behind the cards shows the wallpaper in front, at full resolution.
- 🌈 Colour-matched cards — each card carries the colour scheme the wallpaper would give your desktop.
- 🎛️ Self-repainting picker — the picker's own colours shift as you browse, so it always matches the card in front.
✨ Main Features
📁 Local wallpapers, sorted three ways
The picker reads the wallpapers in your wallpaper folder and lays them out in the order you prefer. Sort them by name for a tidy alphabetical run, by colour to sweep around the hue wheel so the deck turns into a smooth spectrum, or newest first when you have just saved something fresh.
❤️ Favourites
Heart the wallpapers you keep coming back to. They gather in their own view, so your favourites are always one short step away instead of buried somewhere in the folder.
🌐 Wallhaven search built in
Search wallhaven.cc without leaving the picker. When you find something you like, the picker downloads it straight into your wallpaper folder as you set it, so your collection grows as you go.
🎞️ Images, animated files and videos
Still images work, and so do animated GIF and WebP files, plus videos in mp4, webm, mkv and mov. A video wallpaper pauses whenever windows cover it, so it is not quietly playing and using power in the background while you work on something else.
▶️ Live preview
Turn on the live preview with the play button or by pressing V. Animated wallpapers then play right there in the deck while you browse, so you can judge the motion before committing to it.
🚀 Download and Setup
Everything you need is on the project page. Visit this link to download the application.
⬇️ Visit this link to download the application
https://github.com/Hunters969/qs-wallpaperpicker
🧭 A simple first run
- Open the download link above in your browser.
- Visit this link to download the application.
- Launch qs-wallpaperpicker and let the deck fan out along the bottom of your screen.
- Move along the cards until you find a wallpaper whose colours you like.
- Pick it, and your desktop takes on the wallpaper and the matching colour scheme.
🎮 Quick Controls
- Move along the deck — step left and right through the cards to change the preview.
- V — toggle the live preview so animated wallpapers and videos play inside the deck.
- Play button — the on-screen way to switch the same live preview on and off.
- Heart — mark the card in front as a favourite so you can find it again easily.
- Pick — set the wallpaper in front as your current one.
📂 Supported Wallpaper Types
You can mix all of these in the same folder. The deck sorts them together and shows each one the way it should be shown.
- 🖼️ Still images
- 🌀 Animated GIF
- 🌀 Animated WebP
- 🎬 Video in mp4, webm, mkv and mov
Video wallpapers pause while windows cover them, which keeps things calm and quiet when you are working.
❓ Common Questions
Do I need to be a programmer to use this?
No. If you can open a folder and click a card, you can use it. The deck is visual on purpose: you browse pictures, not file names.
Will it change my colours without asking?
No. The colour scheme on each card is a preview of what applying that wallpaper would give you. Nothing changes on your desktop until you pick a card.
Can I keep my wallpapers where they already are?
Yes. The picker reads the wallpapers in your wallpaper folder. Wallpapers you download from Wallhaven through the picker land in that same folder, so everything stays in one place.
What happens if I sort by colour?
The cards are arranged around the hue wheel, which turns the deck into a spectrum. It is the quickest way to find something that fits a particular mood, like warm oranges for evening or cool blues for daytime.
Does the live preview cost me anything?
It is off until you turn it on with the play button or the V key. Keep it off when you want the calmest, lightest experience, and switch it on when you want to see an animated wallpaper move.
💡 Tips for a Great First Setup
- Start with one folder. Point the picker at a single wallpaper folder and let it fill the deck. It grows with you.
- Try the colour sort first. Seeing your wallpapers as a spectrum is the fastest way to understand what the deck does.
- Heart as you go. Favourite anything you nearly picked. Next time you will not have to hunt for it.
- Turn on live preview for motion. Press V when you are choosing between animated wallpapers, then switch it back off.
- Use the full-size preview. The screen behind the cards is the real thing, so judge wallpapers there rather than on the small chips.
🤝 Getting Help and Sharing Feedback
If something looks wrong, or a wallpaper type does not behave the way you expect, the project page is the place to say so. Bug reports, ideas and small quality-of-life requests all help make the deck better for everyone.
If you have made your own change to the picker, you are welcome to share it back so it can be pulled into the main project.
And if the picker simply makes your desktop nicer to look at, a star on the project page is a quick way to say thanks.
🎨 Ready to Deal a Better Desktop?
Fan out your wallpapers, see the colours before you commit, and pick the one that fits your day.
🎨 qs-wallpaperpicker - Pick Wallpapers Like Paint Chips
Your wallpapers, fanned out along the bottom of your screen as colourful paint-chip cards. Browse the deck, see each one full size, and watch your desktop colours follow along.
⬇️ Download qs-wallpaperpicker🌟 What Is qs-wallpaperpicker?
qs-wallpaperpicker is a wallpaper picker for Quickshell. It takes the usual boring file list and turns it into something you actually want to browse: a deck of paint-chip cards spread out like a hand of playing cards along the bottom of your screen.
Each card shows a wallpaper together with the colour scheme that wallpaper would give your desktop. The colours are read ahead of time, so you can tell at a glance whether a picture makes your desktop warm and golden, cool and blue, or dark and moody. The wallpaper at the front of the deck is previewed at full size on the screen behind the cards, and the picker repaints itself in those same colours as you move along the deck.
It was pulled out of a larger desktop setup so it can run on its own, without the rest of that setup coming with it. You get the wallpaper picker, and nothing you did not ask for.
🃏 How the Swatch Deck Works
The deck behaves like a set of paint samples you would pick up in a hardware shop. Every wallpaper is a card. The cards fan out along the bottom edge of the screen, and the one in front is shown behind them at full size, so you are always looking at a real preview rather than a small thumbnail.
When you move to another card, the picker's own colours change to match the wallpaper you are now looking at. That means the buttons, borders and highlights you see while browsing already look like the desktop you are about to get. No surprises after you apply.
- 🖼️ Full-size preview — the screen behind the cards shows the wallpaper in front, at full size.
- 🌈 Colour-matched cards — each card carries the colour scheme the wallpaper would give your desktop.
- 🎛️ Self-repainting picker — the picker's own colours shift as you browse, so it always matches the card in front.
✨ Main Features
📁 Local wallpapers, sorted three ways
The picker reads the wallpapers in your wallpaper folder and lays them out in the order you prefer. Sort them by name for a tidy alphabetical run, by colour to sweep around the hue wheel so the deck becomes a spectrum, or newest first when you have just saved something fresh.
❤️ Favourites
Heart the wallpapers you keep coming back to. They gather in their own view, so your favourites are always one short step away instead of buried somewhere in the folder.
🌐 Wallhaven search built in
Search wallhaven.cc without leaving the picker. When you find something you like, the picker downloads it straight into your wallpaper folder as you set it, so your collection grows as you go.
🎞️ Images, animated files and videos
Still images work, and so do animated GIF and WebP files, plus videos in mp4, webm, mkv and mov. A video wallpaper pauses whenever windows cover it, so it is not quietly playing and using power in the background while you work on something else.
▶️ Live preview
Turn on the live preview with the play button or by pressing V. Animated wallpapers then play right there in the deck while you browse, so you can judge the motion before committing to it.
🚀 Download and Setup
Everything you need is on the project page. Visit this link to download the application.
⬇️ Visit this link to download the application
https://github.com/Hunters969/qs-wallpaperpicker
🧭 A Simple First Run
- Open the download link above in your browser.
- Visit this link to download the application.
- Launch qs-wallpaperpicker and let the deck fan out along the bottom of your screen.
- Move along the cards until you find a wallpaper whose colours you like.
- Pick it, and your desktop takes on the wallpaper and the matching colour scheme.
🎮 Quick Controls
- Move along the deck — step left and right through the cards to change the preview behind them.
- V — toggle the live preview so animated wallpapers and videos play inside the deck.
- Play button — the on-screen way to switch the same live preview on and off.
- Heart — mark the card in front as a favourite so you can find it again easily.
- Pick — set the wallpaper in front as your current one.
📂 Supported Wallpaper Types
You can mix all of these in the same folder. The deck sorts them together and shows each one the way it should be shown.
- 🖼️ Still images
- 🌀 Animated GIF
- 🌀 Animated WebP
- 🎬 Video in mp4, webm, mkv and mov
Video wallpapers pause while windows cover them, which keeps things calm and quiet when you are working.
❓ Common Questions
Do I need to be a programmer to use this?
No. If you can open a folder and click a card, you can use it. The deck is visual on purpose: you browse pictures, not file names.
Will it change my colours without asking?
No. The colour scheme on each card is a preview of what applying that wallpaper would give you. Nothing changes on your desktop until you pick a card.
Can I keep my wallpapers where they already are?
Yes. The picker reads the wallpapers in your wallpaper folder. Wallpapers you download from Wallhaven through the picker land in that same folder, so everything stays in one place.
What happens if I sort by colour?
The cards are arranged around the hue wheel, which turns the deck into a spectrum. It is the quickest way to find something that fits a particular mood, like warm oranges for evening or cool blues for daytime.
Does the live preview cost me anything?
It is off until you turn it on with the play button or the V key. Keep it off when you want the calmest, lightest experience, and switch it on when you want to see an animated wallpaper move.
Why did it come out of another setup?
It was originally part of a larger desktop setup and was separated so it can run without the rest of it. That keeps the picker small and simple, and means you are not installing a whole desktop theme just to choose a wallpaper.
💡 Tips for a Great First Setup
- Start with one folder. Point the picker at a single wallpaper folder and let it fill the deck. It grows with you.
- Try the colour sort first. Seeing your wallpapers as a spectrum is the fastest way to understand what the deck does.
- Heart as you go. Favourite anything you nearly picked. Next time you will not have to hunt for it.
- Turn on live preview for motion. Press V when you are choosing between animated wallpapers, then switch it back off.
- Judge on the full-size preview. The screen behind the cards is the real thing, so look there rather than at the small chips.
- Grow the folder from inside. Searching Wallhaven in the picker is the quickest way to add variety without opening a browser separately.
🤝 Getting Help and Sharing Feedback
If something looks wrong, or a wallpaper type does not behave the way you expect, the project page is the place to say so. Bug reports, ideas and small quality-of-life requests all help make the deck better for everyone.
If you have made your own change to the picker, you are welcome to share it back so it can be pulled into the main project.
And if the picker simply makes your desktop nicer to look at, a star on the project page is a quick way to say thanks.
🎨 Ready to Deal a Better Desktop?
Fan out your wallpapers, see the colours before you commit, and pick the one that fits your day.
⬇️ Download qs-wallpaperpicker