Skip to content

Commit 6e4b01a

Browse files
committed
Docs: Update README with improved installation instructions
1 parent f926fb2 commit 6e4b01a

File tree

1 file changed

+83
-3
lines changed

1 file changed

+83
-3
lines changed

README.md

Lines changed: 83 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@ This entire section is provided by the "Advanced Yaw Selector" module.
261261
* Outputs still image files in JPEG format. Lossy compression, smaller file sizes, but lower quality than PNG.
262262
* **Extraction Interval (sec):** Same as for PNG.
263263
* **Quality (1-100):** Specify JPEG quality from 1 (low quality, small size) to 100 (high quality, large size). Default is `90`.
264-
* **Video (HEVC/H.265):**
264+
* **Video (HEVC/H.256):**
265265
* Outputs each viewpoint as an individual video file (H.265 codec, MP4 container). Audio is not included.
266266
* **Preset:** Specifies the encoding speed vs. compression balance (e.g., `medium`, `slow`). Default is `medium`.
267267
* **CQ/CRF:** Specifies the encoding quality. Lower values mean higher quality (and larger files). Range 0-51, typically 15-28. Default is `18`. (Handled as CQ for CUDA, CRF for CPU).
@@ -439,7 +439,29 @@ If an error occurs during processing, the "Start Conversion" button will become
439439

440440
## Appendix 1: How to Install FFmpeg
441441

442-
This application uses FFmpeg internally. Please prepare it using the following steps:
442+
This application uses FFmpeg internally. Please prepare it using one of the following methods.
443+
444+
### For Windows Users: Easy Installation via winget (Recommended)
445+
446+
For Windows 10/11 users, the easiest way to install FFmpeg is by using the `winget` (Windows Package Manager) command-line tool. This method automatically handles the download, installation, and PATH configuration.
447+
448+
1. **Open Windows Terminal (as Administrator):**
449+
* Click the Start button.
450+
* Type `Terminal`.
451+
* Right-click on the "Terminal" app and select "Run as administrator".
452+
2. **Run the Install Command:**
453+
* Copy the command below, paste it into the Terminal window, and press Enter.
454+
```cmd
455+
winget install FFmpeg
456+
```
457+
3. **Approve and Wait:**
458+
* You might be asked to agree to some terms. If so, type `y` and press Enter.
459+
* `winget` will then download and install FFmpeg automatically.
460+
4. **Verify:**
461+
* **Close the current Terminal window and open a new one.** This is important for the system to recognize the new settings.
462+
* In the new Terminal, type `ffmpeg -version` and press Enter. If FFmpeg version information is displayed, the setup is successful.
463+
464+
### Alternative: Manual Installation (for Advanced Users)
443465
444466
1. **Download:** Download a build for your OS from the official FFmpeg website ([https://ffmpeg.org/download.html](https://ffmpeg.org/download.html)) or other trusted sources.
445467
* For Windows, builds from gyan.dev or BtbN are common. Choose a `full_build` or `essentials_build` zip file.
@@ -455,7 +477,29 @@ This application uses FFmpeg internally. Please prepare it using the following s
455477
456478
**[日本語] 補足 1: FFmpeg の導入方法**
457479
458-
このアプリケーションは内部で FFmpeg というツールを使用します。以下の手順で準備してください。
480+
このアプリケーションは内部で FFmpeg というツールを使用します。以下のいずれかの方法で準備してください。
481+
482+
### Windows ユーザー向け: winget を使った簡単な導入方法 (推奨)
483+
484+
Windows 10/11 をお使いの場合、コマンドラインツール `winget` (Windows パッケージ マネージャー) を使うのが最も簡単な導入方法です。ダウンロード、インストール、PATHの設定まで自動で行われます。
485+
486+
1. **Windows ターミナルを管理者として開く:**
487+
* スタートボタンをクリックします。
488+
* `ターミナル` と入力します。
489+
* 表示された「ターミナル」アプリを右クリックし、「管理者として実行」を選択します。
490+
2. **インストールコマンドを実行:**
491+
* 以下のコマンドをコピーして、ターミナルのウィンドウに貼り付け、Enterキーを押します。
492+
```cmd
493+
winget install FFmpeg
494+
```
495+
3. **承認して待機:**
496+
* 途中でライセンス等への同意を求められた場合は `y` と入力してEnterキーを押します。
497+
* `winget` が自動的に FFmpeg をダウンロードし、インストールします。
498+
4. **確認:**
499+
* **一度現在のターミナルウィンドウを閉じ、新しいターミナルを開き直してください。** これはシステムが新しい設定を認識するために重要です。
500+
* 新しいターミナルで `ffmpeg -version` と入力して Enterキーを押します。FFmpeg のバージョン情報が表示されれば、設定は成功です。
501+
502+
### 別な方法: 手動での導入 (詳細設定)
459503
460504
1. **ダウンロード:** FFmpeg 公式サイト (https://ffmpeg.org/download.html)などから、お使いの OS 向けのビルドをダウンロードします。
461505
* Windows の場合: gyan.dev や BtbN のビルドが一般的です。full_build または essentials_buildのzip ファイルを選びます。
@@ -475,6 +519,24 @@ This application uses FFmpeg internally. Please prepare it using the following s
475519
476520
Python (version 3.9 or newer) and Tkinter (Tk version 8.6 or newer, usually included with Python) are required to run this application.
477521
522+
### For Windows Users: Easy Installation via Microsoft Store (Recommended)
523+
524+
For most Windows users, installing Python from the Microsoft Store is the simplest method.
525+
526+
1. **Open the Microsoft Store:**
527+
* Click the Start button.
528+
* Type `Microsoft Store` and open the app.
529+
2. **Search for Python:**
530+
* In the Store's search bar, type `Python`.
531+
3. **Install:**
532+
* Select the latest official Python version from the search results.
533+
* Click the "Get" or "Install" button. Python will be downloaded and installed automatically.
534+
4. **Verify:**
535+
* Open a Command Prompt or Terminal.
536+
* Type `python --version` and press Enter. If the installed Python version (3.9+) is displayed, the setup is successful.
537+
538+
### Alternative: Manual Installation (for Advanced Users)
539+
478540
1. **Download:** Download the latest stable installer for Python 3.9 or newer from the official Python website ([https://www.python.org/downloads/](https://www.python.org/downloads/)) (e.g., "Windows installer (64-bit)" for Windows).
479541
2. **Install (Recommended settings for Windows):**
480542
1. Run the downloaded installer.
@@ -489,6 +551,24 @@ Python (version 3.9 or newer) and Tkinter (Tk version 8.6 or newer, usually incl
489551
490552
このアプリケーションを実行するには Python (バージョン 3.9 以降) および Tkinter (Tk バージョン 8.6 以降、通常Pythonに同梱) が必要です。
491553
554+
### Windows ユーザー向け: Microsoft Store を使った簡単な導入方法 (推奨)
555+
556+
ほとんどの Windows ユーザーにとって、Microsoft Store から Python をインストールするのが最も簡単な方法です。
557+
558+
1. **Microsoft Store を開く:**
559+
* スタートボタンをクリックします。
560+
* `Microsoft Store` と入力してアプリを開きます。
561+
2. **Python を検索:**
562+
* ストアの上部にある検索バーで `Python`と入力します。
563+
3. **インストール:**
564+
* 検索結果から、最新の公式 Python を選択します。
565+
* 「入手」または「インストール」ボタンをクリックします。自動的にダウンロードとインストールが行われます。
566+
4. **確認:**
567+
* コマンドプロンプトまたはターミナルを開きます。
568+
* `python --version` と入力して Enterキーを押します。インストールした Python のバージョン (3.9+) が表示されれば、設定は成功です。
569+
570+
### 別な方法: 手動での導入 (詳細設定)
571+
492572
1. **ダウンロード:** Python 公式サイト (https://www.python.org/downloads/) から、Python 3.9 以降の最新の安定版インストーラー (Windows の場合は "Windows installer (64-bit)" など) をダウンロードします。
493573
2. **インストール (Windows の場合の推奨設定):**
494574
1. ダウンロードしたインストーラーを実行します。

0 commit comments

Comments
 (0)