Repository navigation
User Guide
Welcome to the comprehensive user guide for AutoRip2MKV-Mac! This guide covers all features, settings, and advanced functionality to help you get the most out of your DVD and Blu-ray ripping experience.
- Getting Started
- Main Interface
- Expanded Settings Overview
- File Organization Options
- Advanced Encoding Settings
- Output Directory Preferences
- Quality Presets System
- File Storage & Organization
- Bonus Content Management
- File Naming Templates
- Quality & Codec Settings
- Advanced Options
- Template Variables Reference
- Best Practices
- Troubleshooting
AutoRip2MKV-Mac is a powerful DVD and Blu-ray ripping application that converts your physical media to high-quality MKV files. The application provides professional-grade control over encoding, organization, and output quality.
- macOS 10.15 or later
- FFmpeg (automatically installed if needed)
- DVD/Blu-ray drive or disc image files
- Sufficient storage space for output files
- Launch AutoRip2MKV-Mac
- Insert a DVD or Blu-ray disc (or select a disc image)
- Choose your output directory
- Click Settings... to configure your preferences
- Click Start Ripping to begin
The main interface provides quick access to essential ripping functions:
- Drive Dropdown: Automatically detects optical drives
- Refresh Button: Re-scan for available drives
- Browse Button: Select disc image files from your computer
- Output Directory: Where your ripped files will be saved
- Browse Button: Select or create output folders
- Auto-rip inserted discs: Automatically start ripping when a disc is detected
- Auto-eject after ripping: Eject the disc when ripping completes
- Settings... Button: Opens the comprehensive settings window
The expanded settings window (introduced in v1.2.0) provides professional-level control over every aspect of the ripping process. Settings are organized into logical sections for easy navigation.
- File Organization Options - How files are named and organized
- Advanced Encoding Settings - Professional encoding controls
- Output Directory Preferences - Default paths and organization
- Quality Presets - Pre-configured and custom settings
- File Storage & Organization - Directory structure options
- Bonus Content - Special features handling
- File Naming - Custom naming patterns
- Quality & Codecs - Video and audio settings
- Advanced Options - Expert-level configurations
Control how your ripped files are organized and managed.
Purpose: Automatically rename files for better organization and compatibility Options:
- ✅ Enabled: Files are renamed using smart algorithms
- ❌ Disabled: Original disc names are preserved
Example:
- Original:
VTS_01_1.mkv - Renamed:
The Matrix (1999).mkv
Create Year-Based Subdirectories
- Organizes content by release year when metadata is available
- Structure:
Movies/1999/The Matrix (1999).mkv
Create Genre-Based Subdirectories
- Groups content by genre (Action, Comedy, Drama, etc.)
- Structure:
Movies/Action/The Matrix (1999).mkv
Choose how to handle files that already exist:
- Skip duplicate files: Fastest option, skips existing files
- Overwrite existing files: Replaces existing files (use with caution)
-
Rename with suffix: Adds
_2,_3, etc. to filename - Ask user for each duplicate: Prompts for each conflict
Purpose: Exclude small files (previews, menus) from ripping Default: 100 MB Recommended: 50-200 MB depending on content type
Professional-grade encoding controls for optimal quality and performance.
Balances encoding speed vs. quality:
- Ultra Fast: Fastest encoding, lowest quality
- Very Fast: Good for quick previews
- Fast: Balanced for most users
- Medium: Recommended default setting
- Slow: Better quality, longer encoding time
- Very Slow: Highest quality, significantly longer encoding
Constant Quality (CRF) - Recommended
- Maintains consistent visual quality
- File size varies based on content complexity
- Best for archival purposes
Target Bitrate (CBR)
- Fixed bitrate throughout the file
- Predictable file sizes
- Good for streaming or bandwidth constraints
Variable Bitrate (VBR)
- Quality-based bitrate allocation
- Efficient for mixed content
Constrained VBR
- VBR with maximum bitrate limits
- Prevents excessive file sizes
Purpose: Set desired output bitrate in Mbps Typical Values:
- SD Content: 1-3 Mbps
- HD Content: 3-8 Mbps
- Full HD: 5-15 Mbps
- 4K Content: 15-50 Mbps
Two-Pass Encoding
- First pass analyzes content
- Second pass optimizes encoding
- Results in better quality at same bitrate
- Approximately doubles encoding time
Hardware Acceleration
- Leverages GPU for faster encoding
- Significantly reduces encoding time
- May have slight quality trade-offs
- Automatically detected and enabled when available
Custom FFmpeg Arguments For advanced users who want to add specific FFmpeg parameters:
-tune film -preset slow -profile:v high
Configure default output locations and organization patterns.
Purpose: Set a persistent output location Setup:
- Click Browse... button
- Select or create your preferred output folder
- Path is saved for future sessions
Recommended Locations:
-
~/Movies/Ripped- User Movies folder -
/Volumes/External/Media- External drive -
~/Desktop/AutoRip- Desktop folder
Purpose: Organize rips by date of creation Format: YYYY-MM-DD Example Structure:
~/Movies/Ripped/
├── 2024-07-05/
│ ├── The Matrix (1999).mkv
│ └── Inception (2010).mkv
└── 2024-07-06/
└── Interstellar (2014).mkv
Purpose: Create custom directory structures using variables
Template Variables:
-
{output_dir}- Base output directory -
{media_type}- Movies, TV Shows, etc. -
{title}- Content title -
{year}- Release year -
{genre}- Content genre -
{date}- Current date (YYYY-MM-DD)
Example Templates:
{output_dir}/{media_type}/{title}
Result: ~/Movies/Ripped/Movies/The Matrix (1999)
{output_dir}/{year}/{genre}/{title}
Result: ~/Movies/Ripped/1999/Action/The Matrix (1999)
{output_dir}/{date}/{media_type}/{title}
Result: ~/Movies/Ripped/2024-07-05/Movies/The Matrix (1999)
Streamline your workflow with predefined and custom quality configurations.
Default (High Quality)
- H.264 encoding
- High quality settings
- Good balance of quality and file size
- Recommended for most users
Archive (Lossless)
- Highest possible quality
- Larger file sizes
- Perfect for long-term storage
- Preserves original quality
Mobile (Small Size)
- Optimized for phones and tablets
- Smaller file sizes
- Lower resolution and bitrate
- Good for portable devices
Streaming (Balanced)
- Optimized for streaming services
- Balanced quality and bandwidth
- Fast loading times
- Good for network playback
4K/UHD Optimized
- High bitrate settings
- Optimized for 4K content
- Large file sizes
- Best for high-resolution displays
Creating Custom Presets:
- Configure all settings to your preference
- Enter a name in "Custom Preset Name" field
- Click "Save Current as Preset"
- Preset appears in dropdown for future use
Using Custom Presets:
- Select preset from "Quality Preset" dropdown
- All settings automatically apply
- Make additional adjustments if needed
Deleting Custom Presets:
- Select the custom preset in dropdown
- Click "Delete Selected Preset"
- Confirm deletion in dialog
Preset Storage: Custom presets are saved to your system preferences and persist between app launches.
Configure how your media library is structured and organized.
Flat - All files in output directory
- Single directory with all files
- Simple but can become cluttered
- Good for small collections
By Media Type - Movies/TV Shows separated
- Separate folders for different content types
- Clean organization
- Recommended for mixed collections
By Year - Organized by release year
- Chronological organization
- Easy to find content by era
- Good for large movie collections
By Genre - Organized by genre
- Groups similar content together
- Requires metadata detection
- Great for browsing by mood
Custom - Use format strings
- Full control using template variables
- Most flexible option
- Requires understanding of templates
Create separate directories for TV series
- Each TV show gets its own folder
- Episodes organized within show folders
- Essential for TV content management
Create season subdirectories for TV shows
- Further organization by season
- Structure:
TV Shows/Show Name/Season 1/ - Recommended for long-running series
Movie Directory Format
Default: Movies/{title} ({year})
Examples:
Movies/{title} ({year})
→ Movies/The Matrix (1999)
{genre}/{title} ({year})
→ Action/The Matrix (1999)
{year}/{title}
→ 1999/The Matrix
TV Show Directory Format
Default: TV Shows/{series}/Season {season}
Examples:
TV Shows/{series}/Season {season}
→ TV Shows/Breaking Bad/Season 1
{series}/{season:02d}
→ Breaking Bad/01
Shows/{series} ({year})/S{season:02d}
→ Shows/Breaking Bad (2008)/S01
Control how special features and bonus content are handled.
Bonus Features/Special Features
- Behind-the-scenes content
- Deleted scenes collections
- Photo galleries
Audio Commentaries
- Director and cast commentaries
- Multiple audio tracks with discussion
Deleted Scenes
- Individual deleted scene files
- Extended or alternate versions
Making-of Documentaries
- Production documentaries
- Cast and crew interviews
Trailers and Previews
- Movie trailers
- Upcoming releases
- TV spots
Same directory as main content
- All files in one location
- Simple but can be cluttered
- Good for minimal bonus content
Separate 'Bonus' subdirectory
- Creates
Bonus/folder within movie directory - Clean separation of main and bonus content
- Recommended default
Separate 'Extras' subdirectory
- Creates
Extras/folder - Alternative naming convention
- Good for compatibility with media servers
Custom subdirectory name
- Use custom folder name
- Enter name in "Custom Bonus Directory Name" field
- Full control over organization
Create consistent, informative filenames using powerful template systems.
Default Template: {title} ({year}).mkv
Template Variables:
-
{title}- Movie title -
{year}- Release year -
{resolution}- Video resolution (1080p, 720p, etc.) -
{codec}- Video codec (H264, H265, etc.)
Example Templates:
{title} ({year}).mkv
→ The Matrix (1999).mkv
{title} ({year}) [{resolution}].mkv
→ The Matrix (1999) [1080p].mkv
{year} - {title} - {codec}.mkv
→ 1999 - The Matrix - H264.mkv
Default Template: {series} - S{season:02d}E{episode:02d} - {title}.mkv
Template Variables:
-
{series}- TV series name -
{season}- Season number -
{season:02d}- Season number with leading zero -
{episode}- Episode number -
{episode:02d}- Episode number with leading zero -
{title}- Episode title
Example Templates:
{series} - S{season:02d}E{episode:02d} - {title}.mkv
→ Breaking Bad - S01E01 - Pilot.mkv
{series} {season}x{episode:02d} {title}.mkv
→ Breaking Bad 1x01 Pilot.mkv
{series} - Season {season} Episode {episode} - {title}.mkv
→ Breaking Bad - Season 1 Episode 1 - Pilot.mkv
Default: S{season:02d}E{episode:02d}
Format Options:
S{season:02d}E{episode:02d} → S01E01
{season}x{episode:02d} → 1x01
Season{season}Episode{episode} → Season1Episode1
Include year in filename
- Adds release year to all filenames
- Helps distinguish remakes and reboots
- Recommended for large collections
Include resolution in filename
- Adds video resolution (1080p, 720p, etc.)
- Useful when storing multiple qualities
- Good for quality comparisons
Include codec info in filename
- Adds video codec information
- Helps identify encoding method
- Useful for technical organization
Fine-tune video and audio encoding for optimal results.
H.264 (x264)
- Most compatible codec
- Good quality-to-size ratio
- Widely supported
- Recommended for compatibility
H.265 (x265/HEVC)
- Better compression than H.264
- Smaller file sizes at same quality
- Less compatible with older devices
- Good for modern systems
VP9
- Open-source codec
- Good compression efficiency
- Free of licensing fees
- Limited device support
AV1
- Next-generation codec
- Excellent compression
- Future-proof technology
- Limited current support
AAC
- High-quality lossy codec
- Excellent compatibility
- Good for most content
- Recommended default
AC3 (Dolby Digital)
- Common on DVDs/Blu-rays
- Good surround sound support
- Widely compatible
- Larger file sizes than AAC
DTS
- High-quality audio codec
- Excellent for surround content
- Less compatible than AC3
- Good for audio enthusiasts
FLAC
- Lossless audio compression
- Perfect audio quality
- Large file sizes
- Good for archival
Low (Fast)
- Fastest encoding
- Acceptable quality for previews
- Smallest file sizes
- Good for quick tests
Medium (Balanced)
- Good balance of speed and quality
- Recommended for most users
- Reasonable encoding time
- Good quality results
High (Best Quality)
- Highest quality output
- Longer encoding times
- Larger file sizes
- Recommended for archival
Lossless
- Perfect quality preservation
- Very large file sizes
- Longest encoding times
- Only for critical archival
Include subtitles
- Preserves subtitle tracks
- Multiple language support
- No quality impact
- Recommended for international content
Include chapter markers
- Preserves DVD/Blu-ray chapters
- Easy navigation in players
- No file size impact
- Recommended for all content
Preferred Language
- Primary audio track language
- Automatic track selection
- Falls back to available languages
- Options: English, Spanish, French, German, Japanese, Auto-detect, All Languages
Expert-level settings for specialized use cases.
Preserve original file timestamps
- Maintains original creation dates
- Good for archival purposes
- Preserves metadata chronology
Create backup of original disc structure
- Copies raw disc files before processing
- Safety net for re-processing
- Requires significant storage space
Auto-retry on failure
- Automatically retries failed operations
- Handles temporary errors
- Improves success rate
Max Retry Attempts
- Number of retry attempts (default: 3)
- Prevents infinite retry loops
- Adjustable from 1-10 attempts
Post-processing Script
- Run custom scripts after ripping
- Automate additional tasks
- Supports shell scripts, Python, Ruby, Perl, JavaScript
Script Examples:
#!/bin/bash
# Move completed files to network storage
mv "$1" "/Volumes/NetworkDrive/Movies/"
# Send notification
osascript -e 'display notification "Rip completed" with title "AutoRip2MKV"'Script Variables:
-
$1- Output file path -
$2- Original disc title -
$3- File size in bytes
Complete reference for all available template variables.
-
{title}- Content title -
{year}- Release year -
{date}- Current date (YYYY-MM-DD) -
{time}- Current time (HH-MM-SS)
-
{output_dir}- Base output directory -
{media_type}- Movies, TV Shows, Music, etc. -
{genre}- Content genre -
{studio}- Production studio -
{country}- Country of origin
-
{title}- Movie title -
{year}- Release year -
{director}- Director name -
{rating}- Content rating (PG, R, etc.) -
{runtime}- Duration in minutes
-
{series}- TV series name -
{season}- Season number -
{season:02d}- Season with leading zero -
{episode}- Episode number -
{episode:02d}- Episode with leading zero -
{episode_title}- Episode title -
{air_date}- Original air date
-
{resolution}- Video resolution (1080p, 720p, etc.) -
{codec}- Video codec name -
{audio_codec}- Audio codec name -
{bitrate}- Video bitrate -
{fps}- Frames per second -
{aspect_ratio}- Video aspect ratio
Number Formatting:
{season:02d} → 01, 02, 03 (two digits with leading zero)
{episode:03d} → 001, 002, 003 (three digits)
{year:04d} → 1999, 2024 (four digits)
Text Formatting:
{title:upper} → THE MATRIX
{title:lower} → the matrix
{title:title} → The Matrix
Conditional Formatting:
{year:?({year})} → (1999) if year exists, empty if not
{resolution:?[{resolution}]} → [1080p] if resolution exists
- Use consistent naming: Stick to one template style
- Plan your structure: Design folder hierarchy before starting
- Consider media servers: Use Plex/Jellyfin-compatible naming
- Backup important settings: Export custom presets
- Start with defaults: Use "High Quality" preset initially
- Test encoding speeds: Find your speed/quality balance
- Consider storage space: Higher quality = larger files
- Use hardware acceleration: Enable for faster processing
- Set up automation: Enable auto-rip for batch processing
- Use consistent output directories: Simplifies organization
- Process similar content together: Use same settings for series
- Monitor disk space: Ensure adequate storage before starting
- Test settings with one disc first: Verify before batch processing
- Keep original discs: Don't discard until verified
- Use post-processing scripts carefully: Test thoroughly
- Regular backups: Protect your ripped content
Settings window appears black/empty
- Solution: Restart application
- Check: macOS compatibility and permissions
Encoding fails or crashes
- Check: Available disk space
- Verify: FFmpeg installation
- Try: Lower quality settings or hardware acceleration disabled
Files not organizing correctly
- Verify: Template syntax in settings
- Check: Directory permissions
- Ensure: Metadata is available for content
Custom presets not saving
- Check: Application permissions
- Verify: Preset name is unique
- Try: Restarting application
Slow encoding
- Enable hardware acceleration
- Lower quality settings
- Close other applications
- Use faster encoding presets
High CPU usage
- Disable two-pass encoding
- Use hardware acceleration
- Lower encoding speed preset
- Process one disc at a time
Large file sizes
- Lower bitrate settings
- Use more efficient codecs (H.265)
- Reduce quality preset
- Enable file size filtering
Poor quality output
- Increase quality preset
- Use higher bitrate
- Enable two-pass encoding
- Check source disc condition
- Check application logs: Look for error messages
- Verify system requirements: Ensure compatibility
- Test with different content: Isolate disc-specific issues
- GitHub Issues: Report bugs with detailed information
- Community forums: Share experiences and solutions
- GitHub Issues: https://github.com/gmoyle/AutoRip2MKV-Mac/issues
- Wiki: https://github.com/gmoyle/AutoRip2MKV-Mac/wiki
- Discussions: Community support and feature requests
- Bug Reports: Detailed issue descriptions help improve the app
- Feature Requests: Suggest new functionality
- Documentation: Help improve user guides
- Code Contributions: Submit pull requests for improvements
- Current Version: v1.2.0
- Release Date: July 2024
- Compatibility: macOS 10.15+
- License: Open source
This guide covers AutoRip2MKV-Mac v1.2.0. Features and settings may vary in different versions.