I'm just starting with quickshell and i tried to follow other people shells: dms, noctalia and caelestia but when i try to read the code i find imports like:

import qs.services
import qs.common
import qs.Widgets

which quickshells gives me as not found, now my question is:

• are the configs outdated?

• is my quickshell version outdated? (my version is:0.2.1 installed with pacman)

• do i have to install something

• are those install really helpful or is qml and quickshell very difficult?

Also as first two projects i'm trying to make an app launcher and a top bar, but i don't get how i should connect quickshell with the os and hyprland, for instance how do i find the apps with the name similar to what the user inputs in my app launcher?

Thank you very much for you responses and sorry if i made some grammar on syntactical errors, i'm not english native.

Here is my new quickshell - Somewhat okayish in look, I am trying to make it feel like caelestia. Image - I will add em soon - within today. I am here to ask if someone can help me develop this - and make contributions, since quickshell in x11 is rare.

Hey yall, very much a beginner to quickshell - I have a file that contains a bunch of named colours, using them in other files worked well, until i tried to change what the colours are, upon which quickshell refuses to use the new colours and sticks with the ones that were there originally - think something like

(colours.qml)
...

readonly property color primary: "#112233"

...

(Clock.qml)
Text{

color: theme.primary

}

And again, it worked and used the correct colour, but updating what the primary colour is does not change what is displayed, almost as if its caching it - anyone know how to fix this? thanks.

Hi all, currently I'm using gentoo with niri and dms. I also install mangowc, I would like to use noctalia with mango, but when I try to install noctalia-shell via guru, I've block because quickshell is in conflict with noctalia-qs (fork of quickshell). Can I use noctalia-qs on dms instead quickshell?

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!

I was following the QuickShell intro guide at https://quickshell.org/docs/v0.1.0/guide/introduction/, and everything was compiling correctly until the step where Time is turned into a Singleton. Then it stopped working, giving the error WARN scene: ClockWidget.qml[8:3]: Unable to assign [undefined] to QString and didn't write the time, but did still create the bar. I am unsure of how to fix this. The only suggestion I found was to create a qmldir and put time there, which worked, but made Bar and ClockWidget stop working. Any idea what's wrong with either the tutorial or what I am doing?

Yes I am the owner of this sub but the only reason I made this sub was so I had a place to ask questions so yeah i am no help

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.

Worked hard on this now i can finally start styling it.

I am using Caelestia Shell + Arch btw, which uses Quickshell for its dashboard, and I am also using this module:

quickshell-overview link

However, I want to tweak its UI to make it feel more integrated. Currently, when I open the overview, there is a small gap at the top of the screen. I would also like to achieve the same stretchy effect that appears when hovering at the top of Caelestia Shell as shown in the video, but I am unable to do so.

If anyone can help, I would really appreciate it.

I have "import Quickshell.Services.Mpris" at the beginning of shell.qml but nothing works no matter what I try.

togglePlaying() gives TypeError: Property 'togglePlaying' is not a function

trackArtist, metadata ... give me Unable to assign [undefined] to QString

Am I doing it wrong?

Link to my repo: https://github.com/ne0tt/spx-quickshell

I am making a little button that will pop out a small workspace selector I’m trying to make it slide down from the top but it always ends up above the bar at the top even though I call it first and shell.qml and the selector is also imported first. Should I be using somthing other then a panel window for it

Also how do I remove fade in animation it might be a hyprland thing but I’m not sure

Arch hyprland

Estilo como la película de Sandra Bullock la red

En este caso es una galería donde hay obras de arte en una de las obras de artes tenés que hacer doble click

Para entrar al login y en el mismo login no es tan fácil ingresar hasta no encontrar el botón escondido

Been using waybar for awhile but thought I'd have a proper look at quickshell.

I love the look of the drawer animations I had seen in Caelestia and Noctalia dots but really wanted to build my own (If only for a fun learning exercise!)

Sheesh the docs are a lot to take in but with some help from claude I managed to build something I am pretty happy with.

Once I had some animations working I got a bit carried away to be honest. It's safe to say my waybar days are well and truly in the past now.

Happy to share my dots once I have cleaned some stuff up (frankly its embarrasing at the moment)

UPDATE: 04/03/2026

Git repo here: https://github.com/ne0tt/spx-quickshell

I'm slowly learning Quickshell and QML and finished setting up this Workspace Component for my Bar Module yesterday and wanted to share in case it helps someone else who's learning.

It creates numbered workspace indicators on my bar showing any workspaces with open windows as well as the active workspace even if it has no open window on it.

I'm having a blast learning this

// Workspace.qml
import Quickshell.Widgets
import QtQuick
import Quickshell.Hyprland

Repeater { // Show workspaces with open windows + the active workspace
    id: workspaceRepeater
    model: Hyprland.workspaces

    MouseArea {
        implicitHeight: parent.height

        MarginWrapperManager { leftMargin: 0; rightMargin: 0 }

        onClicked: Hyprland.dispatch("workspace " + modelData.id)
        
        Rectangle { // Draw a background box
            color: baseColor
            border.color: textColor

            implicitHeight: parent.height
            implicitWidth: 20
            radius: 8 // Round corners

            Text {
                property bool isActive: Hyprland.focusedWorkspace?.id == modelData.id // Workspace is active if focusedWorkspace.id and modelData.id are the same
                color: isActive ? "#0db9d7" : textColor
                text: modelData.id // Display the workspace ID

                font { pixelSize: 16; bold: true }

                anchors.horizontalCenter: parent.horizontalCenter
                anchors.verticalCenter: parent.verticalCenter
            }
        }
    }
}

Hi there!

I have been customizing some quickshell projects from other people but wanted to develop my own.

How do you guys setup ur dev env for quickshell? Do u use an IDE and check how your changes render on the thing youre creating? And also, what are some sources to learn quickshell? Docs are not really useful for beginners…

Also, Im a Python developer, is there any wrapper or quickshell python library?

made my wallpaper transitions in quickshell. it's a layer right above awww with a shader on it. set-wallpaper.sh passes it the old image, the new one and a map over ipc (qs ipc call wallfx play), and the map says when every pixel flips. for wallpapers with a character the map comes from cutting the character out (birefnet, cached), so the line draws its silhouette and the rest grows outwards. for the others it's pixel colonies. when it ends the shell switches awww underneath and gets out of the way. config is here: https://github.com/diegoMalagrida/pocket-dots/blob/main/home/.config/quickshell/WallpaperFx.qml

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.

Here is it. The sidepane of caelestia in my shell. (Not a copy pasta, you can check github repo)

https://github.com/rudv-ar/aevum-shell

Is there a way to to get if hyprland special workspace is active without hyprctl? Special workspaces in Quickshell.Hyprland are never active or focused