BD-to-AVP 3D Blu-ray Disc to Apple Vision Pro README
Introduction
This tool processes 3D video content from Blu-ray discs, ISO images, or MKV files, creating a final video file compatible with the Apple Vision Pro. It uses FFmpeg, MakeMKV, and Wine for video extraction, audio transcoding, and video stream merging to convert from Mpeg 4 MVC 3D video to MV-HEVC 3D video. The tool also injects 360° metadata into the video file for spatial media playback.
Quick install (or update)
To quickly install or update BD_to_AVP, run the following command in your terminal:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/cbusillo/BD_to_AVP/release/installer.sh)"
Prerequisites
Ensure the following are installed on your Mac (If not using the Quick Install):
- Apple Silicon Mac: A Mac with Apple Silicon, such as the M1, M1 Pro, or M1 Max (Maybe, installer currently requires Apple Silicon. If anyone can confirm that spatial-media-kit-tool works on Intel Macs, I can remove this requirement)
- macOS Sonoma: The latest version of macOS.
- Rosetta 2: A compatibility layer allowing Intel-based applications to run on Apple Silicon Macs.
- Python 3.12: The latest version of Python.
- Homebrew: The missing package manager for macOS (or Linux).
- FFmpeg: A complete, cross-platform solution to record, convert, and stream audio and video.
- Wine: A free and open-source compatibility layer allowing Windows programs to run on Unix-like operating systems.
- MakeMKV: For converting disc video content into MKV files.
- spatial-media-kit-tool: A tool for injecting 360° metadata into video files.
- MP4Box: A multimedia packager available for Windows, Mac, and Linux.
- MKVToolNix: A set of tools to create, alter, and inspect Matroska files.
Manual Installation (Out of date)
To set up your macOS environment for video processing, including creating and handling 3D video content, follow these steps to install the necessary tools using Homebrew and manual installation. This includes the installation of Homebrew itself, FFmpeg for video encoding and decoding, Wine for running Windows applications, MakeMKV for ripping Blu-ray and DVD to MKV, spatial-media-kit-tool for handling spatial media, and MP4Box for multimedia packaging.
# Install Rosetta 2
/usr/sbin/softwareupdate --install-rosetta --agree-to-license
# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install FFmpeg, MakeMKV, MP4Box, mkvtoolnix and Python 3.12
brew install ffmpeg makemkv mp4box mkvtoolnix python@3.12 --no-quarantine
# Install Wine
brew tap homebrew/cask-versions
brew install --cask --no-quarantine wine-stable
# Ensure Python 3.12 is correctly installed then create a virtual environment
python3.12 -m pip install --upgrade pip
python3.12 -m venv ~/.bd_to_avp_venv
# Activate the virtual environment and install BD_to_AVP
source ~/.bd_to_avp_venv/bin/activate
pip install bd_to_avp
# Create a symbolic link to the bd-to-avp command
ln -s ~/.bd_to_avp_venv/bin/bd-to-avp /opt/homebrew/bin/bd-to-avp
Usage
Navigate to the tool's directory in your terminal and execute the command with the required and optional parameters:
Command Syntax
bd-to-avp --source <source> [--source-folder <source-folder>] [options]
Parameters
--source: Source for a single disc number, MKV file path, or ISO image path (required).--source-folder: Source folder path. This option will recurively scan for image files or mkv files. Will take precedence over --source if both are provided.--fx-upscale: Upscale video to 4K resolution using fx-upscale (disabled by default).--remove-original: Remove original file after processing.--overwrite: Overwrite existing output file.--keep-files: Keep intermediate files (disabled by default).--output-root-folder: Output folder path. Defaults to the current directory.--transcode-audio: Enable audio transcoding to AAC (disabled by default).--audio-bitrate: Audio bitrate for transcoding in kb/s do not include unit (default: "384").--left-right-bitrate: Bitrate for left and right views in Mb/s do not include unit (default: "20").'--mv-hevc-quality: Quality factor for MV-HEVC encoding (default: "75").--fov: Horizontal field of view for MV-HEVC (default: "90").--frame-rate: Video frame rate (auto-detected if not provided).--resolution: Video resolution (auto-detected if not provided).--swap-eyes: Swap left and right views (disabled by default).--start-stage: Start processing at a specific stage.--output-commands: Output commands used to console.--software-encoder: Use software encoder for MV-HEVC encoding (disabled by default).--skip-subtitles: Skip subtitle extraction (disabled by default).--continue-on-error: Continue processing after an error (disabled by default).--version: Show the version number and exit.
Stage Names
- CREATE_MKV
- EXTRACT_MVC_AUDIO_AND_SUB
- CREATE_LEFT_RIGHT_FILES
- UPSCALE_VIDEO
- COMBINE_TO_MV_HEVC
- TRANSCODE_AUDIO
- CREATE_FINAL_FILE
- MOVE_FILES
Examples
Process a Blu-ray disc:
bd-to-avp --source disc:0 --output-root-folder /path/to/output
Process an ISO image:
bd-to-avp --source /path/to/movie.iso --output-root-folder /path/to/output
Process an MKV file:
bd-to-avp --source /path/to/movie.mkv --output-root-folder /path/to/output --transcode-audio
Contribution
Contribute to the project by submitting pull requests or opening issues for bugs and feature requests.
Acknowledgements
Big thanks to:
- sturmen on the Doom9 forums, for an encoding guide using
FRIM Decoderas well as creating the spatial-media-kit-tool - Vargol on GitHub, for making the JM reference software build properly on macOS as well as an example script that was a useful reference
- steverice for h264-tools
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bd_to_avp-0.2.40.tar.gz.
File metadata
- Download URL: bd_to_avp-0.2.40.tar.gz
- Upload date:
- Size: 30.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.12.3 Linux/6.5.0-1021-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ee3cde651136a5ee69dc4e41d5714ec8f2bde28714e681698e6fc1d419d0dcb7
|
|
| MD5 |
a3cb4142188f5b2b546d30aaeb93e6a3
|
|
| BLAKE2b-256 |
5d21763edfc94eaee6bf2ffba495b962e451196b035b4a7b1df2dc47f7f1a393
|
File details
Details for the file bd_to_avp-0.2.40-py3-none-any.whl.
File metadata
- Download URL: bd_to_avp-0.2.40-py3-none-any.whl
- Upload date:
- Size: 30.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.12.3 Linux/6.5.0-1021-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cbc6094f195715c80a343d24dea5c396c66eeb57c187cfe5fdf74cd931f56238
|
|
| MD5 |
f473a2d69b3e9c8b0fe03d8941673542
|
|
| BLAKE2b-256 |
7182f6bd0c22d70ea0e3b52b1c124ba71df144b158cb06692cb6282f0f758745
|
