Initial commitHEADmain

Made-with: Cursor

1 files changed, 64 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d549090
--- /dev/null
+++ b/README.md
@@ -0,0 +1,64 @@
+# 3D BluRay Processing Script
+
+PowerShell script that converts 3D BluRay files (MVC format) to Side-by-Side (SBS) and Half-Frame Side-by-Side format for 3D TV and VR headset viewing.
+
+## What it does
+
+1. Extracts the H.264 stream from the input file
+2. Converts MVC to full-frame Side-by-Side (3840x1080) using FRIM decoder
+3. Compresses ProRes full-frame SBS to H.264/AAC for storage efficiency
+4. Creates a half-frame SBS (1920x1080) from ProRes SBS for 3D TV viewing
+
+## File Flow
+
+```text
+Original 3D BluRay File
+    ↓
+H.264 Stream Extraction
+    ↓
+Full-Frame SBS (ProRes, ~200GB)
+    ↓                    ↓
+Compressed SBS      Half-Frame SBS
+(H.264/AAC)         (for 3D TV)
+```
+
+## Requirements
+
+- PowerShell 5.1 or later
+- MKVToolNix (mkvextract and mkvinfo)
+- FRIM decoder (FRIM_x64_version_1.31)
+- FFmpeg
+
+## Installation
+
+1. Download [MKVToolNix](https://mkvtoolnix.download/downloads.html) and extract to the script directory
+2. Download [FRIM decoder](https://www.videohelp.com/software/FRIM) and place in the script directory
+3. Install FFmpeg and add to PATH
+
+## Usage
+
+### Process a single file
+
+```powershell
+.\process_3d_bluray.ps1 "C:\Videos\movie.mkv"
+```
+
+### Process all videos in a folder
+
+```powershell
+.\process_3d_bluray.ps1 "C:\Videos\3D Movies\"
+```
+
+## Output Files
+
+For each input file, the script creates:
+
+- `filename-sbs-compressed.mp4` - Compressed full-frame SBS (for VR headsets)
+- `filename-half-sbs.mp4` - Half-frame SBS for 3D TV
+
+Intermediate files (H.264 stream and ProRes SBS) are automatically cleaned up.
+
+## Notes
+
+- The script only processes files with MVC streams.
+- When using MakeMKV to rip a 3D Blu-ray, make sure to expand each video track and check the unchecked video stream containing 'MVC'.