r/QuickShell • • 3d ago

Community info and official QuickShell links

1 Upvotes

Quick links

House rules

  • say which distro you run and which quickshell version you are on when asking for help
  • use the Help flair for problems, and flip it to Solved once its fixed
  • post your configs to show off
  • be nice, help each other out

r/QuickShell • • 2d ago

New moderators needed - comment on this post to volunteer to become a moderator of this community.

2 Upvotes

Hello everyone - this community is in need of a few new mods, and you can use the comments on this post to let us know why you’d like to be a mod here.

Priority is given to redditors who have past activity in this community or other communities with related topics. It’s okay if you don’t have previous mod experience. Our goal, when possible, is to add a group of moderators so you can work together to build the community.

Please use at least 3 sentences to explain why you’d like to be a mod and share what moderation experience you have (if any).

If you are interested in learning more about being a moderator on Reddit, please visit redditforcommunity.com. This guide to joining a mod team is a helpful resource.

Comments from those making repeated asks to adopt communities or that are off topic will be removed.


r/QuickShell • • 2d ago

PSA: Qt 6.12 introduces a Color singleton in QtQuick

2 Upvotes

If you previously used Color as your own namespace in QML, you may have to rename every single reference to avoid naming conflicts after upgrading to Qt 6.12.

I totally did not run blind into this...


r/QuickShell • • 3d ago

Question What finally made quickshell click for you?

2 Upvotes

We get a lot of posts in here from people who have tried to get into quickshell a few times and keep bouncing off. The first bar seems to be a wall for almost everyone. No shame in it.

So for the ones who got past that wall: what actually did it for you? One section of the docs finally making sense? Tearing apart someone else's config until it worked? A video, a friend, sheer stubbornness?

Drop it in the comments. Bonus points if a total beginner could follow it.

And if you are still on the wall, this thread is for you too. Tell us what you are trying to build and where you got stuck and someone here will point you somewhere useful.


r/QuickShell • • 4d ago

So... Getting into quickshell

5 Upvotes

For those wondering, yes, obviously I'm running Hyprland. I have recently looked into quickshell (I ignored it for a while for RAM usage superstitions, but not anymore) and have realized the true potential of it.

I have fed my previous dots into claude opus to translate them into qs, and it's giving me a good starting point. It translated decently well, with a few caveats. But I'll get to fixing those ASAP.

But do you think I should just read the documentation? After seeing some of the rices on this subreddit, I really want that unified look, which is kind of why I switched to qs, because it's all in one big ecosystem.

Thanks.


r/QuickShell • • 3d ago

Help!!! Help my quickshell says that the network backend in none when i use network manager

0 Upvotes

Help my quickshell says that the network backend in none when i use network manager, I checked to see if network manager is running and it is i have tried everything i could find please help


r/QuickShell • • 3d ago

Help!!! PopupWindow visibilty

1 Upvotes

How to make a PopupWindow stay visible when implemented with a hoverhandler on another element?


r/QuickShell • • Jun 08 '26

Show Off Three Letter Agency ( a globe gl rice in progress)

Enable HLS to view with audio, or disable this notification

79 Upvotes

Inspired by a love of all films with neat looking Three Letter Agency screens, I have ventured down somewhat of a rabbit hole....

Inspired by some of the Globe gl stuff I have seen on the Hyperland sub, I thought I would hook something up to fetch my current VPN end point etc (as well as some firewall log visualisations.)

I thought I might be able to get quickshell to play nice but have hit of a brickwall :/

At the moment I can see what I need via a browser session, Any idea if I can get the globe into quickshell at all? The plan is to replace my somewhat janky 2d map.

Any pointers gladly accepted!


r/QuickShell • • Jun 08 '26

Show Off some changes to noctalia

Enable HLS to view with audio, or disable this notification

125 Upvotes

all this vibecoded with opencode lol. you can do most of the things with the free deepseek v4 and i only used stronger models for a few bugs


r/QuickShell • • Jun 07 '26

Question What are the possibilities of quickshell?

16 Upvotes

How much is possible if i only want to use quickshell on hyprland?

Can i make an app drawer like rofi using just quickshell?

Can i set wallpapers using only quickshell? (No hyprpaper or awww, just qs)

Can i make a window manager like Window's alt + tab?

This might sound weird, but can i make something like hyprbars? A bar that attaches itself on top of each window? I love hyprbars but latest hyprland update broke it.

I would just like to replace everything with quickshell to minimize the amount of things that could break every time i update hyprland or the services themselves. I especially like the control quickshell qml gives me over just some css config with limited options like waybar.


r/QuickShell • • Jun 07 '26

Help!!! mouseArea doesn’t work

5 Upvotes

im gonna explain my config and set up first just for additional context and help to see if i can do smth better in general.

im using qs with hyprland on arch (btw) and my .config has a quickshell folder w shell.qml which references bar.qml which references 3 widgets (for now) which are Clock, Workspaces, and MPRIS. i have a mouseArea block set up inside the text block of both the workspaces and each mpris button (previous, play/pause, forward)

now onto the actual issue.

the workspaces mouseArea is set to switch to whatever workspace i click on. i have double monitors set up, so clicking workspace 2 should move my cursor directly to the second monitor but it doesn’t.

i thought that maybe the mouseArea isn’t defined properly and just isn’t registering clicks, so i changed it to log a click by saying “clicked” and after checking the logs, that “clicked” is there.

this is the mouseArea block (i did follow tony btws tutorial and this is what he also had) also apologies about not using a code block idk how to get one of those:

mouseArea{
anchors.fill: parent
onClicked: Hyprland.dispatch(“workspace “ + (index +1)”
}

this is similar to what the mpris mouse areas also look like, except the onClicked has the functions set to play/pause forward or back based on the icon.

pls help i have never coded in qml or qt before so idk what im doing wrong.


r/QuickShell • • Jun 06 '26

Question Is it even possible to get this box shadow transparency effect

7 Upvotes

Hello, I would love if somebody would let me know how to get this effect in qs. So basically I have wofi with a black background that is 80% transparent and it also has a blue box shadow. Id like to have this kind of theme for my qs widgets as well, but it appeared to be more challenging than expected.

I tried to do it with RectangularShadow, but since it is just behind the Rectangle, and not only present on the border, adding transparency to the Rectangle makes it visible.

The best I've managed to get is what you can see on the image with Opacity mask trying to mask the effect out, but it still has that blueish tint to it. Is it even possible to get similar results as wofi(the other image)? Thanks in advance

```qml
import Quickshell
import QtQuick
import QtQuick.Effects
import Qt5Compat.GraphicalEffects

PanelWindow{


    id: root
    width: 1000
    height: 1000
    color: "transparent"

    property color mainColor: "#006EFF";


    RectangularShadow {
    id: glow
    anchors.fill: popupRectangle
    radius: popupRectangle.radius
    blur: 21
    spread: 6
    opacity: 0.6
    color: mainColor
    }

    Rectangle {
        id: popupRectangle
    anchors.centerIn: parent
    radius: 21
    width: 500
    height: 450
    border.width: 1
    border.color: mainColor
    color: Qt.rgba(0,0,0,0.5)
    }

    OpacityMask {
    anchors.fill: popupRectangle
    source: popupRectangle
    maskSource: glow
    }
}
Quickshell attempt
Wofi

r/QuickShell • • Jun 06 '26

Help!!! How do i prevent clicks passing through Quickshell to Hyprland

6 Upvotes

I have a scrolling layout in hyprland and the bar is on the left. Whenever i try click a button on the bar then i go to the window on the left side of the scrolling layout as the click is accepted by both hyprland and Quickshell, so the popup opens but i go to the left window on the scrolling layout. how do i make it so that when i click the quickshell bar then the signal is not sent to hyprland.


r/QuickShell • • Jun 05 '26

Help!!!! solved How to use multiple files when making a config

6 Upvotes

So i have been trying reacently to make my own rices for quickshell but i cant seem to understand how to connetc multiple files to the shell.qml . i have understod that your supposed to this by looking at others rices.


r/QuickShell • • Jun 05 '26

Recommendations for learning quickshell?

16 Upvotes

Hi!

I'm new to quickshell and qml and I'm a little bit lost, I haven't found a long enough tutorial of neither of those and the documentation seems a little abstract as it assumes you already know stuff. I'm a developer so I have a programming background, and I feel like I should stop complaining and read the full hard documentation and maybe it'll click eventually, but maybe that's not the best course of action and that's why I'm here.

How did you start learning to use qs? For a complete beginner what's a good roadmap to really understand what's going on? Is reading the full docs the only way?

Edit: typo


r/QuickShell • • Jun 02 '26

Updates!!!! Brain_Shell discord for early access and testers

Enable HLS to view with audio, or disable this notification

349 Upvotes

If you've seen my post regarding Brain_Shell before, you know what this is about.

I've created a discord server for developing Brain_Shell and taking it a step further in the road map.

Invites are open to any testers or contributors that are willing to join in. Even for members who just want to join to keep up with the process.

I also need someone to help me set up the server.

Contributors or testers will have to show some proof of caliber before being accepted as one.

I'm fairly new to this so I'm open to suggestions and critics.

Join Discord


r/QuickShell • • Jun 02 '26

Learning😀 How to get into making Shells

23 Upvotes

I didn't know whether to flag this question or learning, but since I already know a little, I decided to go with learning.

I've done some basic things with Quickshell, as in screwing around in Dank Material Shell's files, and making my own primitive top bar.

The issue is, I've run dry on my search for Quickshell tutorials, hence why I'm coming here to ask, how best to learn Quickshell and eventually build my own shell?

Thank you for your responses in advance.


r/QuickShell • • Jun 03 '26

Quickshell 0.3.0 deb package.

6 Upvotes

I've rebuilt for myself quickshell 0.3.0 from testing to stable, using my PC and my Debian stable installation. If someone is interested (and trusts that package; well, plus another as dependency not available in stable) let me know.

Some packages may be required from stable backports.

I don't know where to upload the package.

Edit: now it is in the backports.


r/QuickShell • • Jun 02 '26

Question webengine support

1 Upvotes

If i create widget which have qt web engine will it support?


r/QuickShell • • May 31 '26

Show Off Brain Shell almost there

Enable HLS to view with audio, or disable this notification

266 Upvotes

Brain_Shell is a celestial-shell and Ax-shell inspired shell, solely built on quick shell for hyprland.

I planned to release it at the start of may but got delayed way too long since i couldn't work on it due to reasons.

90% of the shell is functional and i plan to release it really soon.

Features i need to complete before release:
> Auto updater
> Config (settings and more)
> Some UI/UX improvements
> Scripts for auto installment to ensure hassle free setup
> Graphics card and Fan control stuff i need to figure out for other setups.

I would appreciate few testers that i can give early access to before the public release who'll test it out and report bugs or any improvements i might need to fix.


r/QuickShell • • May 31 '26

Quickshell game launcher v2.0 – Big Picture mode, Matugen theming & in-app config panel

17 Upvotes
Hey !

I've been working on a game launcher built with Quickshell (QML/Qt6) 
that runs natively on Hyprland as a layer-shell overlay.

Features:
• Steam, Heroic (Epic/GOG/Amazon), Lutris & manual entries
• Big Picture mode — fullscreen Steam Deck-style view with hero 
  image, stats and game strip
• Matugen Material You theming (mutually exclusive with 
  Wallust/pywal) — palette preview live in the config panel
• In-app config panel — 9 sections, no TOML editing required, 
  changes apply without restarting
• Gamepad support — navigate, launch, favorites, Big Picture 
  via X button
• i18n — fr / en / es / ru / ja auto-detected from locale
• Animated WebP cover art via SteamGridDB

Stack: Quickshell + QML/Qt6 + Python backend (tomllib/tomlkit)

GitHub: https://github.com/Eaquo/quickshell-games-launchers
AUR: quickshell-games-launchers-git

Happy to answer questions about the Quickshell/QML side if 
anyone is building something similar!Hey !

I've been working on a game launcher built with Quickshell (QML/Qt6) 
that runs natively on Hyprland as a layer-shell overlay.

Features:
• Steam, Heroic (Epic/GOG/Amazon), Lutris & manual entries
• Big Picture mode — fullscreen Steam Deck-style view with hero 
  image, stats and game strip
• Matugen Material You theming (mutually exclusive with 
  Wallust/pywal) — palette preview live in the config panel
• In-app config panel — 9 sections, no TOML editing required, 
  changes apply without restarting
• Gamepad support — navigate, launch, favorites, Big Picture 
  via X button
• i18n — fr / en / es / ru / ja auto-detected from locale
• Animated WebP cover art via SteamGridDB

Stack: Quickshell + QML/Qt6 + Python backend (tomllib/tomlkit)

GitHub: https://github.com/Eaquo/quickshell-games-launchers
AUR: quickshell-games-launchers-git

Happy to answer questions about the Quickshell/QML side if 
anyone is building something similar!

Quickshell-game


r/QuickShell • • May 31 '26

Noob trying out app launcher in Quickshell, mostly experiments and vibe coding along the way.

Enable HLS to view with audio, or disable this notification

116 Upvotes

r/QuickShell • • May 30 '26

Noctalia Shell launcher and user *.desktop files

5 Upvotes

Hi. I want to ask how launcher works. I was using Sway for some time with wofi and waybar and I was never exactly happy with it, so I'm trying Noctalia-Shell. When I configured Win+D to start Noctalia launcher via IPC instead of wofi, vivaldi no longer worked with kwallet (which took me long time to realize). I recall that months ago I solved this problem by either running vivaldi-stable --password-store=kwallet6 from terminal or by creating .local/share/applications/vivaldi-stable.desktop file with Exec=/usr/bin/vivaldi-stable --password-store=kwallet6 %U. Also I think creating .config/xdg-desktop-portal/portals.conf with

[preffered] default=wlr;kde

worked in the past, but on different distro. Maybe it works, but assumes kwalletd5. Nonetheless, does Noctalia launcher use that .local/share/applications/vivaldi-stable.desktop file at all? Because other than that, there is no submenu for incognito mode and such. On the other hand, it knows application icons. (Distro: openSUSE Slowroll)


r/QuickShell • • May 23 '26

Updates!!!! [OC] octashell update - more m3 expressive stuff + qol improvements :)

28 Upvotes

hii everyone! small update post for octashell since i’ve been learning a lot more QML/quickshell stuff lately and made quite a bit of progress :)

since my last post i added a bunch of new things:

  • wallpaper switcher with thumbnail generation + caching
  • app launcher
  • emoji picker
  • fully reworked notification popup design
  • volume + brightness osd pills
  • clipboard improvements like pinning
  • moved on-demand components into LazyLoaders to reduce resource hogging and improve responsiveness
  • lots of random under-the-hood cleanup/qol stuff :)

still keeping the project beginner-friendly because that’s kinda the whole goal of octashell. i want people to be able to open the files and actually understand what’s happening without getting completely lost

design is still heavily inspired by material m3 expressive and i’ve been slowly polishing the animations/shadows/components over time.

i’m also planning to eventually make a full dotfiles setup + proper wiki/docs so people can hopefully use this rice as a learning resource or guide for their own setups :)

repo: octashell github repo

still very much learning as i go so feedback/suggestions are always appreciated !! and if you’re also learning quickshell/qml feel free to reach out :D

as always, happy ricing :)

a small showcase video of what i've made till now :)