[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94251":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":14,"stars7d":14,"stars30d":14,"stars90d":13,"forks30d":13,"starsTrendScore":15,"compositeScore":16,"rankGlobal":8,"rankLanguage":8,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":18,"topics":21,"createdAt":8,"pushedAt":8,"updatedAt":22,"readmeContent":23,"aiSummary":8,"trendingCount":13,"starSnapshotCount":13,"syncStatus":12,"lastSyncTime":24,"discoverSource":25},94251,"PNGAL","1mm-module\u002FPNGAL","1mm-module",null,"Python",300,38,2,0,47,141,86.4,"Other",false,"main",true,[],"2026-08-05 04:02:26","# PNGAL\n\n**日本語** | [English](README_EN.md)\n\n**PNGAL‐ui-ver0.44.03g**\n\nPNGALは、透過PNGまたはPhotoshop互換PSDから、ゲーム用の立ち絵アニメーション素材を作るWindows向けローカルツールです。\n\nPSDのレイヤーを動かして目パチ・口パク・揺れを設定し、PSD、WebM、MP4、GIF、スプライトシートを書き出せます。音声入力、カメラ追従、マウス追従は行いません。\n\n![PNGAL](thumbnail.png)\n\n## 対応データ\n\n- 入力: 背景のない透過PNG、Photoshop互換PSD\n- 出力: PSD、WebM、MP4、GIF、スプライトシート + JSON\n- 推奨ブラウザ: Google Chrome \u002F Microsoft Edge\n- 対応環境: 64bit版Windows\n\nPSDは8bit RGB\u002FRGBAのラスターレイヤーを推奨します。テキスト、調整レイヤー、スマートオブジェクト、複雑なレイヤースタイル、他アプリ固有のレイヤー情報は正しく再現できない場合があります。\n\n## 必要環境と空き容量\n\n### 必須環境\n\n- 64bit版Windows 10またはWindows 11\n- Google ChromeまたはMicrosoft Edge\n- 初回セットアップとモデル取得に使用するインターネット接続\n- PNGALを展開したフォルダへの書き込み権限\n- メモリ: 32GB以上\n\n### GPU\n\nCUDA対応のNVIDIA GPUと12GB以上のVRAMが必要です。下限対象はRTX 3060 12GBです。セットアップはGPU、VRAM、メインメモリ、空き容量をモデル取得前に確認し、CUDA 12.8用PyTorchを導入します。\n\n### 必要容量の目安\n\n| 内容 | 容量の目安 | 区分 |\n|---|---:|---|\n| PNGAL本体 | 5MB未満 | 必須 |\n| ポータブルPythonとMinGit | 300MB未満 | 必須 |\n| PNGAL、ComfyUI、see-throughのPython環境とPyTorch | 15～25GB | 必須 |\n| RIFE v4.25モデル | 約23MB | 必須 |\n| Qwen Image Edit 2511 FP8 + GGUF一式 | 約46.3GB | 必須 |\n| 任意追加モデル | モデルによる | 使用者が任意で手動導入 |\n| see-throughの必須資産（モデル2件とscheduler設定） | 約12.6GB | 必須 |\n| see-throughの作業データ、出力 | 数GB～数十GB | 使用時に追加 |\n\nクリーンセットアップには**90GiB以上の空き容量**が必要です。Qwen FP8 + GGUF約46.3GBとsee-through約12.6GBを含むモデル取得量は約58.9GBです。PSD作業データ、動画出力、将来の更新には追加容量が必要です。\n\n## 初回セットアップ\n\n初めて使うときだけ、インターネットに接続した状態で次の操作を行います。\n\n1. 配布ZIPを任意のフォルダへ展開します。\n2. 展開したフォルダの `setup.bat` をダブルクリックします。\n3. 画面の案内に従ってセットアップを完了します。\n4. セットアップ完了後、`start.bat` を実行してPNGALを起動します。\n\nセットアップは、ポータブルPython、MinGit、PNGAL用Python環境、固定版ComfyUI、ComfyUI-GGUF、RIFE、see-through、Qwen FP8 + GGUF一式、see-through必須資産をPNGAL直下の `environment` フォルダへ導入します。モデル取得は再開可能で、取得後にサイズとSHA-256を検証します。see-throughのモデル2件とscheduler設定はオフラインで解決できることも確認します。初回の顔差分生成やPSD分割で追加ダウンロードは行いません。システムのPATH、レジストリ、既存のPython、Git、ComfyUIは変更しません。\n\n外部通信を行える入口は `setup.bat` だけです。通常のPNGAL、ComfyUI、see-throughはloopback通信だけを許可し、ComfyUIはAPI nodesを無効化して起動します。Setup補助スクリプトは直接実行できません。環境不足の案内が出た場合も、復旧には `setup.bat` を再実行してください。\n\n### セットアップで導入されるファイル\n\nセットアップで導入する環境はPNGALフォルダ内にまとめます。\n\n```text\nPNGAL\u002F\n  models\u002F\n    diffusion_models\u002F         使用者が手動配置する任意モデル\n  environment\u002F\n    tools\u002F\n      mingit\u002F                 ポータブルGit\n      python312\u002F              ポータブルPython 3.12\n    venvs\u002F\n      pngal-3.12\u002F             PNGAL用Python環境\n    ComfyUI-pngal-0.28.0\u002F\n      venv\u002F                   ComfyUI用Python環境\n      custom_nodes\u002F\n        ComfyUI-GGUF\u002F         Setupで取得する固定版GGUFノード\n      models\u002F\n        diffusion_models\u002F     Qwen Q3_K_S画像編集モデル\n        text_encoders\u002F        Qwen Q4_K_Mエンコーダーとmmproj\n        vae\u002F                  Qwen VAE\n        frame_interpolation\u002F  RIFEモデル\n    see-through-pngal-58a1cb11\u002F\n      .venv\u002F                  see-through用Python環境\n    cache\u002F                    PNGAL専用のダウンロード・モデルキャッシュ\n    config-generations\u002F       Setup世代ごとの起動設定\n    active-config.txt         現在使用する設定世代\n    pngal-setup-receipt.json  モデル・リポジトリ・依存関係の受領証\n  runtime\u002F                    ログと一時作業ファイル\n```\n\n導入内容は次のとおりです。\n\n- ポータブルPython 3.12.10とpip\u002Fvirtualenv\n- ポータブルMinGit\n- PNGAL依存パッケージ: Pillow、NumPy、OpenCV、psd-tools\n- ComfyUI本体と専用Python環境\n- CUDA 12.8用PyTorch、torchvision、torchaudio\n- ComfyUI標準のフレーム補間機能とRIFE v4.25\n- see-through本体と専用Python環境\n- Qwen Image Edit 2511のFP8一式、ComfyUI-GGUF、Q3_K_S一式\n- PNGALと内部環境を接続する世代管理された設定ファイル\n\n### 導入するモデルファイル\n\n| 保存先 | ファイル | 容量の目安 | 区分 |\n|---|---|---:|---|\n| `environment\u002FComfyUI-pngal-0.28.0\u002Fmodels\u002Fframe_interpolation` | `rife_v4.25.safetensors` | 22.7MB | 必須 |\n| `environment\u002FComfyUI-pngal-0.28.0\u002Fmodels\u002Fdiffusion_models` | `qwen-image-edit-2511-Q3_K_S.gguf` | 約9.2GB | 必須 |\n| 同上 | `qwen_image_edit_2511_fp8mixed.safetensors` | 約20.5GB | 必須 |\n| `environment\u002FComfyUI-pngal-0.28.0\u002Fmodels\u002Ftext_encoders` | `Qwen2.5-VL-7B-Instruct-Q4_K_M.gguf` | 約4.7GB | 必須 |\n| 同上 | `Qwen2.5-VL-7B-Instruct-mmproj-F16.gguf` | 約1.35GB | 必須 |\n| 同上 | `qwen_2.5_vl_7b_fp8_scaled.safetensors` | 約9.38GB | 必須 |\n| `environment\u002FComfyUI-pngal-0.28.0\u002Fmodels\u002Fvae` | `qwen_image_vae.safetensors` | 約254MB | 必須 |\n| `environment\u002FComfyUI-pngal-0.28.0\u002Fmodels\u002Floras` | `Qwen-Image-Edit-2511-Lightning-4steps-V1.0-bf16.safetensors` | 約850MB | 必須 |\n| `models\u002Fdiffusion_models` | 使用者が任意に追加するモデル | モデルによる | 任意 |\n\nsee-throughの必須モデル2件とscheduler設定は `setup.bat` の実行中に全て取得し、PNGAL専用の `environment\u002Fcache` 内へ保存します。セットアップは全必須資産をオフラインで解決できることまで確認し、不足したまま完了しません。\n\nシステムのPATH、レジストリ、既存のPython、Git、ComfyUI、see-throughは変更しません。\n\nQwen FP8とGGUFの両方をSetupで必ず取得します。途中で中断した場合は、もう一度 `setup.bat` を実行すると `.part` ファイルから再開します。Setup完了後は顔差分モデル欄に両方が表示され、利用者が選択できます。\n\n### 任意のモデルを追加する\n\n必要なモデルをPNGAL内の `models\u002Fdiffusion_models` に配置してください。必要なファイルが揃ったモデルだけが、顔差分生成モデルの選択肢に表示されます。\n\nモデルは同梱されません。使用者自身で入手し、適用されるライセンスを確認してください。\n\nワークフローがないモデルは、別途対応したワークフローを `workflows` に作成してください。PNGALは対応形式のワークフローを読み込みますが、使用者が追加したワークフローの動作や出力品質は保証しません。\n\n## 通常起動\n\n2回目以降は `start.bat` をダブルクリックします。\n\nPNGALとComfyUIが自動で起動し、ブラウザで `http:\u002F\u002F127.0.0.1:7865` が開きます。ブラウザの起動まで完了すると、起動用の画面は自動で閉じます。起動に失敗した場合は画面が残るため、表示された案内を確認してください。\n\n全機能をすぐ再起動したい場合は、`restart.bat` をダブルクリックします。\n\n### 終了\n\nPNGALとComfyUIを完全に終了する場合は、PNGALフォルダの `stop.bat` をダブルクリックします。終了処理が完了すると、画面に完了メッセージが表示されます。\n\nブラウザのタブを閉じるだけでは、バックグラウンドのPNGALとComfyUIは終了しません。\n\n## 基本的な使い方\n\n### 同梱のLayer Editorを使う\n\nLayer EditorはPNGALに同梱されています。PNGALのZIPを展開すると、次の配置で利用できます。\n\n```text\nPNGAL\u002F\n  layer-editor\u002F\n    Layer editor.html\n```\n\nこのファイルがある場合だけ、レイヤー一覧の上に`Layer Editorで編集`ボタンが表示されます。ボタンは現在のPSDを別画面へ送り、Layer Editor側の`PNGALへ反映`で編集済みPSDを戻します。反映時はレイヤーアニメーション設定が初期値へ戻ります。反映に失敗した場合は、PNGALで使用中のPSDと設定を維持します。\n\n初回は注意画面が表示されます。`今後は表示しない`を選ぶと、次回以降の起動でも省略されます。\n\n### 1. 透過PNGまたはPSDを読み込む\n\n左上の読み込み欄へファイルをドロップするか、ファイル選択から読み込みます。\n\n- 透過PNG: 顔差分を作成し、see-throughでPSD分割してからアニメーションを設定します。\n- PSD: 既存レイヤーを直接読み込み、すぐにアニメーションを設定できます。\n\n### 2. 必要に応じて顔差分を用意する\n\n透過PNGから顔差分を生成する場合は、右のプレビュー上で目を緑、口を青のマスクで指定し、`マスク範囲の顔差分生成` を実行します。生成した差分は、PSD分割前に一覧で確認して使用するものを選べます。生成前に`追加表情`の選択欄から表情要素を1つ選べます。初期値の`なし`では従来のプロンプトを変更しません。\n\n`顔差分生成モデル` では、対応ワークフローと必要ファイルを確認できたモデルだけを追加選択できます。自動切替は行いません。\n\nPSDに目・口差分が含まれている場合は、そのレイヤーを素材として使用できます。高度なRIFE補間で使う端点名は次のとおりです。\n\n```text\neye_open\neye_close\nmouth_open\nmouth_close\n```\n\nPSD読み込み時は、`目開き`、`目閉じ`、`口開き`、`口閉じ`などの日本語レイヤー名も認識します。PSDから顔差分を再生成する場合は、開眼と開口のレイヤーを生成元として使用し、どちらかがない場合は生成できません。\n\n### 3. PNGをPSD分割する\n\n透過PNGを読み込んだ場合は、`分割PSDを作成` を実行します。選択した顔差分を含めたPSDも書き出せます。分割後は `分割PSDを再作成` から元PNGを使って再実行でき、前回のPSDとレイヤーは新しい結果へ置き換わります。\n\n画像により分割処理でレイヤーが消失してしまう場合があります。\n頻繁に消失してしまう場合は、新しい分割方法にチェックを入れて生成を試してください。\n\n分割比率は1:1、4:3、3:4、16:9、9:16から選択できます。比率を選ぶと、分割解像度に実際の幅×高さが表示されます。1:1は従来のsee-through処理を使います。長方形では、選択した分割解像度とほぼ同じ総画素数になるよう縦横サイズを調整します。\n\n出力されるPSDの画像位置はほぼ同一になるため、複数の分割結果を合成するとより希望に近いレイヤー構造になります。PNGALにはレイヤー合成機能はないため別途PSDを読み込み編集できるソフトウェアが必要です。\n\nPSDを最初から読み込んだ場合、この工程は不要です。\n\n### 4. レイヤーとアニメーションを調整する\n\n`レイヤーとアニメーション` で、次の項目をプレビューしながら調整します。\n\n- レイヤーの表示と前後順\n- レイヤー同士のリンク\n- 動きの種類、強さ、速度、方向、支点、範囲\n- レイヤー単位の独立した回転（表示中心を保持し、位置移動はアニメーション設定だけが制御。初期値OFF。1ループの整数回転数を指定し、負の値は逆回転）\n- レイヤー単位の出現・消失（個別にON\u002FOFFでき、その場または上下左右の方向、1～4倍の速度、出現・消失までのディレイをフレーム単位で指定。移動・回転・拡大縮小との同時使用に対応）\n- レイヤー単位の布揺れ（1～4倍速を選択し、プレビュー上で服の範囲を塗り、方向、プレビュー上でクリックする固定位置、強さ、柔らかさ、遅れを個別指定。複数レイヤーを別方向に設定でき、回転・拡大縮小とも併用可能）\n- レイヤー単位の独立した拡大縮小（表示中心を保持し、位置移動はアニメーション設定だけが制御。初期値OFF。ONでは30フレームで指定率まで拡大し、次の30フレームで元サイズへ戻る。回転との同時使用に対応）\n- 動き方向の `なし`（そのレイヤーの自動移動・揺れ・変形を停止。回転、拡大縮小、出現、消失をONにした場合は独立動作だけ再生）\n- 動き方向の `円運動（両側）` と `円運動（片側）`（支点を中心とした円弧上を、両側または可動範囲で選んだ片側へ往復）\n- 前髪・後ろ髪の左右／上下方向の揺れと、髪や衣装などの追従（前髪・後ろ髪は個別に1～4倍速を選択可能）\n- 目パチ、口パク、胸の動き（胸は1～4倍速を選択可能）\n- 再生する目・口形状とその並び順\n\n上部の再生ボタンで全体を確認できます。選択したレイヤーだけを再生して動きを確認することもできます。\n\n### 5. 高度な目パチ・口パクでRIFEを使う\n\nRIFEは、開いた画像と閉じた画像の間を補間して中間候補を作ります。新しい目や口をAIで描き直す処理ではありません。\n\nPNGALから実行したComfyUI生成が成功すると、再生成を速くするためモデルを2分間保持します。2分以内に再生成した場合は保持時間をその時点から数え直し、経過後にモデルとVRAMを解放します。失敗・タイムアウト時とPNGAL WebUI終了時は待たずに解放します。タイムアウト時は実行中Promptを中断・削除してから解放します。\n\n- 目: `eye_open` と `eye_close` の間を補間\n- 口: `mouth_open` と `mouth_close` の間を補間\n- 各カテゴリで17候補を作り、スライダーで確認して中間4枚を採用\n- 採用した画像だけをPSDや再生素材として使用\n- 候補系列そのものはPSD、設定TXT、再生状態へ保存しない\n\n口パク再生は、`再生する` にした確定画像を表示順に循環するだけです。再生中にRIFE生成や形状復元は行いません。母音判定や音声追従も行いません。\n\n### 6. 設定を保存する\n\n左メニューの `設定TXTを書き出す` で、レイヤー順、動き、リンク、目・口の再生順などを保存できます。次回は同じPSDを読み込んでから `設定TXTを読み込む` を使用してください。画像とアニメーション対象レイヤーが揃うまでは、誤反映を防ぐため両ボタンは無効です。\n\n### 7. 書き出す\n\n画面上部の `書き出し設定` を開き、比率、サイズ、形式を選びます。4:3と16:9のサイズ一覧では、横長サイズの後ろに3:4と9:16の縦長サイズがあります。`出力範囲指定` の通常の四隅ドラッグは選択比率を維持し、Shiftを押しながら四隅をドラッグすると自由な長方形に変更できます。枠は元画像・PSDキャンバスの外側にも移動・拡大でき、外側は選択中のキャンバス背景で書き出されます。設定後に `動画を書き出す` を実行します。\n\n- WebM \u002F MP4: 高品質な動画向け\n- GIF: 共有しやすい形式。ただし最大256色\n- スプライトシート + JSON: ゲームエンジン向け\n- PSD: 分割レイヤーと採用した顔差分を保持\n\n色と画質を優先する場合はWebMまたはMP4を推奨します。\n\n書き出したWebM、MP4、GIFには、映像の画素を変えずにPNGALのバージョン情報を保存します。確認するときは `書き出し設定` の `動画のバージョンを確認` から動画を選択してください。動画を加工または再エンコードすると、この情報が失われる場合があります。\n\n## PSDの推奨レイヤー名\n\n顔差分をPSDへ用意する場合は `face_variants` グループ内へ配置することを推奨します。\n\n```text\nface_variants\u002F\n  eye_open\n  eye_close\n  mouth_open\n  mouth_close\n```\n\nRIFEで採用した中間素材は、目が `ad_eye_01`～`ad_eye_04`、口が `ad_mouth_01`～`ad_mouth_04` になります。\n\n別途独自に採用したい中間素材がある場合は、レイヤー名を特定のものに変更することで追加できます。\n目は `ad_eye_05`～`ad_eye_99`、口は `ad_mouth_05`～`ad_mouth_99` と設定してください。\n\n## 困ったとき\n\n### PNGALが開かない\n\n`start.bat` を実行し、PNGALとComfyUIの起動およびブラウザ表示が完了するまで待ってください。自動で開かない場合は、起動画面の案内を確認してから `http:\u002F\u002F127.0.0.1:7865` を開きます。\n\n### ComfyUIまたはRIFEのエラーが出る\n\n`restart.bat` をダブルクリックして全機能を再起動してください。改善しない場合は `setup.bat` を再実行し、不足ファイルを確認してください。\n\n### RIFE端点が不足していると表示される\n\nPSDに、目なら `eye_open` と `eye_close`、口なら `mouth_open` と `mouth_close` を両方入れてから読み込み直してください。端点レイヤーは同じキャンバス位置とサイズで作成してください。\n\n### PSDを読み込めない\n\nPhotoshop互換の8bit RGB\u002FRGBA PSDとして保存し、必要なレイヤーをラスタライズしてください。特殊なレイヤー設定や互換性の低い保存形式は避けてください。\n\n## 保存場所とアンインストール\n\n導入した環境と大容量ファイルは、すべてPNGALフォルダ内の `environment` に保存されます。作業中の一時データは `runtime` に保存されます。\n\nPNGALをアンインストールする場合は、必要なPSD、動画、設定TXTを別の場所へ保存してから、PNGALフォルダを削除してください。\n\n## 手動設定\n\n通常利用では手動設定は不要です。既存環境へ接続する場合や構成を変更する場合は、[config.example.ps1](resources\u002Fsetup\u002Fconfig.example.ps1) を参照してください。\n\nQwen GGUF用APIワークフローとRIFE用APIワークフローを `workflows` に収録しています。任意追加モデル用の顔差分ワークフローは同梱しません。利用者が作成する顔差分ワークフローの対応形式は [workflows\u002FCUSTOM_FACE_WORKFLOWS.md](workflows\u002FCUSTOM_FACE_WORKFLOWS.md) を参照してください。\n\n## ライセンス\n\nCopyright 2026 1mm-module\n\nPNGAL本体は[Apache License 2.0](LICENSE)で公開します。著作権表示は[NOTICE](NOTICE)を参照してください。第三者ライブラリ、同梱ワークフロー、使用者が配置するモデルには、それぞれのライセンスが適用されます。任意追加モデルはPNGALに同梱しません。\n","2026-08-04 02:30:05","CREATED_QUERY"]