Leak_Technologies/VideoTools
Leak_Technologies/VideoTools
2
1
Fork 1
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

Update rip documentation

Browse Source
This commit is contained in:
Stu Leak 2025-12-23 22:13:54 -05:00
parent b02cd844c4
commit 4e449f8748
3 changed files with 41 additions and 293 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/MODULES.md
View File

@ -135,20 +135,17 @@ Comprehensive metadata viewer and editor:
**Current Status:** Basic metadata viewing implemented, advanced features planned. **Current Status:** Basic metadata viewing implemented, advanced features planned.
### Rip 🔄 PLANNED ### Rip ✅ IMPLEMENTED
Extract and convert content from optical media and disc images: Extract and convert content from optical media and disc images:
- ⏳ Rip directly from DVD/Blu-ray drives to video files - ✅ Rip from VIDEO_TS folders
- ⏳ Extract from ISO, IMG, and other disc image formats - ✅ Extract from ISO images (requires `xorriso` or `bsdtar`)
- ⏳ Title and chapter selection - ✅ Default lossless DVD → MKV (stream copy)
- ⏳ Preserve or transcode during extraction - ✅ Optional H.264 MKV/MP4 outputs
- ⏳ Handle copy protection (via libdvdcss/libaacs when available) - ✅ Queue-based execution with logs and progress
- ⏳ Subtitle and audio track selection
- ⏳ Batch ripping of multiple titles
- ⏳ Output to lossless or compressed formats
**FFmpeg Features:** DVD/Blu-ray input, concat, stream copying **FFmpeg Features:** concat demuxer, stream copy, H.264 encoding
**Current Status:** Planned for dev16, requires legal research and library integration. **Current Status:** Available in dev20+. Physical disc and multi-title selection are still planned.
### Blu-ray 🔄 PLANNED ### Blu-ray 🔄 PLANNED
Professional Blu-ray Disc authoring and encoding system: Professional Blu-ray Disc authoring and encoding system:

4
docs/README.md
View File

@ -1,6 +1,6 @@
# VideoTools Documentation # VideoTools Documentation
VideoTools is a professional-grade video processing suite with a modern GUI, currently on v0.1.0-dev18. It specializes in creating DVD-compliant videos for authoring and distribution. VideoTools is a professional-grade video processing suite with a modern GUI, currently on v0.1.0-dev20. It specializes in creating DVD-compliant videos for authoring and distribution.
## Documentation Structure ## Documentation Structure
@ -18,7 +18,7 @@ VideoTools is a professional-grade video processing suite with a modern GUI, cur
- [Upscale](upscale/) - Resolution enhancement *(AI + traditional now wired)* - [Upscale](upscale/) - Resolution enhancement *(AI + traditional now wired)*
- [Audio](audio/) - Audio track operations *(planned)* - [Audio](audio/) - Audio track operations *(planned)*
- [Thumb](thumb/) - Thumbnail generation *(planned)* - [Thumb](thumb/) - Thumbnail generation *(planned)*
- [Rip](rip/) - DVD/Blu-ray extraction *(planned)* - [Rip](rip/) - DVD/ISO/VIDEO_TS extraction and conversion
### Additional Modules (Proposed) ### Additional Modules (Proposed)
- [Subtitle](subtitle/) - Subtitle management *(planned)* - [Subtitle](subtitle/) - Subtitle management *(planned)*

311
docs/rip/README.md
View File

@ -1,297 +1,48 @@
# Rip Module # Rip Module
Extract and convert content from DVDs, Blu-rays, and disc images. Extract and convert content from DVD folder structures and disc images.
## Overview ## Overview
The Rip module (formerly "Remux") handles extraction of video content from optical media and disc image files. It can rip directly from physical drives or work with ISO/IMG files, providing options for both lossless extraction and transcoding during the rip process. The Rip module focuses on offline extraction from VIDEO_TS folders or DVD ISO images. It is designed to be fast and lossless by default, with optional H.264 transcodes when you want smaller files. All processing happens locally.
> **Note:** This module is currently in planning phase. Features described below are proposed functionality. ## Current Capabilities (dev20+)
## Features ### Supported Sources
- VIDEO_TS folders
- ISO images (requires `xorriso` or `bsdtar` to extract)
### Source Support ### Output Modes
- Lossless DVD -> MKV (stream copy, default)
- H.264 MKV (transcode)
- H.264 MP4 (transcode)
#### Physical Media ### Behavior Notes
- **DVD** - Standard DVDs with VOB structure - Uses a queue job with progress and logs.
- **Blu-ray** - BD structure with M2TS files - No online lookups or network calls.
- **CD** - Video CDs (VCD/SVCD) - ISO extraction is performed to a temporary working folder before FFmpeg runs.
- Direct drive access for ripping - Default output naming is based on the source name.
#### Disc Images ## Not Yet Implemented
- **ISO** - Standard disc image format - Direct ripping from physical drives (DVD/Blu-ray)
- **IMG** - Raw disc images - Multi-title selection from ISO contents
- **BIN/CUE** - CD image pairs - Auto metadata lookup
- Mount and extract without burning - Subtitle/audio track selection UI
### Title Selection ## Usage
#### Auto-Detection 1. Open the Rip module.
- Scan disc for all titles 2. Drag a VIDEO_TS folder or an ISO into the drop area.
- Identify main feature (longest title) 3. Choose the output mode (lossless MKV or H.264 MKV/MP4).
- List all extras/bonus content 4. Start the rip job and monitor the log/progress.
- Show duration and chapter count for each
#### Manual Selection ## Dependencies
- Preview titles before ripping
- Select multiple titles for batch rip
- Choose specific chapters from titles
- Merge chapters from different titles
### Track Management - `ffmpeg`
- `xorriso` or `bsdtar` for ISO extraction
#### Video Tracks ## Example FFmpeg Flow (conceptual)
- Select video angle (for multi-angle DVDs)
- Choose video quality/stream
#### Audio Tracks - VIDEO_TS: concatenate VOBs then stream copy to MKV.
- List all audio tracks with language - ISO: extract VIDEO_TS from the ISO, then follow the same flow.
- Select which tracks to include
- Reorder track priority
- Convert audio format during rip
#### Subtitle Tracks
- List all subtitle languages
- Extract or burn subtitles
- Select multiple subtitle tracks
- Convert subtitle formats
### Rip Modes
#### Direct Copy (Lossless)
Fast extraction with no quality loss:
- Copy VOB → MKV/MP4 container
- No re-encoding
- Preserves original quality
- Fastest option
- Larger file sizes
#### Transcode
Convert during extraction:
- Choose output codec (H.264, H.265, etc.)
- Set quality/bitrate
- Resize if desired
- Compress to smaller file
- Slower but more flexible
#### Smart Mode
Automatically choose best approach:
- Copy if already efficient codec
- Transcode if old/inefficient codec
- Optimize settings for content type
### Copy Protection Handling
#### DVD CSS
- Use libdvdcss when available
- Automatic decryption during rip
- Legal for personal use (varies by region)
#### Blu-ray AACS
- Use libaacs for AACS decryption
- Support for BD+ (limited)
- Requires key database
#### Region Codes
- Detect region restrictions
- Handle multi-region discs
- RPC-1 drive support
### Quality Settings
#### Presets
- **Archival** - Lossless or very high quality
- **Standard** - Good quality, moderate size
- **Efficient** - Smaller files, acceptable quality
- **Custom** - User-defined settings
#### Special Handling
- Deinterlace DVD content automatically
- Inverse telecine for film sources
- Upscale SD content to HD (optional)
- HDR passthrough for Blu-ray
### Batch Processing
#### Multiple Titles
- Queue all titles from disc
- Process sequentially
- Different settings per title
- Automatic naming
#### Multiple Discs
- Load multiple ISO files
- Batch rip entire series
- Consistent settings across discs
- Progress tracking
### Output Options
#### Naming Templates
Automatic file naming:
```
{disc_name}_Title{title_num}_Chapter{start}-{end}
Star_Wars_Title01_Chapter01-25.mp4
```
#### Metadata
- Auto-populate from disc info
- Lookup online databases (IMDB, TheTVDB)
- Chapter markers preserved
- Cover art extraction
#### Organization
- Create folder per disc
- Separate folders for extras
- Season/episode structure for TV
- Automatic file organization
## Usage Guide
### Ripping a DVD
1. **Insert Disc or Load ISO**
- Physical disc: Insert and click "Scan Drive"
- ISO file: Click "Load ISO" and select file
2. **Scan Disc**
- Application analyzes disc structure
- Lists all titles with duration/chapters
- Main feature highlighted
3. **Select Title(s)**
- Choose main feature or specific titles
- Select desired chapters
- Preview title information
4. **Configure Tracks**
- Select audio tracks (e.g., English 5.1)
- Choose subtitle tracks if desired
- Set track order/defaults
5. **Choose Rip Mode**
- Direct Copy for fastest/lossless
- Transcode to save space
- Configure quality settings
6. **Set Output**
- Choose output folder
- Set filename or use template
- Select container format
7. **Start Rip**
- Click "Start Ripping"
- Monitor progress
- Can queue multiple titles
### Ripping a Blu-ray
Similar to DVD but with additional considerations:
- Much larger files (20-40GB for feature)
- Better quality settings available
- HDR preservation options
- Multi-audio track handling
### Batch Ripping a TV Series
1. **Load all disc ISOs** for season
2. **Scan each disc** to identify episodes
3. **Enable batch mode**
4. **Configure naming** with episode numbers
5. **Set consistent quality** for all
6. **Start batch rip**
## FFmpeg Integration
### Direct Copy Example
```bash
# Extract VOB to MKV without re-encoding
ffmpeg -i /dev/dvd -map 0 -c copy output.mkv
# Extract specific title
ffmpeg -i dvd://1 -map 0 -c copy title_01.mkv
```
### Transcode Example
```bash
# Rip DVD with H.264 encoding
ffmpeg -i dvd://1 \
-vf yadif,scale=720:480 \
-c:v libx264 -crf 20 \
-c:a aac -b:a 192k \
output.mp4
```
### Multi-Track Example
```bash
# Preserve multiple audio and subtitle tracks
ffmpeg -i dvd://1 \
-map 0:v:0 \
-map 0:a:0 -map 0:a:1 \
-map 0:s:0 -map 0:s:1 \
-c copy output.mkv
```
## Tips & Best Practices
### DVD Quality
- Original DVD is 720×480 (NTSC) or 720×576 (PAL)
- Always deinterlace DVD content
- Consider upscaling to 1080p for modern displays
- Use inverse telecine for film sources (24fps)
### Blu-ray Handling
- Main feature typically 20-50GB
- Consider transcoding to H.265 to reduce size
- Preserve 1080p resolution
- Keep high bitrate audio (DTS-HD, TrueHD)
### File Size Management
| Source | Direct Copy | H.264 CRF 20 | H.265 CRF 24 |
|--------|-------------|--------------|--------------|
| DVD (2hr) | 4-8 GB | 2-4 GB | 1-3 GB |
| Blu-ray (2hr) | 30-50 GB | 6-10 GB | 4-6 GB |
### Legal Considerations
- Ripping for personal backup is legal in many regions
- Circumventing copy protection may have legal restrictions
- Distribution of ripped content is typically illegal
- Check local laws and regulations
### Drive Requirements
- DVD-ROM drive for DVD ripping
- Blu-ray drive for Blu-ray ripping (obviously)
- RPC-1 (region-free) firmware helpful
- External drives work fine
## Troubleshooting
### Can't Read Disc
- Clean disc surface
- Try different drive
- Check drive region code
- Verify disc isn't damaged
### Copy Protection Errors
- Install libdvdcss (DVD) or libaacs (Blu-ray)
- Update key database
- Check disc region compatibility
- Try different disc copy
### Slow Ripping
- Direct copy is fastest
- Transcoding is CPU-intensive
- Use hardware acceleration if available
- Check drive speed settings
### Audio/Video Sync Issues
- Common with VFR content
- Use -vsync parameter
- Force constant frame rate
- Check source for corruption
## See Also
- [Convert Module](../convert/) - Transcode ripped files further
- [Streams Module](../streams/) - Manage multi-track ripped files
- [Subtitle Module](../subtitle/) - Handle extracted subtitle tracks
- [Inspect Module](../inspect/) - Analyze ripped output quality