riplex 0.3.3__tar.gz → 0.3.5__tar.gz

riplex-0.3.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AnyCredit5518
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

{riplex-0.3.3/src/riplex.egg-info → riplex-0.3.5}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.3
+Version: 0.3.5
 Summary: Automates the tedious manual work around MakeMKV: figuring out what to rip, which MKV files are actually what, and organizing everything into Plex-compatible folder structures.
 License: MIT
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.27
 Requires-Dist: dvdcompare-scraper>=0.1.6
 Requires-Dist: platformdirs>=4.0
@@ -14,6 +15,7 @@ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: respx>=0.21; extra == "dev"
 Provides-Extra: gui
 Requires-Dist: flet>=0.84; extra == "gui"
+Dynamic: license-file
 
 # riplex
 

{riplex-0.3.3 → riplex-0.3.5}/docs/changelog.md

@@ -4,6 +4,12 @@ All notable changes to the riplex documentation are recorded here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## 2026-05-03
+
+### Added
+
+- New troubleshooting guide (`docs/troubleshooting.md`) covering: makemkvcon not on PATH (Flatpak issue), drive not detected, invalid config file, TMDb API key signup, and dvdcompare lookup failures
+
 ## 2026-05-02
 
 ### Changed

{riplex-0.3.3 → riplex-0.3.5}/docs/getting-started/installation.md

@@ -75,6 +75,13 @@ riplex setup
 The setup wizard will:
 
 1. Ask for your TMDb API key (free at https://www.themoviedb.org/settings/api)
+
+    > [!TIP]
+    > TMDb asks for an app name and URL when you request a key. You can just
+    > enter "riplex" as the app name and `https://github.com/AnyCredit5518/riplex`
+    > as the URL. The rest of the form can be filled with basic info - it doesn't
+    > need to be a real business. The key is approved instantly.
+
 2. Ask where your Plex library and MakeMKV rip folders are
 3. Check for required tools (MakeMKV, ffprobe, mkvmerge, mkvpropedit)
 4. Offer to install any missing tools for you (via winget on Windows, Homebrew on macOS, or apt on Linux)

riplex-0.3.5/docs/troubleshooting.md

@@ -0,0 +1,78 @@
+# Troubleshooting
+
+Common issues and solutions reported by users.
+
+---
+
+## "makemkvcon not on PATH"
+
+**Symptom:** `riplex setup` warns that `makemkvcon` is not found, even though MakeMKV is installed.
+
+**Cause:** On Linux, installing MakeMKV via Flatpak does not include `makemkvcon` (the command-line tool). The Flatpak only packages the GUI.
+
+**Solution:** Install MakeMKV from source using the instructions on the [MakeMKV website](https://www.makemkv.com/forum/viewtopic.php?f=3&t=224). This installs both the GUI and `makemkvcon`.
+
+---
+
+## "Error reading disc" / drive not detected
+
+**Symptom:** `riplex orchestrate` or `riplex rip` can't find your optical drive, or reports "no disc found in any drive."
+
+**Possible causes:**
+
+1. **MakeMKV itself can't see the drive.** Run `makemkvcon info disc:-1` to check. If MakeMKV doesn't list your drive, the problem is at the OS/driver level, not riplex.
+
+2. **MakeMKV not installed correctly (Linux).** If you see an error like `libmakemkv.so.1: cannot open shared object file`, MakeMKV's libraries aren't linked properly. Reinstalling MakeMKV from source usually fixes this.
+
+3. **External drive not recognized.** Try specifying the drive manually:
+   ```
+   riplex orchestrate --drive /dev/sr0    # Linux
+   riplex orchestrate --drive D:          # Windows
+   riplex rip --drive 1                   # by index
+   ```
+
+**Solution:** Verify MakeMKV works first (open the GUI or run `makemkvcon info disc:-1`). If it doesn't see the drive, reinstall MakeMKV. If MakeMKV works but riplex doesn't, use the `--drive` flag to specify the drive manually.
+
+---
+
+## Invalid config file (TOML parse error)
+
+**Symptom:** Running any riplex command crashes with a `TOMLDecodeError` traceback mentioning your config file.
+
+**Cause:** The config file has a syntax error, possibly from hand-editing or a corrupted write.
+
+**Solution:** Re-run setup with the `--force` flag to delete the bad config and start fresh:
+
+```
+riplex setup --force
+```
+
+---
+
+## Getting a TMDb API key
+
+**Symptom:** You're not sure what to enter on the TMDb API key request form because you're not a business or app developer.
+
+**Solution:** TMDb asks for an app name and URL when you request a key. You can enter "riplex" as the app name and `https://github.com/AnyCredit5518/riplex` as the URL. The rest of the form can be filled with basic info - it doesn't need to be a real business. The key is approved instantly.
+
+Sign up and request a key at: https://www.themoviedb.org/settings/api
+
+---
+
+## "dvdcompare lookup failed" / disc not on dvdcompare
+
+**Symptom:** `riplex orchestrate` or `riplex organize` exits with an error about dvdcompare failing to find your disc.
+
+**Cause:** Not every disc release is listed on dvdcompare.net. Niche or region-specific releases may not have entries.
+
+**Workaround:** Use `riplex rip` instead, which handles missing dvdcompare data gracefully by falling back to TMDb runtime matching:
+
+```
+riplex rip "Movie Title"
+riplex rip "Movie Title" --execute
+```
+
+You'll still get duplicate filtering, 4K preference, play-all detection, and TMDb runtime matching. The only thing you lose is automatic title matching and naming, so you'll need to rename and move the file into your Plex library manually after ripping.
+
+> [!NOTE]
+> A fix to make `orchestrate` and `organize` handle missing dvdcompare data gracefully is planned.

riplex-0.3.5/issues/orchestrate-dvdcompare-fallback.md

@@ -0,0 +1,45 @@
+# Orchestrate: dvdcompare fallback for missing discs
+
+## Problem
+
+When `riplex orchestrate` can't find a disc on dvdcompare, it exits with a
+fatal error instead of falling back to duration-based title selection. The
+`rip` command handles this correctly (warns and continues), but `orchestrate`
+does `return 1`.
+
+## Affected users
+
+Anyone using `orchestrate` with a disc that isn't listed on dvdcompare (niche
+releases, old DVDs, foreign titles, etc).
+
+## Workaround
+
+Use `riplex rip` instead of `orchestrate` for single-disc titles not on
+dvdcompare. It warns about the missing dvdcompare data and falls back to
+selecting the main feature by TMDb runtime matching.
+
+## Proposed fix
+
+Change `orchestrate.py` to warn instead of error when dvdcompare fails, then:
+
+1. Skip the multi-disc loop entirely (no disc data to iterate)
+2. Fall through to a single-disc rip using the same heuristics as `rip.py`:
+   - `build_dvd_entries([])` returns empty entries
+   - `select_rippable_titles()` uses TMDb runtime to pick the main feature
+3. After ripping, proceed to the organize step normally
+
+### Complications
+
+The downstream code in orchestrate's disc loop (`disc_order`, disc swap
+prompts, `detect_disc_number`, `_print_disc_overview`) all assume `discs` is
+populated. A full fix needs to either:
+
+- Create a synthetic single-disc `PlannedDisc` entry when dvdcompare fails
+- Or branch early into a simplified single-disc rip path (essentially
+  delegating to `rip`-like behavior) before hitting the disc loop
+
+### Files involved
+
+- `src/riplex_cli/commands/orchestrate.py` (lines ~249-258): the error/return
+- Downstream: disc loop starting at ~line 285, `_print_disc_overview`,
+  `detect_disc_number`, disc swap prompts

riplex-0.3.5/issues/planned-features.md

@@ -0,0 +1,77 @@
+# Planned Features
+
+
+## Multi-Resolution Support (4K + Standard Blu-ray)
+
+Many 4K boxsets include standard Blu-ray discs with the same content at 1080p.
+Some users may want to rip both so Plex can serve the lower-resolution version
+to mobile devices without transcoding.
+
+**Movies**: Supported via Plex "Multi-Version Movies" — multiple files with
+different resolution suffixes in the same folder collapse into one item.
+
+**TV Shows**: NOT officially supported by Plex. No documented multi-version
+episode collapsing.
+
+### Plan
+
+- Support ripping both 4K and standard Blu-ray discs for movies, naming with
+  resolution suffixes during organize.
+- For TV shows, warn users and offer to skip (explain limitation), allow
+  override for users with separate libraries.
+
+
+## Orchestrate Flow (GUI)
+
+The GUI has rip and organize flows. The orchestrate flow (multi-disc pipeline
+with disc-swap prompts) is not yet implemented.
+
+### Key pieces needed
+
+- Disc swap prompt screen
+- Session state tracking across disc swaps (accumulated rip results, metadata)
+- Disc number auto-detection after each swap
+- Error recovery (retry/skip failed disc)
+- Cancel mid-flow and organize what's been ripped so far
+
+
+## Bug Report Submission
+
+### Problem
+
+Snapshot files for debugging are mixed in with media files and have
+inconsistent formats. Users must hunt for debug artifacts across multiple
+locations when filing bug reports.
+
+### Plan
+
+1. Move all debug artifacts into a `_riplex/` subfolder (Plex-ignored).
+2. Consistent v2 snapshot envelope format with type discriminator.
+3. GUI writes same snapshots as CLI.
+4. "Report a Bug" button in GUI: opens pre-filled GitHub issue, copies
+   debug folder path to clipboard.
+5. `.github/ISSUE_TEMPLATE/bug_report.yml` for structured reports.
+
+
+## Interactive Lookup Command
+
+`riplex lookup` currently auto-picks the first TMDb match and default
+dvdcompare release without confirmation. Add interactive selection (reuse
+existing `_pick_best` prompt from planner). Keep `--auto` flag for scripting.
+
+
+## Multi-Language Track Selection
+
+Users in multilingual households want to keep multiple audio and subtitle
+tracks when ripping, not just the default/English track.
+
+### Plan
+
+- Add config options for preferred audio and subtitle languages (e.g.
+  `audio_languages = ["en", "es"]`, `subtitle_languages = ["en", "es", "fr"]`)
+- During rip, pass language preferences to MakeMKV/mkvmerge so all selected
+  tracks are retained
+- During organize, preserve all selected tracks when remuxing
+- GUI: add language selection to setup/config screen
+- Default behavior: keep all tracks (current MakeMKV default) — only filter
+  if the user explicitly configures preferred languages

{riplex-0.3.3 → riplex-0.3.5}/src/riplex/config.py

@@ -33,7 +33,13 @@ def load_config() -> dict[str, Any]:
     for path in _candidate_paths():
         if path.is_file():
             with open(path, "rb") as f:
-                return tomllib.load(f)
+                try:
+                    return tomllib.load(f)
+                except tomllib.TOMLDecodeError as exc:
+                    raise SystemExit(
+                        f"Error: invalid config file {path}\n  {exc}\n"
+                        f"Run 'riplex setup --force' to delete it and start fresh."
+                    ) from None
     return {}
 
 

{riplex-0.3.3 → riplex-0.3.5/src/riplex.egg-info}/PKG-INFO

@@ -1,10 +1,11 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.3
+Version: 0.3.5
 Summary: Automates the tedious manual work around MakeMKV: figuring out what to rip, which MKV files are actually what, and organizing everything into Plex-compatible folder structures.
 License: MIT
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: httpx>=0.27
 Requires-Dist: dvdcompare-scraper>=0.1.6
 Requires-Dist: platformdirs>=4.0
@@ -14,6 +15,7 @@ Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: respx>=0.21; extra == "dev"
 Provides-Extra: gui
 Requires-Dist: flet>=0.84; extra == "gui"
+Dynamic: license-file
 
 # riplex
 

{riplex-0.3.3 → riplex-0.3.5}/src/riplex.egg-info/SOURCES.txt

@@ -1,10 +1,8 @@
 .gitignore
-MONOREPO_PLAN.md
-PLANNED_FEATURES.md
+LICENSE
 README.md
 REFACTOR_PLAN.md
 mkdocs.yml
-plex_naming_rules.md
 pyproject.toml
 .github/copilot-instructions.md
 .github/ISSUE_TEMPLATE/bug_report.yml
@@ -15,6 +13,7 @@ docs/architecture.md
 docs/changelog.md
 docs/index.md
 docs/naming-rules.md
+docs/troubleshooting.md
 docs/getting-started/configuration.md
 docs/getting-started/installation.md
 docs/guide/lookup.md
@@ -23,6 +22,8 @@ docs/guide/organize.md
 docs/guide/workflow.md
 docs/reference/cli.md
 issues/cross-disc-dvdcompare-matching.md
+issues/orchestrate-dvdcompare-fallback.md
+issues/planned-features.md
 src/riplex/__init__.py
 src/riplex/cache.py
 src/riplex/config.py

{riplex-0.3.3 → riplex-0.3.5}/src/riplex_app/screens/welcome.py

@@ -346,8 +346,11 @@ class WelcomeScreen:
                         self.app.page.update()
                         return
 
-                self._install_status.value = "Done! Restart the app for changes to take effect."
+                self._install_status.value = "Done! Reloading..."
                 self.app.page.update()
+                import time
+                time.sleep(1.5)
+                self.app.navigate("welcome")
             except Exception as exc:
                 self._install_status.value = f"Install failed: {exc}. Try the manual links above."
                 self.app.page.update()

{riplex-0.3.3 → riplex-0.3.5}/src/riplex_cli/commands/setup.py

@@ -53,7 +53,7 @@ def _offer_install(missing: list[str]) -> None:
     print("\n  Installation complete. You may need to restart your terminal for PATH changes to take effect.")
 
 
-def run_setup() -> int:
+def run_setup(force: bool = False) -> int:
     """Interactive setup wizard to create or update the riplex config file."""
     import shutil
 
@@ -62,9 +62,14 @@ def run_setup() -> int:
     print("riplex setup")
     print(f"Config file: {config_path}\n")
 
-    existing: dict[str, str] = load_config()
-    if existing:
-        print("(Existing config found. Press Enter to keep current values.)\n")
+    if force and config_path.is_file():
+        config_path.unlink()
+        print("(Existing config deleted. Starting fresh.)\n")
+        existing: dict[str, str] = {}
+    else:
+        existing = load_config()
+        if existing:
+            print("(Existing config found. Press Enter to keep current values.)\n")
 
     def prompt(key: str, label: str, hint: str = "", mask: bool = False) -> str:
         current = existing.get(key, "")

{riplex-0.3.3 → riplex-0.3.5}/src/riplex_cli/main.py

@@ -325,10 +325,16 @@ def _build_parser() -> argparse.ArgumentParser:
     )
 
     # --- setup ---
-    subs.add_parser(
+    setup_parser = subs.add_parser(
         "setup",
         help="Interactive setup wizard to create or update the config file.",
     )
+    setup_parser.add_argument(
+        "--force",
+        action="store_true",
+        default=False,
+        help="Delete existing config and start fresh.",
+    )
 
     return parser
 
@@ -343,7 +349,7 @@ async def _run(args: argparse.Namespace) -> int:
     if args.command == "orchestrate":
         return await run_orchestrate(args)
     if args.command == "setup":
-        return run_setup()
+        return run_setup(force=getattr(args, "force", False))
     return 1
 
 

riplex-0.3.3/MONOREPO_PLAN.md

@@ -1,115 +0,0 @@
-# Monorepo Refactor Plan
-
-## Project Context
-
-riplex automates disc ripping and file organization for Plex. It reads physical discs via MakeMKV, identifies what's on them using TMDb and dvdcompare.net metadata, rips the right titles, then deduplicates, matches, renames, and moves files into the exact folder structure Plex expects.
-
-There are currently two repos:
-- **riplex** (`C:\Users\asher\Projects\anycredit5518\riplex`): the library and CLI, published to PyPI
-- **riplex-app** (`C:\Users\asher\Projects\anycredit5518\riplex-app`): a Flet-based GUI that depends on riplex as a pip package
-
-## Problem
-
-The current two-repo setup has issues:
-
-1. **Shared logic is trapped in `cli.py`**: Functions like disc format detection, release scoring, disc number inference, and title extraction are private helpers in the CLI module. The GUI needs the same logic but can't access it, so it duplicates it.
-
-2. **Circular development friction**: Changing a shared algorithm means updating both repos, keeping them in sync, and dealing with version pinning.
-
-3. **Distribution complexity**: Users who want the GUI must install two packages. Building the GUI .exe requires a working riplex install.
-
-## Goal
-
-Consolidate into a single repo with a clean separation of concerns:
-
-- **Library layer**: all business logic, reusable by any frontend
-- **CLI layer**: thin wrapper that handles argument parsing, terminal formatting, and interactive prompts
-- **GUI layer**: thin wrapper that handles Flet screens and user interaction
-
-Both the CLI and GUI should be thin consumers of the library. Neither should contain business logic.
-
-## Requirements
-
-1. **Single repo**: all code lives in one place, one set of tests, one CI pipeline
-2. **Clean library API**: shared orchestration logic must be importable as a public module (not private `_functions` buried in a CLI file)
-3. **Independent installability**: `pip install riplex` gets you library + CLI (no GUI dependencies). GUI is optional via `pip install riplex[gui]` or standalone binary.
-4. **Zero CLI regression**: the `riplex` command must behave identically after the refactor. All existing tests must pass at every step.
-5. **Standalone GUI binary**: the GUI can be packaged as a .exe/.app for users who don't have Python
-6. **Atomic commits**: each commit should be a self-contained logical change that doesn't break the build
-
-## Target Architecture
-
-```
-riplex/
-  src/
-    riplex/              # Shared library (all business logic)
-    riplex_cli/          # CLI thin wrapper (argparse, terminal formatting, prompts)
-    riplex_app/          # GUI thin wrapper (Flet screens, no business logic)
-  tests/
-  docs/
-  pyproject.toml
-```
-
-### Distribution
-
-| Install method | What you get |
-|---|---|
-| `pip install riplex` | Library + CLI |
-| `pip install riplex[gui]` | Library + CLI + GUI (flet dependency) |
-| GitHub Release .exe/.app | Standalone GUI binary |
-
-## Scope of Work
-
-The core of this refactor is extracting shared logic out of `cli.py` so both frontends can use it, then bringing the GUI source into this repo.
-
-Key areas to address:
-- `cli.py` is ~2800 lines mixing business logic with CLI presentation. The reusable pipeline logic (disc detection, format inference, release selection/scoring, disc number detection, title inference, folder creation, manifest handling) needs to become a proper public module.
-- The GUI currently duplicates some of this logic (release scoring, format detection). After extraction, remove the duplicates.
-- `pyproject.toml` needs to declare multiple packages, entry points for both CLI and GUI, and an optional `[gui]` dependency group.
-- CI needs a new workflow to build GUI binaries on tagged releases.
-- The standalone `riplex-app` repo should be archived with a pointer to the monorepo.
-
-## Implementation Recommendations
-
-These are suggested approaches, not prescriptive steps. Use judgment on the exact module boundaries and function signatures.
-
-### Extracting shared logic
-
-Create a module (e.g. `riplex.orchestrate` or similar) to house the pipeline functions currently private in `cli.py`. Candidates include:
-- Disc format detection from resolution metadata
-- Title inference from volume labels and MKV title tags
-- Media type inference (movie vs TV)
-- Release scoring by duration matching
-- Disc number auto-detection
-- Rip folder creation and manifest handling
-
-### Splitting the CLI
-
-Move argparse setup, command dispatch, terminal-specific formatting (progress bars, dry-run banners, rip guide printing), and the interactive setup wizard into `src/riplex_cli/`. The CLI imports from `riplex.*` for all logic.
-
-### Bringing in the GUI
-
-The GUI source at `riplex-app/src/riplex_app/` already imports from `riplex.*` so it should mostly work after copying. Replace any duplicated logic with imports from the new shared module.
-
-### Suggested work order
-
-1. Extract the shared module from `cli.py` first (independently testable, doesn't break anything)
-2. Create `riplex_cli/` and move CLI wrapper code
-3. Verify all tests pass and CLI behaves identically
-4. Copy GUI source in, remove duplicates, update imports
-5. Update `pyproject.toml`
-6. Add GUI build workflow
-7. Merge to main when stable
-
-## Constraints
-
-- Work on the `monorepo` branch until stable
-- All existing tests must pass at every step
-- The GUI does not need its own test suite yet (manual testing is fine)
-- Do not change CLI behavior unless explicitly intended
-
-## GUI Feedback (to address post-merge)
-
-- Done screen: should auto-update when ripping finishes (currently requires a click)
-- Done screen: add "Organize" button as a next step after ripping
-- Multi-disc flow: prompt to insert next disc instead of showing the final "done" screen