RipSharp is a command-line tool for automated optical disc ripping and file naming. It integrates MakeMKV for disc extraction with TMDB, OMDB, and TVDB metadata providers to generate properly organized video files with correct naming and metadata for movies and TV shows. Extracted tracks are re-encoded with FFmpeg using H.264 (slow, CRF 22) for video and AAC for audio, with optional English subtitle embedding.

Features

• Automatic disc detection — Identifies DVD, Blu-ray, and UHD discs
• MakeMKV integration — Extracts titles without quality loss
• Multi-provider metadata — Fetches movie/TV info from TMDB, OMDB, and TVDB
• TV episode resolution — Looks up episode titles for proper naming
• H.264 re-encoding — Compresses video with FFmpeg (CRF 22, slow preset)
• Audio handling — Copies AAC/AC3/EAC3, transcodes others to AAC
• English filtering — Selects English audio tracks and optional subtitles
• Smart file naming — Generates organized filenames with metadata
• Progress tracking — Real-time display for scanning, ripping, and encoding

Requirements

Software

• MakeMKV – makemkv.com
• FFmpeg – See installation options below
• .NET SDK 10.0+ – dotnet.microsoft.com/download

API Keys (Optional)

• TMDB – themoviedb.org/settings/api (free)
• OMDB – omdbapi.com/apikey.aspx (free tier)
• TVDB – thetvdb.com/dashboard/account/apikeys (free)

Hardware

• Optical disc drive (DVD/Blu-ray/UHD) or ISO file
• 5–100 GB free disk space per disc

Quick Start

1. Install dependencies

   Install MakeMKV from https://www.makemkv.com/

   Install FFmpeg (choose one):

   Ubuntu/Debian:

   Fedora:

   Arch:

   openSUSE:

   sudo zypper install ffmpeg

   Alpine:

   macOS (Homebrew):

   Windows (winget):

   winget install --id Gyan.FFmpeg

   Install .NET SDK 10.0+ from https://dotnet.microsoft.com/download

2. Clone and build

   git clone https://github.com/mapitman/ripsharp.git
   cd ripsharp
   dotnet build src/RipSharp

3. Set API keys (optional but recommended)

   export TMDB_API_KEY="your_key_here"
   export OMDB_API_KEY="your_key_here"
   export TVDB_API_KEY="your_key_here"

4. Rip a disc

   # Movie from physical disc (auto-detected)
   dotnet run --project src/RipSharp -- --output ~/Movies
   
   # TV series with episode titles
   dotnet run --project src/RipSharp -- --output ~/TV --mode tv --title "Breaking Bad" --season 1
   
   # From ISO file
   dotnet run --project src/RipSharp -- --output ~/Movies --disc "file:/path/to/movie.iso"

Install as a Global Tool

Install from NuGet:

dotnet tool install -g BugZapperLabs.RipSharp

Run:

ripsharp --output ~/Movies

Check the version:

Pack and install locally

dotnet pack -c Release src/RipSharp /p:Version=0.1.0
dotnet tool install -g BugZapperLabs.RipSharp --add-source src/RipSharp/bin/Release

If you version from git tags in CI, pass the tag version as /p:Version=1.2.3 during dotnet pack.

Options

Required

Optional

Environment Variables

Configuration File

RipSharp loads configuration from the first file it finds in these locations:

Linux:

1. $XDG_CONFIG_HOME/ripsharp/config.yaml
2. $HOME/.config/ripsharp/config.yaml
3. $HOME/.ripsharp.yaml
4. ./ripsharp.yaml
5. ./appsettings.yaml

Windows:

1. %APPDATA%/ripsharp/config.yaml
2. %USERPROFILE%/.ripsharp.yaml
3. ./ripsharp.yaml
4. ./appsettings.yaml

macOS:

1. $HOME/.config/ripsharp/config.yaml
2. $HOME/.ripsharp.yaml
3. ./ripsharp.yaml
4. ./appsettings.yaml

If no config file exists, RipSharp creates one in the first personal location above (for example, $XDG_CONFIG_HOME/ripsharp/config.yaml on Linux).

Theming

Themes are loaded from a YAML file located under a themes subdirectory in the config directory and bound to options. On startup, RipSharp writes bundled themes into that directory if they are missing and does not overwrite existing files. Set the theme name in your config file:

theme: "catppuccin mocha"

Built-in themes:

• "catppuccin latte"
• "catppuccin frappe"
• "catppuccin macchiato"
• "catppuccin mocha"
• "dracula"
• "nord"
• "tokyo-night"
• "gruvbox dark"
• "gruvbox light"

Theme file format (YAML):

theme:
   colors:
      success: "#94e2d5"
      error: "#f38ba8"
      warning: "#f9e2af"
      info: "#89b4fa"
      accent: "#89dceb"
      muted: "#6c7086"
      highlight: "#cba6f7"
   emojis:
      success: "✓"
      error: "❌"
      warning: "⚠️"
      insert_disc: "💿"
      disc_detected: "📀"
      scan: "🔍"
      disc_type: "💽"
      title_found: "🎞️"
      tv: "📺"
      movie: "🎬"

Building

git clone https://github.com/mapitman/ripsharp.git
cd ripsharp
dotnet restore src/RipSharp
dotnet build src/RipSharp

To run without building separately:

dotnet run --project src/RipSharp -- --output ~/Movies

Examples

Movie with Custom Title

dotnet run --project src/RipSharp -- --output ~/Movies --title "The Matrix" --year 1999

Output: ~/Movies/The Matrix (1999).mkv

TV Series Season

dotnet run --project src/RipSharp -- --output ~/TV --mode tv --title "Breaking Bad" --season 1

Output: ~/TV/Breaking Bad - S01E01 - Pilot.mkv, ~/TV/Breaking Bad - S01E02 - Cat's in the Bag....mkv, etc.

Using Alternate Disc Drive

dotnet run --project src/RipSharp -- --output ~/Movies --disc disc:1

Ripping from ISO File

dotnet run --project src/RipSharp -- --output ~/Movies --disc "file:/path/to/movie.iso"

Output: Processes the ISO file instead of a physical disc

See EXAMPLES.md for more detailed examples.

File Naming

RipSharp automatically generates organized filenames based on metadata lookup results.

Movies

Format: Title (Year).mkv

Examples:

• The Matrix (1999).mkv
• Inception (2010).mkv
• The Shawshank Redemption (1994).mkv

TV Series

Format: Show Name - S##E## - Episode Title.mkv

Examples:

• Breaking Bad - S01E01 - Pilot.mkv
• The Legend of Korra - S01E01 - Welcome to Republic City.mkv
• Game of Thrones - S03E09 - The Rains of Castamere.mkv

Note: Episode titles require a TVDB API key. Without it, files are named Show Name - S##E##.mkv.

How It Works

RipSharp follows a streamlined workflow to automatically process optical discs:

1. Scan — Uses MakeMKV to detect all titles on the disc
2. Detect — Analyzes title durations to identify content type (movie vs TV series)
3. Lookup — Queries metadata providers (TMDB, OMDB, TVDB) for titles and episode information
4. Rip — Extracts titles using MakeMKV at highest quality
5. Encode — Re-encodes with FFmpeg (H.264, AAC) with parallel processing for efficiency
6. Rename — Generates organized filenames and moves to output directory
7. Cleanup — Removes temporary files automatically

Troubleshooting

"Missing required tools" error

Ensure all dependencies are installed and in PATH:

which makemkvcon ffmpeg ffprobe dotnet

Disc not detected

1. Insert disc and wait for it to be recognized by the system
2. Check if readable: makemkvcon info disc:0
3. Try alternate device: --disc disc:1 or specify device path

Insufficient disk space

Space requirements by disc type:

• DVD: 4–8 GB
• Blu-ray: 15–35 GB
• UHD 4K: 40–100 GB

Ensure both --temp and --output directories have sufficient space.

MakeMKV beta key required

MakeMKV requires a license key. Get the latest beta key from: https://www.makemkv.com/forum/viewtopic.php?f=5&t=1053

Permission denied

Some systems require elevated permissions to access optical drives:

sudo dotnet run --project src/RipSharp -- --output ~/Movies

Support

• Check Troubleshooting for common issues
• Open an issue on GitHub: https://github.com/mapitman/ripsharp/issues
• See examples in EXAMPLES.md
• MakeMKV forums can help with drive or ripping issues: https://www.makemkv.com/forum/

Performance

Typical ripping and encoding times vary by disc type, drive speed, and system performance.

Factors affecting performance:

• Optical drive read speed
• CPU encoding performance
• Disc condition and read errors
• Parallel processing enabled (default)

Note: Times include both ripping and encoding. Use --sequential to disable parallel processing if needed.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - see LICENSE for details.

Note: Ensure you own the physical media and comply with applicable copyright laws when ripping discs.

Acknowledgments

RipSharp is built on top of these excellent tools:

• MakeMKV — Disc ripping and extraction engine
• FFmpeg — Media encoding and processing
• TMDB — Movie and TV series metadata
• OMDB — Additional movie database
• TVDB — TV episode information