Uthman の dotfiles — Hyprland と Matugen による動的テーマ設定

Tool

概要

Uthman の dotfiles は、Arch Linux 上で Hyprland(Wayland コンポジット)を使うことを前提にした「最小限で動的」なデスクトップ設定集です。特徴は Matugen を利用した動的テーマ生成で、壁紙を変えると自動的にカラーを抽出して Waybar やその他のアプリの配色を更新します。Omarchy をベースにしており、既存の設定に上書きせずにレイヤーでカスタマイズできるよう構成されています。軽さと見た目の一貫性を両立したいユーザー向けのリポジトリです。

GitHub

リポジトリの統計情報

  • スター数: 18
  • フォーク数: 1
  • ウォッチャー数: 18
  • コミット数: 8
  • ファイル数: 10
  • メインの言語: CSS

主な特徴

  • Matugen による壁紙ベースの自動カラーパレット生成で UI を一括再着色
  • Hyprland(Wayland)を中心とした軽量構成、Waybar 等と連携
  • Omarchy を基盤にしたレイヤー型 dotfiles、既存環境への導入が容易
  • GNU Stow 互換の構成想定(.stow-local-ignore を配置)で管理がシンプル

技術的なポイント

このリポジトリの核は「動的テーマパイプライン」と「最小限の導入負荷」にあります。Matugen による画像解析で壁紙からカラーパレットを抽出し、その結果をテンプレート化された CSS や設定ファイルへ反映する仕組みを採っています。これにより壁紙変更がトリガーになり、Waybar や端末、ランチャー等が一貫した配色で自動更新されます。

設定の管理は Omarchy の思想に従い、デフォルト群に対してユーザ設定を上書き・追加する方式です。これにより upstream の更新を受け取りつつ個別調整が可能です。.stow-local-ignore の存在から GNU Stow を使った dotfiles 配置を想定しており、ホームディレクトリへのシンボリック展開で複数マシン間の同期が容易になります。主要設定は .config 以下に配置される想定で、Hyprland のコンフィグや Waybar の JSON/CSS、シェル初期化ファイル(.zshrc)などが含まれます。言語として CSS が主要になっているのは、Waybar やバー関連のスタイリングが CSS ベースで記述されているためです。

また、Hyprland のような Wayland 環境ではリロードスクリプトやシグナルを使って設定反映を行う必要があるため、テーマ変更時に関連プロセス(waybar、rofi/wofi、端末エミュレータ等)へ再読み込み命令を送る小さなユーティリティやスクリプトが併設されていることが多い構成です。こうした自動化により手作業を減らし、壁紙変更だけで UI 全体の見た目が同期されます。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .config: dir — Hyprland や Waybar 等の設定を置く想定のディレクトリ。テンプレートやカスタム設定が格納される
  • .gitignore: file — Git 管理から除外する項目を指定
  • .stow-local-ignore: file — GNU Stow 利用時の無視ルール。stow での展開制御に使う
  • .zshrc: file — シェル初期化ファイル。パスやエイリアス、テーマ適用スクリプトの起動設定を含む
  • Pictures: dir — 壁紙を保存するディレクトリ。Matugen に渡す画像を格納
  • screenshot.png: file — リポジトリのスクリーンショット(視覚的参照用)
  • README.md: file — プロジェクト概要と導入手順の説明
  • その他設定ファイル(例: waybar の CSS/JSON、hyprland の conf、テーマ生成スクリプトなど) …他 5 ファイル

想定ワークフロー例:

  1. Pictures に壁紙を置く/変更する
  2. Matugen を走らせてカラーパレットを生成する(または自動フックがトリガー)
  3. 生成された色値を利用して CSS / 設定テンプレートをレンダリング
  4. Waybar 等のプロセスに再読み込みシグナルを送り即時反映

この流れにより「壁紙を変えるだけでデスクトップ全体のトーンが揃う」体験が実現されています。

まとめ

Hyprland + Matugen による自動テーマ同期を手早く試せる、実用的な dotfiles 集です。

リポジトリ情報:

READMEの抜粋:

dotfiles

Arch Linux · Hyprland · Matugen — dynamic wallpaper-based theming

screenshot


What is this

A minimal, dynamic rice for Arch Linux using Hyprland as the compositor. Colors are generated automatically from any wallpaper via Matugen — change your wallpaper and every app recolors itself to match.

Built on top of Omarchy with custom configs layered over the defaults.

Stack:

  • WM: Hyprland (Wayland)
  • Bar: Waybar (gl…