WhateverGreen — macOS Tahoe対応フォーク

Library
WhateverGreen — macOS Tahoe対応フォーク

WhateverGreen — macOS Tahoe対応フォーク

macOS Tahoe向けに調整された「WhateverGreen」のフォーク。インストーラーやリカバリーモードでのKext読み込みを阻害する基礎システム検出を回避するための起動引数（例: wegdetectmode=norec / ignore / force）を提供し、Tahoe環境でのグラフィック関連の互換性問題を改善することを目的としています。シンプルな使い方の説明と起動引数ごとの挙動がREADMEにまとまっており、インストール時や復旧時でもWhateverGreenを強制的に初期化する手段を備えています。（約300字）

https://github.com/laobamac/WhateverGreen

概要

このリポジトリは「WhateverGreen」のmacOS Tahoe向けブランチ（フォーク）で、主にインストーラーやリカバリーモードでの起動時にWhateverGreenを確実に読み込ませるための仕組みを提供します。READMEでは簡潔に「小白一句话」として、リカバリやインストーラーでのブート時にブート引数を追加するだけで動作する旨が示されています。具体的には起動引数として wegdetectmode=norec を利用することで、基礎システム（bootbase.efi）検出時のブロックを回避してWhateverGreenを初期化し、グラフィック周りの互換性問題を緩和します。追加のモード（ignore / force 等）も用意され、状況に応じた挙動切替が可能です。

GitHub

リポジトリの統計情報

  • スター数: 8
  • フォーク数: 0
  • ウォッチャー数: 8
  • コミット数: 2
  • ファイル数: 1
  • メインの言語: 未指定

主な特徴

  • macOS Tahoe のインストーラー／リカバリーモードでWhateverGreenを読み込ませるための起動引数を提供
  • wegdetectmode の複数モード（norec / ignore / force）による挙動制御
  • 設定は起動引数のみでシンプルに適用可能
  • READMEのみの軽量リポジトリで取り回しが容易

技術的なポイント

WhateverGreenは本来macOS向けのグラフィックス互換性を提供するkext（カーネル拡張）で、GPUのドライバ挙動やFramebufferのパッチ、プロパティ注入などを行います。本フォークはTahoe環境に特化して、特に「いつ／どのフェーズでWhateverGreenをロードするか」を制御する点が技術的に重要です。

macOSのブートプロセスでは、インストーラーやリカバリーモードが起動する際にbootbase.efi（基礎システム）やサンドボックス的なチェックが入り、サードパーティのkextの読み込みが制限されることがあります。READMEにある起動引数（wegdetectmode=norec / ignore / force）は、この検出ロジックにフックして挙動を上書きするためのフラグと解釈できます。具体的な挙動は次の通りです：

  • wegdetectmode=norec: リカバリ検出を無効化し、リカバリやインストーラー環境でもWhateverGreenを初期化する。通常、インストーラーがkitのロードを抑制する場合に有効。
  • wegdetectmode=ignore: 基礎システム検出を完全に無視して常にWhateverGreenをロードする。norecの効果を覆す強制モードで、ログに “WhateverGreen: wegdetectmode=ignore detected” を出力する仕組みが示されています。
  • wegdetectmode=force: システム情報が見つからない場合でも初期化処理をスキップせず、最大限に強制ロードを行うモード（READMEの続きで詳細が示唆）。

これらのフラグは、カーネルまたはブートローダ段階での早期パッチ適用や条件分岐をトリガーするため、kextの注入タイミングや依存するOSコンポーネントの初期化順序に直接影響します。例えば、インストーラー環境でApple側の保護機構によりkextロードが阻まれている場合、detectモードを操作することでロードを強制し、GPU認識やFramebufferの初期化を実行させることができます。

注意点として、こうした「検出回避／強制ロード」はシステムの想定外の動作を引き起こす可能性があり、特に復旧／インストール環境では互換性や安定性のリスクがあります。READMEはシンプルな操作方法を示していますが、実運用では事前にログ確認やバックアップを行うこと、必要に応じてデバッグログを有効化して挙動を監視することを推奨します。本リポジトリ自体はREADME中心の軽量なため、より深いカスタマイズやビルドが必要な場合はオリジナルのWhateverGreenリポジトリや関連ドキュメントを参照する必要があります。

プロジェクトの構成

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

  • README.md: file

READMEには中国語（簡体字）での説明と起動引数の一覧、簡単な使い方が含まれており、フォークの意図（macOS Tahoe対応）と具体的なコマンド例が記載されています。コードやバイナリは含まれておらず、設定／利用ガイドに特化した内容です。

まとめ

macOS Tahoeのインストール／復旧時にWhateverGreenを強制的に動作させるためのシンプルなフォーク。起動引数で手軽に制御できる点が有用です。

リポジトリ情報：

READMEの抜粋：

WhateverGreen

适用于macOS Tahoe的WhateverGreen分支。

小白一句话

修复macOS Tahoe及以上的安装器、恢复模式引导，在启动参数添加：

wegdetectmode=norec

额外的启动参数

（READMEには wegdetectmode=ignore や wegdetectmode=force 等の詳細が続きます）