riplex 0.3.4__tar.gz → 0.3.6__tar.gz

{riplex-0.3.4/src/riplex.egg-info → riplex-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.4
+Version: 0.3.6
 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

{riplex-0.3.4 → riplex-0.3.6}/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.6/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.4 → riplex-0.3.6}/src/riplex/disc/makemkv.py

@@ -6,6 +6,7 @@ import logging
 import platform
 import re
 import subprocess
+import threading
 from dataclasses import dataclass, field
 from pathlib import Path
 
@@ -471,6 +472,7 @@ class MakeMKV:
         title_index: int,
         output_dir: Path,
         progress_callback=None,
+        cancel_event: threading.Event | None = None,
     ) -> RipResult:
         """Rip a single title from disc via ``makemkvcon mkv``."""
         exe = self._require_exe()
@@ -494,6 +496,15 @@ class MakeMKV:
 
         try:
             for line in proc.stdout:
+                if cancel_event and cancel_event.is_set():
+                    proc.terminate()
+                    proc.wait(timeout=5)
+                    return RipResult(
+                        title_index=title_index,
+                        success=False,
+                        output_file="",
+                        error_message="Cancelled by user",
+                    )
                 line = line.rstrip("\n\r")
                 log.debug("makemkvcon: %s", line)
                 raw_lines.append(line)
@@ -559,12 +570,15 @@ def run_rip(
     output_dir: Path,
     makemkvcon: Path | None = None,
     progress_callback=None,
+    cancel_event: threading.Event | None = None,
 ) -> RipResult:
     """Rip a single title from a disc via makemkvcon mkv.
 
     .. deprecated:: Use :pyclass:`MakeMKV` instead.
     """
-    return MakeMKV(makemkvcon).rip(drive, title_index, output_dir, progress_callback)
+    return MakeMKV(makemkvcon).rip(
+        drive, title_index, output_dir, progress_callback, cancel_event
+    )
 
 
 # ---------------------------------------------------------------------------

{riplex-0.3.4 → riplex-0.3.6/src/riplex.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.4
+Version: 0.3.6
 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

{riplex-0.3.4 → riplex-0.3.6}/src/riplex.egg-info/SOURCES.txt

@@ -13,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

{riplex-0.3.4 → riplex-0.3.6}/src/riplex_app/screens/progress.py

@@ -13,13 +13,25 @@ from riplex.snapshot import copy_debug_log, get_debug_dir, save_rip_snapshot
 log = logging.getLogger(__name__)
 
 
+def _format_eta(seconds: int) -> str:
+    """Format seconds into HH:MM:SS or MM:SS."""
+    if seconds < 0:
+        return "..."
+    if seconds >= 3600:
+        h, rem = divmod(seconds, 3600)
+        m, s = divmod(rem, 60)
+        return f"{h}:{m:02d}:{s:02d}"
+    m, s = divmod(seconds, 60)
+    return f"{m}:{s:02d}"
+
+
 class ProgressScreen:
     def __init__(self, app):
         self.app = app
-        self.cancelled = False
+        self._cancel_event = threading.Event()
 
     def build(self) -> ft.Control:
-        self.cancelled = False
+        self._cancel_event.clear()
         selected = self.app.state["selected_titles"]
         disc_info = self.app.state["disc_info"]
         titles = disc_info.titles if disc_info else []
@@ -29,6 +41,10 @@ class ProgressScreen:
         self.total_count = len(selected)
         self.completed_count = 0
 
+        self._rip_start_time = 0.0
+        self._last_pct = -1
+        self._current_title_bytes = 0
+
         self.overall_text = ft.Text(
             f"Ripping 0/{self.total_count} titles...",
             size=16,
@@ -36,11 +52,14 @@ class ProgressScreen:
         )
         self.current_title_text = ft.Text("Preparing...", size=14, color=ft.Colors.GREY_400)
         self.progress_bar = ft.ProgressBar(width=700, value=0)
-        self.progress_detail = ft.Text("0%", size=12, color=ft.Colors.GREY_500)
-        self.log = ft.ListView(spacing=4, height=250, auto_scroll=True)
+        self.progress_pct = ft.Text("0%", size=12, weight=ft.FontWeight.BOLD)
+        self.progress_size = ft.Text("", size=12, color=ft.Colors.GREY_400)
+        self.progress_speed = ft.Text("", size=12, color=ft.Colors.GREY_400)
+        self.progress_eta = ft.Text("", size=12, color=ft.Colors.GREY_400)
+        self.log = ft.ListView(spacing=4, height=200, auto_scroll=True)
         self.cancel_btn = ft.ElevatedButton(
-            "Cancel",
-            icon=ft.Icons.CANCEL,
+            "Stop Ripping",
+            icon=ft.Icons.STOP,
             on_click=self._cancel,
             style=ft.ButtonStyle(bgcolor=ft.Colors.RED_700),
         )
@@ -59,7 +78,15 @@ class ProgressScreen:
                 self.current_title_text,
                 ft.Container(height=10),
                 self.progress_bar,
-                self.progress_detail,
+                ft.Row(
+                    [
+                        self.progress_pct,
+                        self.progress_size,
+                        self.progress_speed,
+                        self.progress_eta,
+                    ],
+                    spacing=20,
+                ),
                 ft.Container(height=20),
                 ft.Text("Log", size=14, weight=ft.FontWeight.BOLD),
                 self.log,
@@ -84,8 +111,8 @@ class ProgressScreen:
         results: list[RipResult] = []
 
         for i, title_idx in enumerate(selected):
-            if self.cancelled:
-                self._log_message("Cancelled by user.", ft.Colors.ORANGE)
+            if self._cancel_event.is_set():
+                self._log_message("Stopped by user.", ft.Colors.ORANGE)
                 break
 
             title = self.title_map.get(title_idx)
@@ -96,7 +123,13 @@ class ProgressScreen:
             self.overall_text.value = f"Ripping {i + 1}/{self.total_count} titles..."
             self.current_title_text.value = f"Title #{title_idx}: {title_name} ({size_gb:.1f} GB)"
             self.progress_bar.value = 0
-            self.progress_detail.value = "Starting..."
+            self.progress_pct.value = "0%"
+            self.progress_size.value = f"0.0/{size_gb:.1f} GB"
+            self.progress_speed.value = ""
+            self.progress_eta.value = ""
+            self._rip_start_time = time.monotonic()
+            self._last_pct = -1
+            self._current_title_bytes = title.size_bytes if title else 0
             self._log_message(f"Starting title #{title_idx}: {title_name}")
             self._update()
 
@@ -108,6 +141,7 @@ class ProgressScreen:
                     output_dir,
                     makemkvcon=makemkvcon,
                     progress_callback=self._on_progress,
+                    cancel_event=self._cancel_event,
                 )
                 results.append(result)
                 elapsed = time.time() - start_time
@@ -137,7 +171,10 @@ class ProgressScreen:
         self.overall_text.value = f"Complete: {sum(1 for r in results if r.success)}/{len(results)} successful"
         self.current_title_text.value = ""
         self.progress_bar.value = 1.0
-        self.progress_detail.value = "100%"
+        self.progress_pct.value = "100%"
+        self.progress_size.value = ""
+        self.progress_speed.value = ""
+        self.progress_eta.value = ""
         self.cancel_btn.visible = False
         self._update()
 
@@ -180,11 +217,38 @@ class ProgressScreen:
 
     def _on_progress(self, progress: RipProgress):
         """Callback from run_rip for progress updates."""
-        if progress.total > 0:
-            pct = progress.current / progress.total
-            self.progress_bar.value = pct
-            self.progress_detail.value = f"{pct * 100:.0f}%"
-            self._update()
+        if progress.max_val <= 0:
+            return
+        pct = progress.current * 100 // progress.max_val
+        if pct == self._last_pct:
+            return  # avoid excessive UI updates
+        self._last_pct = pct
+
+        self.progress_bar.value = pct / 100
+        self.progress_pct.value = f"{pct}%"
+
+        total_bytes = self._current_title_bytes
+        if total_bytes > 0:
+            done_bytes = total_bytes * pct // 100
+            done_gb = done_bytes / (1024 ** 3)
+            total_gb = total_bytes / (1024 ** 3)
+            self.progress_size.value = f"{done_gb:.1f}/{total_gb:.1f} GB"
+
+            elapsed = time.monotonic() - self._rip_start_time
+            if elapsed > 1:
+                speed_mbs = (done_bytes / (1024 ** 2)) / elapsed
+                self.progress_speed.value = f"{speed_mbs:.0f} MB/s"
+                if pct > 0 and speed_mbs > 0:
+                    remaining_bytes = total_bytes - done_bytes
+                    eta_secs = int(remaining_bytes / (speed_mbs * 1024 * 1024))
+                    self.progress_eta.value = f"ETA {_format_eta(eta_secs)}"
+                else:
+                    self.progress_eta.value = "ETA ..."
+            else:
+                self.progress_speed.value = ""
+                self.progress_eta.value = "ETA ..."
+
+        self._update()
 
     def _log_message(self, message: str, color=None):
         """Append a message to the log."""
@@ -193,10 +257,10 @@ class ProgressScreen:
         )
 
     def _cancel(self, e):
-        """Set cancel flag (rip in progress will finish current title)."""
-        self.cancelled = True
+        """Signal cancellation — terminates the active makemkvcon process."""
+        self._cancel_event.set()
         self.cancel_btn.disabled = True
-        self.cancel_btn.text = "Cancelling..."
+        self.cancel_btn.text = "Stopping..."
         self._update()
 
     def _update(self):

{riplex-0.3.4 → riplex-0.3.6}/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()