Skip to main content

riplex

Automatically organizes MKV files from physical disc collections into Plex-compatible folder structures with the right names, the right folders, and no manual work.

riplex includes both a desktop app for guided ripping and a full CLI for terminal-first and automated workflows.

Rip flow demo

Why?

After using MakeMKV to back up a disc, you're left with a pile of generically-named files (title_t00.mkv, title_t01.mkv, ...) and no idea which is the main film, which are featurettes, which are duplicates, and which is the play-all compilation you didn't need. For a multi-disc TV series, you're looking at hours of manual effort: reading disc cases, Googling runtimes, renaming files one by one, and building the exact folder hierarchy Plex demands.

riplex solves this by pulling metadata from TMDb (canonical titles, years, episode info) and dvdcompare.net (per-disc content breakdowns including featurettes, deleted scenes, runtimes), then automatically classifying, deduplicating, matching, renaming, and organizing everything into the correct Plex structure.

Get started

Start with the Getting Started guide. It covers all three install paths:

  • Pre-built app: fastest way to try riplex. Download links and platform-specific notes are in the installation guide.
  • pipx: recommended if you have Python or do not mind installing it. See Option B.
  • From source: for developers and unsupported binary platforms. See Option C.

If you just want the desktop app right now, the latest binaries are on the Releases page. For the guided desktop flow after install, see the GUI Walkthrough.

If you prefer the command line, riplex also ships a full CLI with lookup, rip, organize, and orchestrate workflows. For the end-to-end terminal flow, see the CLI Workflow guide.

After installing:

  1. Run setup. The GUI walks you through it on first launch, or you can use riplex setup.
  2. If you want to see the GUI step by step, read the GUI Walkthrough.
  3. Follow the CLI Workflow guide for the end-to-end flow.
  4. If you prefer the terminal, use the CLI reference for command details.

What it looks like

Instead of leaving you to sort through a wall of raw MakeMKV titles, riplex helps you understand what is actually on the disc and choose the titles worth ripping. It surfaces likely matches, highlights junk and duplicates, and helps you avoid play-all traps.

Title selection

More screenshots: welcome, disc detection, metadata lookup, release picker, disc overview.

Requirements

riplex uses MakeMKV, ffmpeg, and MKVToolNix under the hood. The setup wizard installs them for you on Windows (winget), macOS (Homebrew), and Debian/Ubuntu Linux (apt). On other platforms see the installation guide.

You'll also need a free TMDb API key. The wizard prompts you for it.

Data sources

  • TMDb: canonical movie and TV metadata (titles, years, episodes, runtimes)
  • dvdcompare.net: per-disc content breakdowns (featurettes, deleted scenes, play-all groupings, runtimes). An invaluable community resource.
  • dvdcompare-scraper: Python client for dvdcompare.net. Powers riplex's disc lookup. Contributions welcome.

Documentation

License

MIT

Metadata

Release files for riplex 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for riplex 1.0.1
File Size Uploaded Provenance Actions
riplex-1.0.1.tar.gz 2.4 MB Without provenance Details for riplex-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for riplex 1.0.1
File Interpreter ABI Platform Actions
riplex-1.0.1-py3-none-any.whl Python 3 none any Details for riplex-1.0.1-py3-none-any.whl

Total release size: 2.6 MB

Release files / riplex-1.0.1.tar.gz

Download URL riplex-1.0.1.tar.gz
Size 2.4 MB
Tags Source
SHA-256 checksum
How to use checksums
dc2ebd6809c550b0f9709637b0b1660b7ebc59e1089dbf8db60c7e19478f1d72
BLAKE2b-256 checksum
How to use checksums
4d3a50ca0f2fddcb6859b9802b0e5dc1cb4f7e23aabb44b2815d5df284cb0faf
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Release files / riplex-1.0.1-py3-none-any.whl

Download URL riplex-1.0.1-py3-none-any.whl
Size 263.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e5374fc9d4e7718c688c0f5ad5cbccf6619f5fba66d3e1f4d07ba73de5e31474
BLAKE2b-256 checksum
How to use checksums
a6cf7a2b0ae22f8082561621ea25a7602364b8e4989e3c623ab0732e611e7c0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Security for riplex 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page