Arch LinuxでHyprland Waylandデスクトップ環境を構築するチュートリアル

Arch LinuxにHyprlandをインストールし、Waylandデスクトップ環境を構築する手順を解説。waybar、wofi、ドットファイル管理もカバー。

HyprlandWaylandArch Linuxwaybarwofiドットファイル2026/5/25

目標

このチュートリアルでは、Arch Linux上にHyprland Waylandコンポジターをインストールし、基本的なデスクトップ環境を構築します。waybar(ステータスバー)、wofi(アプリランチャー)、ドットファイル管理の基礎も学びます。最終的には、軽量でモダンなWaylandデスクトップが使えるようになります。

前提条件

  • Arch Linuxがインストール済みであること(ベースシステムでOK)
  • インターネット接続があること
  • 基本的なターミナル操作ができること
  • 非rootユーザーが存在し、sudo権限があること
  • Step-by-step

    1. システムの更新と必要なパッケージのインストール

    まずシステムを最新にし、Hyprlandと関連ツールをインストールします。

    sudo pacman -Syu
    sudo pacman -S hyprland waybar wofi git
    
  • hyprland: Waylandコンポジター本体
  • waybar: ステータスバー
  • wofi: アプリランチャー
  • git: ドットファイル管理に使用
  • 2. Hyprlandの設定ファイルを作成

    設定ファイルは ~/.config/hypr/hyprland.conf に配置します。

    mkdir -p ~/.config/hypr
    nano ~/.config/hypr/hyprland.conf
    

    最小限の設定例:

    <h1>モニター設定(例:1920x1080)</h1>
    monitor=,preferred,auto,1
    

    <h1>キーバインド</h1> bind=SUPER,Return,exec,foot bind=SUPER,D,exec,wofi --show drun bind=SUPER,Space,exec,wofi --show run bind=SUPER,Q,killactive,

    <h1>起動時に実行するアプリ</h1> exec-once=waybar

    注意: exec-once はHyprland起動時に一度だけ実行されます。exec は毎回実行。

    3. waybarの設定

    waybarの設定ファイルを作成します。

    mkdir -p ~/.config/waybar
    nano ~/.config/waybar/config.jsonc
    

    最小限の設定例:

    {
        "layer": "top",
        "position": "top",
        "modules-left": ["hyprland/workspaces"],
        "modules-center": ["clock"],
        "modules-right": ["pulseaudio", "network", "cpu", "memory", "tray"]
    }
    

    スタイル設定も必要です。

    nano ~/.config/waybar/style.css
    
    * {
        border: none;
        border-radius: 0;
        font-family: "sans-serif";
        font-size: 13px;
        min-height: 0;
    }
    

    window#waybar { background: rgba(0, 0, 0, 0.8); color: white; }

    #workspaces button { padding: 0 5px; background: transparent; color: white; }

    #workspaces button.focused { background: #64727D; }

    4. wofiの設定(オプション)

    wofiの設定ファイルは ~/.config/wofi/config です。

    mkdir -p ~/.config/wofi
    nano ~/.config/wofi/config
    
    width=400
    height=300
    location=center
    show=drun
    

    5. ドットファイルの管理(Git)

    ドットファイルをGitで管理する例:

    cd ~
    git init dotfiles
    cd dotfiles
    cp -r ~/.config/hypr ~/.config/waybar ~/.config/wofi .
    git add .
    git commit -m "Initial dotfiles"
    

    リモートリポジトリにプッシュするには:

    git remote add origin <your-repo-url>
    git push -u origin main
    

    6. Hyprlandの起動

    ログインマネージャーを使わずに起動する場合、ターミナルから直接実行します。

    Hyprland
    

    または、~/.bash_profile に以下を追加して自動ログイン:

    if [ -z "${WAYLAND_DISPLAY}" ] && [ "$(tty)" = "/dev/tty1" ]; then
        exec Hyprland
    fi
    

    動作確認

  • Hyprlandが起動することを確認
  • SUPER+Return でターミナル(foot)が開く
  • SUPER+D でwofiのアプリランチャーが表示される
  • waybarが画面上部に表示され、ワークスペース、時計、音量などが表示される
  • ワークスペースを切り替えられる(SUPER+1 など、デフォルトで割り当てあり)

  • *この記事はArch Linuxを実機で日常運用しているSioが、実際のインストール・設定経験に基づいてAI生成コンテンツをレビュー・補完しています。btrfsサブボリュームとLUKS暗号化環境で検証済みです。*

    発展リソース

  • Hyprland Wiki
  • waybar GitHub
  • wofi GitHub
  • Arch Linux Hyprland インストールガイド
  • ドットファイル公開例: hyprland-dotfiles
  • これで、軽量でカスタマイズ可能なHyprlandデスクトップ環境が完成しました。さらにテーマやウィジェットを追加して、自分好みに調整してみてください。