DEV Community

Cover image for Quickshell: construa seu próprio desktop no Linux
Marcos Oliveira
Marcos Oliveira

Posted on

Quickshell: construa seu próprio desktop no Linux

Em vez de depender de soluções prontas (Waybar, Polybar, ...), você cria o seu próprio.


O Quickshell é um toolkit moderno feito com C++ para criar componentes de interface de desktop — barras, widgets, lock screens, launchers e até ambientes completos — usando QtQuick + QML.

  • Não é um "programa de barra".
  • Também não é um desktop completo pronto.

É uma base para construir um desktop customizado, rodando junto com um compositor como Hyprland, Sway ou i3.

Na prática, ele substitui várias peças:

  • barra (status bar)
  • notificações
  • widgets
  • lockscreen
  • display manager
  • controles de sistema

Exemplo

O Quickshell usa:

  • QtQuick (UI)
  • QML (configuração/programação)
  • Hot reload (salvou → atualizou na hora) ([Quickshell][2])

Exemplo simples (barra):

PanelWindow {
  anchors {
    top: true
    left: true
    right: true
  }

  implicitHeight: 30

  Text {
    anchors.centerIn: parent
    text: "hello world"
  }
}
Enter fullscreen mode Exit fullscreen mode

Integrações nativas:

Um dos pontos fortes é já vir integrado com o sistema:

  • Wayland + X11 (windowing)
  • Hyprland, i3, Sway (workspaces)
  • PipeWire (áudio)
  • BlueZ (Bluetooth)
  • UPower (bateria)
  • MPRIS (players de mídia)
  • system tray padrão

Isso elimina muito boilerplate.


Instalação

  • Arch Linux / EndeavourOS / Manjaro
yay -S quickshell
### Ou
paru -S quickshell
Enter fullscreen mode Exit fullscreen mode

Ou construa do zero em qualquer sistema:

Dependências:

sudo apt install cmake ninja-build qt6-base-dev qt6-declarative-dev \
qt6-wayland wayland-protocols libpipewire-0.3-dev \
libdbus-1-dev libxkbcommon-dev
Enter fullscreen mode Exit fullscreen mode

Clone:

git clone https://github.com/quickshell-mirror/quickshell.git
cd quickshell
Enter fullscreen mode Exit fullscreen mode

Construa:

cmake -B build -G Ninja
cmake --build build
Enter fullscreen mode Exit fullscreen mode

Instale:

sudo cmake --install build
Enter fullscreen mode Exit fullscreen mode

Rode:

quickshell
Enter fullscreen mode Exit fullscreen mode

Configuração:

~/.config/quickshell/main.qml
Enter fullscreen mode Exit fullscreen mode

Exemplo mínimo:

import QtQuick
import Quickshell

PanelWindow {
    anchors.top: true
    anchors.left: true
    anchors.right: true
    implicitHeight: 30

    Text {
        anchors.centerIn: parent
        text: "Quickshell funcionando"
    }
}
Enter fullscreen mode Exit fullscreen mode
  • Funciona melhor em Wayland (Hyprland, Sway, etc.)
  • Em X11 pode ser limitado
  • Ainda está em desenvolvimento → bugs são normais
  • Sem config = tela vazia

Para mais informações acesse o repositório.


Aprenda Qt

https://terminalroot.com.br/qt

Aprenda C++ Completo

https://terminalroot.com.br/promo

Top comments (0)