> For the complete documentation index, see [llms.txt](https://hacking-notes.jord4n.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hacking-notes.jord4n.pro/ja/useful-resources/gh0stzk-bspwm-dotfiles.md). # BSPWM を使った Arch Linux ハッカー環境構築 gh0stzk の BSPWM dotfiles、迅速なインストール、テーマ、Polybar、Rofi、ZSH、Neovim、コマンド、キーボードショートカットを含む Arch Linux ハッカー環境構築ガイド。 [gh0stzk/dotfiles](https://github.com/gh0stzk/dotfiles) Arch Linux および Arch ベースのディストリビューション向けの、完全な BSPWM デスクトップ環境です。テーマ、バー、ランチャー、ターミナル設定、ZSH、Neovim、Rofi のアプレット、壁紙、そしてスタイルをすばやく切り替えるための補助スクリプトが含まれています。
gh0stzk BSPWM dotfiles desktop screenshot with terminal and Linux fetch output

プロジェクトの README にある BSPWM デスクトップ環境の例。

{% hint style="warning" %} これは個人の検証用マシン、または新しい Linux ワークステーションにのみインストールしてください。Dotfiles は多くのユーザー設定ファイルを置き換えるため、実行前にインストーラーを確認し、現在の環境をバックアップしてください。 {% endhint %} ## どこに当てはまるか これは `役立つリソース` ワークステーションのセットアップ用リソースであり、ペンテストツールではないからです。日々のメモ、ラボ、CTF 作業、開発、ターミナル中心のワークフローに、クリーンな Arch ベースの BSPWM 環境が欲しいときに使ってください。 ## 得られるもの | コンポーネント | 意味 | | ---------- | ----------------------------------------------------------- | | BSPWM | 高速でキーボード操作中心のデスクトップ向けタイル型ウィンドウマネージャー。 | | 18 個のテーマ | その場で切り替えられる、あらかじめ用意されたビジュアルスタイル。 | | Polybar | ワークスペース、モジュール、システム情報、テーマカラーを備えたデスクトップバー。 | | Rofi アプレット | アプリ、電源、スクリーンショット、クリップボード、ネットワーク、Bluetooth、壁紙などのメニュー。 | | ターミナル | Alacritty、Kitty、Ghostty、ST、Xfce Terminal 向けのテーマ対応。 | | ZSH 設定 | 補完、履歴検索、fzf-tab のプレビューを備えた高速なシェル設定。 | | Neovim 設定 | LSP、補完、フォーマット、エクスプローラー、ステータスライン、ダッシュボードを備えた、事前構築済みのエディター設定。 | | RiceEditor | 設定ファイルを 1 つずつ手動で編集せずに、見た目の設定を調整するための補助アプリ。 | ## ビジュアルプレビュー このプロジェクトは非常にビジュアル重視なので、インストール前にスクリーンショットとデモを確認してください。
gh0stzk dotfiles theme selector screenshot

テーマセレクター。

gh0stzk dotfiles wallpaper selector screenshot

壁紙セレクター。

gh0stzk dotfiles RiceEditor screenshot

テーマをカスタマイズするための RiceEditor。

### プロジェクトのデモ {% embed url="" %} ### Arch インストール手順 この制作者動画は、dotfiles を適用する前にクリーンな Arch をインストールしたい場合に役立ちます。 {% embed url="" %} ### プロジェクトチャンネル 作者のチャンネルには、BSPWM、Polybar、Eww、Rofi、テーマのデモがさらにあります。 {% embed url="" %} ## インストール前に 公式インストーラーは Arch Linux および Arch ベースのディストリビューション向けです。README には、Artix などの systemd 以外のディストリビューションはサポートされていないと記載されています。 推奨される開始点: | 要件 | メモ | | ----------------------------- | ------------------------------------------- | | Arch または Arch ベースのディストリビューション | 新規インストールが最も安全です。 | | 通常のユーザーアカウント | インストーラーを root で実行しないでください。 | | 動作するインターネット接続 | インストーラーはパッケージとリポジトリをダウンロードします。 | | ログインマネージャー | このプロジェクトでは LightDM が推奨されています。 | | NetworkManager | Rofi のネットワークアプレットに必要です。 | | バックアップ | 既存のもののコピーを `~/.config` およびシェルファイルを保存してください。 | テスト前に役立つバックアップコマンド: ```bash mkdir -p "$HOME/dotfiles-backup" cp -a "$HOME/.config" "$HOME/dotfiles-backup/config-$(date +%F)" 2>/dev/null cp -a "$HOME/.zshrc" "$HOME/.gtkrc-2.0" "$HOME/.icons" "$HOME/dotfiles-backup/" 2>/dev/null ``` ## 高速 Arch セットアップ クリーンな Arch マシンまたは VM から始めて、できるだけ短い実用的な手順で進めたいときに使ってください。 ### 1. Arch ISO で起動 公式の Arch ISO から開始します。Wi‑Fi を使う場合は、先に接続してください: ```bash iwctl ``` 内部で `iwctl`: ``` device list station wlan0 scan station wlan0 get-networks station wlan0 connect "SSID" exit ``` インターネット接続を確認: ```bash ping -c 3 archlinux.org ``` 時刻を同期: ```bash timedatectl set-ntp true ``` ### 2. Arch を素早くインストール 最短ルートは `archinstall`: ```bash archinstall ``` 推奨される選択: | オプション | 選択: | | --------- | ---------------------------------------------------------------------------- | | ディスクレイアウト | VM/ディスクに応じて、デフォルトまたは手動。 | | ブートローダー | `systemd-boot` UEFI 向けです。必要なら GRUB でも構いません。 | | プロファイル | Minimal で十分です。デスクトップは任意です。 | | Network | NetworkManager。 | | オーディオ | PipeWire。 | | ユーザー | sudo 権限のある通常ユーザーを作成します。 | | 追加パッケージ | `git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager` | インストール後: ```bash 再起動 ``` ### 3. 基本機能を有効化 通常ユーザーでログインし、基盤サービスが準備できていることを確認します: ```bash sudo pacman -Syu sudo pacman -S --needed git curl base-devel xorg-server lightdm lightdm-gtk-greeter networkmanager sudo systemctl enable --now NetworkManager sudo systemctl enable lightdm ``` LightDM を有効にしたばかりなら、もう一度再起動してください: ```bash sudo reboot ``` ## Dotfiles のインストール ホームディレクトリからターミナルを開きます: ```bash cd "$HOME" ``` 公式インストーラーをダウンロードします: ```bash curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller ``` 実行する前にインストーラーを確認します: ```bash less RiceInstaller ``` 実行権限を付与します: ```bash chmod +x RiceInstaller ``` 通常ユーザーで実行します: ```bash ./RiceInstaller ``` インストーラーは対話式です。付属の Neovim や Firefox の設定を使うかどうかを尋ねられる場合があります。すべてを Enter 連打で進めず、各プロンプトを読んでください。 ### ワンブロックインストール すでに動作する Arch がある状態で、ラボ用に素早くインストールしたいとき: ```bash cd "$HOME" curl -LO http://gh0stzk.github.io/dotfiles/RiceInstaller less RiceInstaller chmod +x RiceInstaller ./RiceInstaller ``` ## インストーラーが行うこと 大まかには、インストーラーは次のことを行います: 1. root で実行されていないことを確認します。 2. 次の場所から実行されていることを確認します `$HOME`. 3. 以下を追加します: `gh0stzk-dotfiles` パッケージリポジトリ。 4. Chaotic-AUR を追加します。 5. dotfiles をダウンロードします。 6. 必要に応じて既存のユーザー設定をバックアップします。 7. BSPWM 環境をインストールします。 8. 音楽機能のために MPD を有効にします。 9. シェルを ZSH に変更します。 このスクリプトは、置き換える前に多くの既存の設定フォルダをバックアップ用ディレクトリへ移動します。それでも、まずは自分でバックアップを取っておいてください。 ## 初回ログイン インストール後: 1. 再起動するか、ログアウトします。 2. ログインマネージャーで BSPWM セッションを選択します。 3. 通常どおりログインします。 4. 初回起動の自動設定が終わるまで待ちます。 5. ターミナル、Rofi、Polybar、テーマセレクター、壁紙セレクターを確認します。 仮想マシン上でデスクトップが壊れているように見える、または遅い場合は、Picom を `glx` に `xrender` に変更してから、インストール失敗を疑ってください。 ## 最初に確認すること 初回起動後、ハードウェア関連の変数を確認してください。次を開きます: ```bash ~/.config/bspwm/config/system.ini ``` 次の値を確認します: | 値 | 重要な理由 | | -------------- | ------------------------- | | ネットワークインターフェース | バーのネットワークモジュール。 | | グラフィックカード | 一部のビジュアルモジュールやステータスモジュール。 | | バッテリーとアダプター | ノート PC のバッテリーと明るさのモジュール。 | デスクトップ PC の場合、通常はネットワークインターフェースが主に確認すべき項目です。 ## 便利なコマンド | コマンド | 使用する | | ----------------------------------- | --------------------------- | | `RiceSelector` | テーマセレクターを開きます。 | | `RiceEditor` | 現在のテーマを視覚的に編集します。 | | `WallSelect` | 壁紙セレクターを開きます。 | | `Term --selecterm` | ターミナルアプリを選択します。 | | `OpenApps --menu` | アプリランチャーを開きます。 | | `OpenApps --KeyHelp` | キー割り当てのチートシートを開きます。 | | `OpenApps --screenshot` | スクリーンショットツールを開きます。 | | `OpenApps --netmanager` | ネットワークマネージャーのアプレットを開きます。 | | `OpenApps --bluetooth` | Bluetooth アプレットを開きます。 | | `OpenApps --clipboard` | クリップボードマネージャーを開きます。 | | `OpenApps --powermenu` | 電源メニューを開きます。 | | `OpenApps --keyboard` | キーボードレイアウトのアプレットを開きます。 | | `OpenApps --scratch` | スクラッチパッドを開きます。 | | `HideBar -h` | バーを隠します。 | | `HideBar -u` | バーを表示します。 | | `SoftReload` | 環境をソフトリロードします。 | | `ScreenLocker` | 画面をロックします。 | | `bspc wm -r` | BSPWM を再読み込みします。 | | `pkill -USR1 -x sxhkd` | キー割り当てを再読み込みします。 | | `~/.config/bspwm/config/system.ini` | インストール後に確認するハードウェア/モジュール変数。 | | `~/.config/bspwm/config/sxhkdrc` | メインのキー割り当てファイル。 | ## 完全なキー割り当て プロジェクトでは、 `Alt + F1`. `Super` は、多くのキーボードでは Windows キーを意味します。信頼できる元情報はインストール済みの `~/.config/bspwm/config/sxhkdrc`；この表は現在の upstream ファイルに従っており、すべてのショートカットを見やすくグループ化しています。 ### ヘルプ | キー | 操作 | | ---------- | -------------------- | | `Alt + F1` | キー割り当てのチートシートを表示します。 | ### 主なアプリ | キー | 操作 | | ---------------------- | ---------------------- | | `Super + Return` | 通常のターミナルを開きます。 | | `Super + Alt + Return` | フローティングターミナルを開きます。 | | `Super + Space` | アプリランチャーを開きます。 | | `Alt + Space` | テーマセレクターを開きます。 | | `Super + B` | ブラウザを開きます。 | | `Super + E` | エディターを開きます。 | | `Super + F` | ファイルマネージャーを開きます。 | | `Super + Y` | Yazi を開きます。 | | `Super + V` | Neovim を開きます。 | | `Super + M` | 音楽プレーヤー/Ncmpcpp を開きます。 | | `Super + P` | Pavucontrol を開きます。 | | `Super + T` | Telegram を開きます。 | | `Super + W` | WhatsApp を開きます。 | | `Super + R` | RiceEditor を開きます。 | ### Rofi アプレット | キー | 操作 | | ----------------- | --------------------- | | `Super + Alt + T` | ターミナルセレクター。 | | `Super + Alt + W` | 壁紙セレクター。 | | `Super + Alt + A` | Android マウント用アプレット。 | | `Super + Alt + N` | ネットワークマネージャー。 | | `Super + Alt + B` | Bluetooth マネージャー。 | | `Super + Alt + C` | クリップボードマネージャー。 | | `Super + Alt + S` | スクリーンショットツール。 | | `Super + Alt + P` | 電源メニュー。 | | `Super + Alt + L` | Rofi ランチャースタイルセレクター。 | | `Super + Alt + K` | キーボードレイアウトのアプレット。 | | `Super + Alt + X` | RofiPass/パスワード用アプレット。 | | `デスクトップを右クリック` | Jgmenu を開きます。 | ### システムと環境 | キー | 操作 | | ------------------------ | ------------------------- | | `Super + Alt + O` | スクラッチパッド。 | | `Ctrl + Super + Alt + P` | コンピューターの電源を切ります。 | | `Ctrl + Super + Alt + R` | コンピューターを再起動します。 | | `Ctrl + Super + Alt + Q` | ログアウトします。 | | `Ctrl + Super + Alt + L` | 画面をロックします。 | | `Ctrl + Super + Alt + K` | 次のアプリを終了: `xkill`. | | `Ctrl + Super + Alt + S` | ソフトリロードします。 | | `Super + Alt + H` | バーを隠します。 | | `Super + Alt + U` | バーを表示します。 | | `Ctrl + Alt + Plus` | フォーカス中のウィンドウの透明度を上げます。 | | `Ctrl + Alt + Minus` | フォーカス中のウィンドウの透明度を下げます。 | | `Ctrl + Alt + T` | フォーカス中のウィンドウの透明度をリセットします。 | | `XF86MonBrightnessUp` | 明るさを上げます。 | | `XF86MonBrightnessDown` | 明るさを下げます。 | | `XF86AudioRaiseVolume` | 音量を上げます。 | | `XF86AudioLowerVolume` | 音量を下げます。 | | `XF86AudioMute` | ミュートを切り替えます。 | | `XF86AudioNext` | 次のメディアトラック。 | | `XF86AudioPrev` | 前のメディアトラック。 | | `XF86AudioPlay` | メディアを再生/一時停止します。 | | `XF86AudioStop` | メディアを停止。 | ### BSPWMの基本 | キー | 操作 | | ------------------- | -------------------- | | `Super + Alt + R` | BSPWM を再読み込みします。 | | `Super + X` | フォーカス中のノードを閉じる。 | | `Super + Shift + X` | フォーカス中のノードを強制終了する。 | | `Super + Escape` | sxhkd のキーバインドを再読み込み。 | ### ノードの状態とフラグ | キー | 操作 | | ----------------- | ------------------------ | | `Alt + T` | ノードをタイル表示に設定。 | | `Alt + Shift + T` | ノードを疑似タイル表示に設定。 | | `Alt + A` | ノードをフローティングに設定。 | | `Alt + F` | ノードをフルスクリーンに設定。 | | `Alt + M` | マークフラグを切り替える。 | | `Alt + X` | ロックフラグを切り替える。 | | `Alt + S` | スティッキーフラグを切り替える。 | | `Alt + P` | プライベートフラグを切り替える。 | | `Alt + H` | フォーカス中のウィンドウを隠す。 | | `Ctrl + Alt + H` | 隠したウィンドウを復元するためのメニューを表示。 | ### ワークスペースとフォーカス | キー | 操作 | | --------------------------------------- | ------------------------------- | | `Ctrl + Tab` | デスクトップを回転する。 | | `Super + Left` | 前のワークスペースに切り替える。 | | `Super + Right` | 次のワークスペースに切り替える。 | | `Super + 1` に `Super + 9` | ワークスペース1〜9にフォーカスを移動。 | | `Super + 0` | ワークスペース10にフォーカスを移動。 | | `Super + Ctrl + 1` に `Super + Ctrl + 9` | フォーカス中のウィンドウをワークスペース1〜9へ送る。 | | `Super + Ctrl + 0` | フォーカス中のウィンドウをワークスペース10へ送る。 | | `Super + Ctrl + Left` | フォーカス中のウィンドウを前のワークスペースへ送って追従する。 | | `Super + Ctrl + Right` | フォーカス中のウィンドウを次のワークスペースへ送って追従する。 | | `Alt + Tab` | ウィンドウ切り替え。 | | `Super + Alt + Left` | 西のウィンドウにフォーカス、なければ前へ。 | | `Super + Alt + Down` | 南のウィンドウにフォーカス。 | | `Super + Alt + Up` | 北のウィンドウにフォーカス。 | | `Super + Alt + Right` | 東のウィンドウにフォーカス、なければ次へ。 | | `Ctrl + Alt + Left` | フォーカス中のウィンドウを西へ入れ替える。 | | `Ctrl + Alt + Down` | フォーカス中のウィンドウを南へ入れ替える。 | | `Ctrl + Alt + Up` | フォーカス中のウィンドウを北へ入れ替える。 | | `Ctrl + Alt + Right` | フォーカス中のウィンドウを東へ入れ替える。 | | `Ctrl + Shift + Comma` | 最後のノードにフォーカス。 | | `Ctrl + Shift + Period` | 最後のデスクトップにフォーカス。 | ### 事前選択 | キー | 操作 | | ------------------ | ------------ | | `Super + Ctrl + H` | 水平/東分割を事前選択。 | | `Super + Ctrl + V` | 垂直/南分割を事前選択。 | | `Super + Ctrl + Q` | 事前選択をキャンセル。 | ### 移動とリサイズ | キー | 操作 | | ----------------------- | ------------------ | | `Super + Ctrl + B` | デスクトップ内のノードを均等化。 | | `Super + Alt + Plus` | タイル表示ノードのサイズを拡大。 | | `Super + Alt + Minus` | タイル表示ノードのサイズを縮小。 | | `Super + Ctrl + Plus` | フローティングノードのサイズを拡大。 | | `Super + Ctrl + Minus` | フローティングノードのサイズを縮小。 | | `Super + Shift + Left` | フローティングウィンドウを左へ移動。 | | `Super + Shift + Down` | フローティングウィンドウを下へ移動。 | | `Super + Shift + Up` | フローティングウィンドウを上へ移動。 | | `Super + Shift + Right` | フローティングウィンドウを右へ移動。 | ### 複数操作 | キー | 操作 | | ------------------------ | --------------------------------- | | `Super + Ctrl + X` | 現在のデスクトップ内のすべてのノードを閉じる。 | | `Super + N`、次に `X` | フォーカスのないローカルウィンドウをすべて閉じる。 | | `Super + N`、次に `K` | フォーカスのないローカルウィンドウをすべて強制終了する。 | | `Super + N`、次に `M` | マークされたすべてのウィンドウをフォーカス中のデスクトップへ移動。 | | `Super + N`、次に `1` に `9` | そのデスクトップのすべてのウィンドウを現在のデスクトップへ移動。 | ## 一般的なカスタマイズ ### テーマを変更 使用方法: ``` Alt + Space ``` セレクターからテーマを選択します。環境はセッション全体を再起動しなくても更新されます。 ### 壁紙を変更 使用方法: ``` Super + Alt + W ``` このプロジェクトは、ランダム壁紙、任意のディレクトリ、固定壁紙、アニメーション壁紙、スライドショー動作をサポートしています。 ### 現在のテーマを編集 各モジュールを手作業で編集せずに外観設定を調整したいときは RiceEditor を使います: ``` RiceEditor ``` 典型的な編集項目には、枠線、影、アニメーション、透明度、壁紙の挙動、テーマ固有のモジュール設定が含まれます。 ## トラブルシューティング | 問題 | 確認すること | | ---------------------- | --------------------------------------------------------------- | | ログインするとディスプレイマネージャーに戻る | BSPWM セッションがインストールされていることを確認し、 `~/.xsession-errors`. | | バーのモジュールが正しくない | 確認 `~/.config/bspwm/config/system.ini`. | | ネットワークアプレットが動作しない | NetworkManager がインストールされ、実行中であることを確認してください。 | | 仮想マシンのグラフィックが崩れて見える | Picom を試す `xrender` の代わりにバックエンド `glx`. | | キーボードショートカットが効かない | 確認 `sxhkd` が実行中であることを確認し、 `~/.config/bspwm/config/sxhkdrc`. | | テーマの配置がずれて見える | このプロジェクトは 1600x900 と 96 DPI を前提に設計されています。お使いのモニターに合わせて調整してください。 | | 既存の設定が消えた | インストーラーが作成したバックアップフォルダーと、あなた自身の `dotfiles-backup`. | ## クリーン再インストールの注意 最も安全に再試行するには: 1. 現在のファイルをバックアップする。 2. 古い dotfiles ディレクトリを削除するか移動する。 3. 最新版を再ダウンロードする `RiceInstaller`. 4. スクリプトをもう一度確認する。 5. から実行する `$HOME` 通常ユーザーとして。 差分を確認していない限り、サードパーティのフォークにある無作為な改変版インストーラーは実行しないでください。 ## 参考資料 * [gh0stzk/dotfiles 公式リポジトリ](https://github.com/gh0stzk/dotfiles) * [RiceInstaller](https://github.com/gh0stzk/dotfiles/blob/master/RiceInstaller) * [インストール後の最初の手順](https://github.com/gh0stzk/dotfiles/wiki/First-steps-after-installation) * [キーボードショートカットの wiki](https://github.com/gh0stzk/dotfiles/wiki/Keyboard-Shortcuts) * [現在の sxhkdrc キーバインドファイル](https://github.com/gh0stzk/dotfiles/blob/master/config/bspwm/config/sxhkdrc) * [壁紙設定の wiki](https://github.com/gh0stzk/dotfiles/wiki/Wallpapers-Configuration) * [ArchWiki: bspwm](https://wiki.archlinux.org/title/Bspwm) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://hacking-notes.jord4n.pro/ja/useful-resources/gh0stzk-bspwm-dotfiles.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.