riplex 0.3.6__tar.gz → 0.4.0__tar.gz

riplex-0.4.0/.github/copilot-instructions.md

@@ -0,0 +1,69 @@
+# Copilot Instructions for riplex
+
+## Documentation changelog
+
+When any file under `docs/` is added, modified, or removed, update `docs/changelog.md` with a dated entry describing the change. Follow the [Keep a Changelog](https://keepachangelog.com/) format with sections like Added, Changed, Removed, or Fixed under a date heading.
+
+## Installing from source
+
+First-time setup — create a virtualenv and install in editable mode:
+```
+python3.12 -m venv .venv
+source .venv/bin/activate   # macOS/Linux
+.venv\Scripts\activate      # Windows
+pip install -e ".[dev,gui]"
+```
+
+The `.vscode/settings.json` in this repo points VS Code at `.venv` automatically,
+so the integrated terminal activates it on open. In any external terminal, run
+`source .venv/bin/activate` first.
+
+If you already have a venv active, just install:
+```
+pip install -e ".[dev]"
+```
+
+For the GUI, also include the gui extra:
+```
+pip install -e ".[dev,gui]"
+```
+
+### macOS extras (Homebrew Python only)
+
+If you installed Python via Homebrew, two additional one-time steps are needed:
+
+**1. SSL certificates** — Flet downloads its desktop runtime on first launch and will
+fail with an SSL error without this fix:
+```
+CERT=$(python3.12 -c "import certifi; print(certifi.where())")
+echo "export SSL_CERT_FILE=\"$CERT\"" >> .venv/bin/activate
+echo "export REQUESTS_CA_BUNDLE=\"$CERT\"" >> .venv/bin/activate
+source .venv/bin/activate
+```
+
+**2. Folder picker (tkinter)** — the browse buttons in the GUI require tkinter,
+which Homebrew ships as a separate package:
+```
+brew install python-tk@3.12
+```
+Without this, the browse buttons show a hint telling the user to type the path
+manually instead of crashing silently.
+
+## Running
+
+After installing from source, use the installed entry points:
+```
+riplex rip              # CLI dry-run
+riplex rip --execute    # CLI actual rip
+riplex-ui              # Launch the Flet GUI
+```
+
+Do NOT use `python -m riplex` (that errors — riplex is a library package, not runnable). Do NOT use `python -m riplex_cli.main` when the entry point works.
+
+## Dry-run default
+
+All destructive commands (`rip`, `organize`, `orchestrate`) are dry-run by default. There is no `--dry-run` flag. Use `--execute` to actually perform the operation.
+
+## Testing
+
+Run tests with `pytest` (or `python -m pytest`) from the project root with the venv active. All tests must pass before committing.

{riplex-0.3.6 → riplex-0.4.0}/.github/workflows/release.yml

@@ -69,7 +69,15 @@ jobs:
           path: release/
 
   build-macos:
-    runs-on: macos-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-13
+            arch: x86_64
+          - runner: macos-14
+            arch: arm64
+    runs-on: ${{ matrix.runner }}
     steps:
       - uses: actions/checkout@v4
         with:
@@ -116,12 +124,12 @@ jobs:
       - name: Package macOS artifacts
         run: |
           mkdir -p release
-          cp dist/riplex release/
-          cd dist && zip -r ../release/riplex-ui-macos.zip riplex-ui.app
+          cp dist/riplex release/riplex-${{ matrix.arch }}
+          cd dist && zip -r ../release/riplex-ui-macos-${{ matrix.arch }}.zip riplex-ui.app
 
       - uses: actions/upload-artifact@v4
         with:
-          name: riplex-macos
+          name: riplex-macos-${{ matrix.arch }}
           path: release/
 
   release:
@@ -138,8 +146,10 @@ jobs:
           mkdir release
           cp artifacts/riplex-windows/riplex.exe release/riplex-windows.exe
           cp artifacts/riplex-windows/riplex-ui.exe release/riplex-ui-windows.exe
-          cp artifacts/riplex-macos/riplex release/riplex-macos
-          cp artifacts/riplex-macos/riplex-ui-macos.zip release/
+          cp artifacts/riplex-macos-x86_64/riplex-x86_64 release/riplex-macos-x86_64
+          cp artifacts/riplex-macos-x86_64/riplex-ui-macos-x86_64.zip release/
+          cp artifacts/riplex-macos-arm64/riplex-arm64 release/riplex-macos-arm64
+          cp artifacts/riplex-macos-arm64/riplex-ui-macos-arm64.zip release/
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
@@ -148,5 +158,7 @@ jobs:
           files: |
             release/riplex-windows.exe
             release/riplex-ui-windows.exe
-            release/riplex-macos
-            release/riplex-ui-macos.zip
+            release/riplex-macos-x86_64
+            release/riplex-ui-macos-x86_64.zip
+            release/riplex-macos-arm64
+            release/riplex-ui-macos-arm64.zip

riplex-0.4.0/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+  "python.terminal.activateEnvironment": true
+}

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.6
+Version: 0.4.0
 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
@@ -26,7 +26,7 @@ Automates the tedious manual work around MakeMKV: figuring out what to rip, whic
 If you'd rather use a simple graphical interface instead of the command line, download the pre-built app from the [Releases page](https://github.com/AnyCredit5518/riplex/releases/latest):
 
 - **Windows**: Download `riplex-ui-windows.exe` and double-click to run
-- **macOS**: Download `riplex-ui-macos.zip`, unzip, and open `riplex-ui.app`
+- **macOS**: Download `riplex-ui-macos-arm64.zip` (Apple Silicon) or `riplex-ui-macos-x86_64.zip` (Intel), unzip, and open `riplex-ui.app`
 
 No Python install required. The app walks you through setup and provides buttons for all workflows.
 

{riplex-0.3.6 → riplex-0.4.0}/README.md

@@ -7,7 +7,7 @@ Automates the tedious manual work around MakeMKV: figuring out what to rip, whic
 If you'd rather use a simple graphical interface instead of the command line, download the pre-built app from the [Releases page](https://github.com/AnyCredit5518/riplex/releases/latest):
 
 - **Windows**: Download `riplex-ui-windows.exe` and double-click to run
-- **macOS**: Download `riplex-ui-macos.zip`, unzip, and open `riplex-ui.app`
+- **macOS**: Download `riplex-ui-macos-arm64.zip` (Apple Silicon) or `riplex-ui-macos-x86_64.zip` (Intel), unzip, and open `riplex-ui.app`
 
 No Python install required. The app walks you through setup and provides buttons for all workflows.
 

{riplex-0.3.6 → riplex-0.4.0}/docs/changelog.md

@@ -6,9 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 ## 2026-05-03
 
+### Changed
+
+- Installation guide: macOS pre-built executables now ship as separate `arm64` (Apple Silicon) and `x86_64` (Intel) builds; added instructions to pick the right one and remove the Gatekeeper quarantine flag.
+- Installation guide: "Installing from source" section now includes venv setup steps and a macOS SSL fix for Homebrew Python users (`SSL_CERT_FILE` via certifi).
+- Installation guide: added macOS tkinter section for folder picker support.
+
 ### 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
+- `find_ffprobe()` helper: all ffprobe consumers now check `~/.riplex/bin/`, `/usr/local/bin/`, and `/opt/homebrew/bin/` in addition to PATH.
+- macOS auto-download: "Install Missing Tools" on macOS < 14 auto-downloads ffprobe from evermeet.cx to `~/.riplex/bin/`; opens download pages for MakeMKV and MKVToolNix.
+- macOS .app bundle detection: `find_makemkvcon()` checks `/Applications/MakeMKV.app/`; `find_mkvmerge()` and `find_mkvpropedit()` check `/Applications/MKVToolNix.app/`.
+- Dual-arch macOS CI builds (`macos-13`/x86_64 and `macos-14`/arm64) in release workflow.
+- Arch-aware macOS update checker in GUI updater.
+- Install progress bar and streaming output for Homebrew installs on macOS 14+.
+- Graceful tkinter fallback in folder picker and welcome screen browse buttons.
+- Linux apt support in GUI tool installer.
 
 ## 2026-05-02
 

{riplex-0.3.6 → riplex-0.4.0}/docs/getting-started/installation.md

@@ -14,7 +14,8 @@ Download the latest release for your platform from the [GitHub Releases page](ht
 | Platform | CLI | GUI |
 |---|---|---|
 | Windows | `riplex-windows.exe` | `riplex-ui-windows.exe` |
-| macOS | `riplex-macos` | `riplex-ui-macos.zip` |
+| macOS (Apple Silicon) | `riplex-macos-arm64` | `riplex-ui-macos-arm64.zip` |
+| macOS (Intel) | `riplex-macos-x86_64` | `riplex-ui-macos-x86_64.zip` |
 
 ### Windows
 
@@ -24,10 +25,18 @@ Download the latest release for your platform from the [GitHub Releases page](ht
 
 ### macOS
 
-1. Download `riplex-macos` and/or `riplex-ui-macos.zip`
-2. Make the CLI executable: `chmod +x riplex-macos`
-3. For the GUI, unzip `riplex-ui-macos.zip` and move `riplex-ui.app` to `/Applications/`
-4. Run `./riplex-macos setup` to configure
+1. Pick the build matching your Mac:
+    - Apple Silicon (M1/M2/M3/...): `riplex-macos-arm64` and `riplex-ui-macos-arm64.zip`
+    - Intel: `riplex-macos-x86_64` and `riplex-ui-macos-x86_64.zip`
+
+    Not sure which you have? Run `sysctl -n machdep.cpu.brand_string` in Terminal.
+    "Apple ..." means Apple Silicon; "Intel ..." means Intel.
+2. Make the CLI executable: `chmod +x riplex-macos-*`
+3. For the GUI, unzip the `.zip` and move `riplex-ui.app` to `/Applications/`.
+   The first time you launch it, macOS may block the unsigned app — remove the
+   quarantine flag with `xattr -dr com.apple.quarantine /Applications/riplex-ui.app`
+   and try again.
+4. Run `./riplex-macos-arm64 setup` (or the `x86_64` variant) to configure.
 
 ## Option B: Install via pip
 
@@ -103,21 +112,43 @@ If you want to contribute or run the latest unreleased code:
 ```bash
 git clone https://github.com/AnyCredit5518/riplex.git
 cd riplex
-pip install -e ".[dev]"
+python3.12 -m venv .venv
+source .venv/bin/activate   # macOS/Linux
+pip install -e ".[dev,gui]"
 ```
 
-To also install the Flet-based GUI:
+The repo's `.vscode/settings.json` points VS Code at `.venv` automatically, so
+the integrated terminal activates it on open. In any external terminal, run
+`source .venv/bin/activate` first.
+
+Then launch the GUI with:
 
 ```bash
-pip install -e ".[dev,gui]"
+riplex-ui
 ```
 
-Then launch it with:
+### macOS SSL fix (Homebrew Python only)
+
+If you installed Python via Homebrew and `riplex-ui` crashes on first launch with
+an SSL certificate error, run this one-time fix:
 
 ```bash
-riplex-ui
+CERT=$(python3.12 -c "import certifi; print(certifi.where())")
+echo "export SSL_CERT_FILE=\"$CERT\"" >> .venv/bin/activate
+echo "export REQUESTS_CA_BUNDLE=\"$CERT\"" >> .venv/bin/activate
+source .venv/bin/activate
 ```
 
+### macOS folder picker (Homebrew Python only)
+
+The browse buttons in the GUI use tkinter, which Homebrew ships separately:
+
+```bash
+brew install python-tk@3.12
+```
+
+Without this, clicking a browse button shows a hint to type the path manually instead.
+
 ## External tools
 
 riplex uses these tools under the hood. The setup wizard handles installation, but if you prefer to install manually:

{riplex-0.3.6 → riplex-0.4.0}/pyproject.toml

@@ -23,6 +23,12 @@ dev = [
 ]
 gui = [
     "flet>=0.84",
+    # tkinter is also required for the folder picker buttons but cannot be
+    # installed via pip — it is part of Python's standard library and must be
+    # installed at the OS level:
+    #   macOS (Homebrew Python): brew install python-tk@3.12
+    #   Linux (Debian/Ubuntu):   sudo apt install python3-tk
+    #   Windows:                 included in the standard python.org installer
 ]
 
 [project.scripts]

{riplex-0.3.6 → riplex-0.4.0}/src/riplex/disc/makemkv.py

@@ -19,8 +19,11 @@ _SUBPROCESS_FLAGS: dict = (
 
 log = logging.getLogger(__name__)
 
-# Default search paths for makemkvcon on Windows
+# Common install paths where makemkvcon lives outside of PATH
 _MAKEMKVCON_SEARCH_PATHS = [
+    # macOS .app bundle
+    Path("/Applications/MakeMKV.app/Contents/MacOS/makemkvcon"),
+    # Windows
     Path(r"C:\Program Files\MakeMKV\makemkvcon64.exe"),
     Path(r"C:\Program Files (x86)\MakeMKV\makemkvcon64.exe"),
     Path(r"C:\Program Files\MakeMKV\makemkvcon.exe"),
@@ -649,9 +652,9 @@ def probe_chapter_durations(mkv_path: str | Path) -> list[int]:
     Returns a list of chapter durations in seconds. Returns empty list
     if ffprobe is unavailable or the file has no chapters.
     """
-    import shutil
+    from riplex.scanner import find_ffprobe
 
-    ffprobe = shutil.which("ffprobe")
+    ffprobe = find_ffprobe()
     if not ffprobe:
         log.debug("ffprobe not found, skipping chapter duration extraction")
         return []

{riplex-0.3.6 → riplex-0.4.0}/src/riplex/scanner.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 import json
 import logging
 import platform
+import shutil
 import subprocess
 from pathlib import Path
 from typing import Callable
@@ -21,6 +22,28 @@ _SUBPROCESS_FLAGS: dict = (
     else {}
 )
 
+# Common install locations for ffprobe outside of PATH
+_FFPROBE_SEARCH_PATHS = [
+    Path.home() / ".riplex" / "bin" / "ffprobe",
+    Path("/usr/local/bin/ffprobe"),
+    Path("/opt/homebrew/bin/ffprobe"),
+]
+
+
+def find_ffprobe() -> str | None:
+    """Locate the ffprobe executable.
+
+    Checks PATH first, then ``~/.riplex/bin/``, ``/usr/local/bin/``,
+    and ``/opt/homebrew/bin/``.  Returns the path string or *None*.
+    """
+    path = shutil.which("ffprobe")
+    if path:
+        return path
+    for candidate in _FFPROBE_SEARCH_PATHS:
+        if candidate.is_file():
+            return str(candidate)
+    return None
+
 
 def _probe_file(path: Path) -> ScannedFile:
     """Extract metadata from a single MKV file using ffprobe.
@@ -37,10 +60,14 @@ def _probe_file(path: Path) -> ScannedFile:
     except OSError:
         size_bytes = 0
 
+    ffprobe = find_ffprobe()
+    if not ffprobe:
+        return ScannedFile(name=name, path=abs_path, size_bytes=size_bytes)
+
     try:
         result = subprocess.run(
             [
-                "ffprobe",
+                ffprobe,
                 "-v", "quiet",
                 "-print_format", "json",
                 "-show_entries",
@@ -163,14 +190,8 @@ def scan_folder(
         raise FileNotFoundError(f"Not a directory: {folder}")
 
     # Check for ffprobe availability
-    try:
-        subprocess.run(
-            ["ffprobe", "-version"],
-            capture_output=True,
-            timeout=5,
-            **_SUBPROCESS_FLAGS,
-        )
-    except FileNotFoundError:
+    ffprobe = find_ffprobe()
+    if not ffprobe:
         raise RuntimeError(
             "ffprobe not found. Install FFmpeg to enable MKV duration scanning."
         )

{riplex-0.3.6 → riplex-0.4.0}/src/riplex/splitter.py

@@ -41,6 +41,7 @@ def find_mkvmerge() -> str | None:
     if path:
         return path
     for candidate in [
+        "/Applications/MKVToolNix.app/Contents/MacOS/mkvmerge",
         r"C:\Program Files\MKVToolNix\mkvmerge.exe",
         r"C:\Program Files (x86)\MKVToolNix\mkvmerge.exe",
     ]:
@@ -51,9 +52,15 @@ def find_mkvmerge() -> str | None:
 
 def get_chapters(file_path: str) -> list[Chapter]:
     """Extract chapter information from an MKV file using ffprobe."""
+    from riplex.scanner import find_ffprobe
+
+    ffprobe = find_ffprobe()
+    if not ffprobe:
+        return []
+
     result = subprocess.run(
         [
-            "ffprobe", "-v", "quiet",
+            ffprobe, "-v", "quiet",
             "-print_format", "json",
             "-show_chapters",
             file_path,

{riplex-0.3.6 → riplex-0.4.0}/src/riplex/tagger.py

@@ -36,6 +36,7 @@ def find_mkvpropedit() -> str | None:
     if path:
         return path
     for candidate in [
+        "/Applications/MKVToolNix.app/Contents/MacOS/mkvpropedit",
         r"C:\Program Files\MKVToolNix\mkvpropedit.exe",
         r"C:\Program Files (x86)\MKVToolNix\mkvpropedit.exe",
     ]:
@@ -113,6 +114,7 @@ def read_organized_tag(file_path: str) -> str | None:
     mkvmerge = shutil.which("mkvmerge")
     if mkvmerge is None:
         for candidate in [
+            "/Applications/MKVToolNix.app/Contents/MacOS/mkvmerge",
             r"C:\Program Files\MKVToolNix\mkvmerge.exe",
             r"C:\Program Files (x86)\MKVToolNix\mkvmerge.exe",
         ]:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.6
+Version: 0.4.0
 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
@@ -26,7 +26,7 @@ Automates the tedious manual work around MakeMKV: figuring out what to rip, whic
 If you'd rather use a simple graphical interface instead of the command line, download the pre-built app from the [Releases page](https://github.com/AnyCredit5518/riplex/releases/latest):
 
 - **Windows**: Download `riplex-ui-windows.exe` and double-click to run
-- **macOS**: Download `riplex-ui-macos.zip`, unzip, and open `riplex-ui.app`
+- **macOS**: Download `riplex-ui-macos-arm64.zip` (Apple Silicon) or `riplex-ui-macos-x86_64.zip` (Intel), unzip, and open `riplex-ui.app`
 
 No Python install required. The app walks you through setup and provides buttons for all workflows.
 

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

@@ -9,6 +9,7 @@ pyproject.toml
 .github/agents/riplex.agent.md
 .github/workflows/publish.yml
 .github/workflows/release.yml
+.vscode/settings.json
 docs/architecture.md
 docs/changelog.md
 docs/index.md

{riplex-0.3.6 → riplex-0.4.0}/src/riplex_app/screens/folder_picker.py

@@ -85,8 +85,14 @@ class FolderPickerScreen:
         log.debug("_browse clicked")
 
         def _pick():
-            import tkinter as tk
-            from tkinter import filedialog
+            try:
+                import tkinter as tk
+                from tkinter import filedialog
+            except ModuleNotFoundError:
+                log.warning("tkinter not available; user must type path manually")
+                self.folder_field.hint_text = "Type the path manually (brew install python-tk@3.12 to enable folder picker)"
+                self.app.page.update()
+                return
 
             try:
                 root = tk.Tk()