---
title: Quickshell デスクトップシェル
url: https://doc.liz6.com/ja/tools/hyprland/03-quickshell
locale: ja
area: tools
tags:
- tools
- hyprland
date: null
modified: 2026-07-16
description: illogical-impulse ベースの Quickshell シェル —— 他人の rice が7万行あるとして、重要なのはレイヤー構造と色の由来だ。
---

# Quickshell デスクトップシェル

トップバー、サイドバー、コントロールセンター、通知などの「シェル」は [Quickshell](https://quickshell.outfoxxed.me) で実装しています。これは QML を使って Wayland デスクトップコンポーネントを記述できるツールです。私の環境は [illogical-impulse](https://github.com/end-4/dots-hyprland) (end-4 の dots、ディレクトリコード `ii`) をベースにしており、それを改変しています。

まず明確にしておきます：これは QML で7万行、900以上のファイルからなる巨大なコードベースで、その大半は私が書いたものではありません。したがって、私自身（そしてこの記事を読む人）にとって真に有用なのは、ファイルごとの解説ではなく、以下の2点です——「どのようにレイヤー構造が組まれているか」と「色がどこから来ているか」。この2つが分かれば、修正したいコンポーネントを順に追っていくことができます。

まず Quickshell 自体が提供する機能から説明します。Quickshell は **QML** (Qt の宣言的 UI 言語) を Wayland の layer-shell に接続します。これにより、「プロパティバインディング + シグナル」という宣言的な書き方で、トップバー、オーバーレイウィンドウ、ロック画面などのデスクトップレイヤーコンポーネントを記述できます。利点は**反応性**にあります——ある値が変化すると、それにバインドされた UI が自動的に再描画され、手動で更新ロジックを書く必要がありません。

その上で、ii の構造はデータを取得する `services` と UI を描画する `modules` の2層になっています。

- **services** はシステム状態を QML のシングルトンオブジェクトとしてカプセル化します。PipeWire（音量/デバイス）、NetworkManager（ネットワーク）、UPower（バッテリー）、MPRIS（再生中）などがそれぞれバインド可能なプロパティとして公開されます。
- **modules** はこれらの状態を宣言的にパネルやコントロールとして描画し、インタラクション（クリックやドラッグ）が発生すると service にコールバックを返します。

```qml
// 概要：システム音量に追従するスライダー
Slider {
    value: Pipewire.defaultSink.volume       // service のプロパティにバインド
    onMoved: Pipewire.defaultSink.volume = value  // インタラクションで値を書き戻す
}
```

したがって、トップバーに新しいウィジェットを追加する場合の手順は決まっています。modules 内で QML を記述し、対応する service からデータを取得してバインドするだけです。900以上のファイルの大半に触れる必要はありません。既存のコンポーネントを修正したい場合は、「どの service を参照しているか」を遡って調べればよいだけです。

色は Quickshell 自体で定義されておらず、matugen によって生成された `~/.local/state/quickshell/user/generated/colors.json` を読み込みます。そのため、壁紙を変更すると、シェル全体が [Ghostty](../ghostty.md) やロック画面とともに色を変更します（[matugen](04-waybar-theming.md) の記事を参照）。

Quickshell は Hyprland の起動時に自動的に起動され、常駐します。これはアップストリームの rice に追随する大規模なプロジェクトであるため、[chezmoi](../chezmoi.md) に組み込むことはしていません。アップストリームの更新に合わせて、ローカルで数カ所を修正する方が、7万行のコードを自分で管理するよりも楽だからです。