riplex 0.3.6__tar.gz → 0.5.0__tar.gz

riplex-0.5.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.5.0}/.github/workflows/release.yml

@@ -69,7 +69,7 @@ jobs:
           path: release/
 
   build-macos:
-    runs-on: macos-latest
+    runs-on: macos-14
     steps:
       - uses: actions/checkout@v4
         with:
@@ -116,7 +116,7 @@ jobs:
       - name: Package macOS artifacts
         run: |
           mkdir -p release
-          cp dist/riplex release/
+          cp dist/riplex release/riplex-macos
           cd dist && zip -r ../release/riplex-ui-macos.zip riplex-ui.app
 
       - uses: actions/upload-artifact@v4
@@ -138,7 +138,7 @@ 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-macos release/
           cp artifacts/riplex-macos/riplex-ui-macos.zip release/
 
       - name: Create GitHub Release

riplex-0.5.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.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: riplex
-Version: 0.3.6
+Version: 0.5.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,8 @@ 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** (Apple Silicon): Download `riplex-ui-macos.zip`, unzip, and open `riplex-ui.app`
+- **macOS** (Intel): [Install with pipx](docs/getting-started/installation.md#option-b-install-with-pipx-recommended) — GitHub [deprecated their Intel macOS build runners](https://github.blog/changelog/2024-09-16-github-actions-macos-13-larger-runner-image-brownout-dates/), so pre-built Intel binaries are no longer possible
 
 No Python install required. The app walks you through setup and provides buttons for all workflows.
 

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

@@ -7,7 +7,8 @@ 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** (Apple Silicon): Download `riplex-ui-macos.zip`, unzip, and open `riplex-ui.app`
+- **macOS** (Intel): [Install with pipx](docs/getting-started/installation.md#option-b-install-with-pipx-recommended) — GitHub [deprecated their Intel macOS build runners](https://github.blog/changelog/2024-09-16-github-actions-macos-13-larger-runner-image-brownout-dates/), so pre-built Intel binaries are no longer possible
 
 No Python install required. The app walks you through setup and provides buttons for all workflows.
 

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

@@ -4,11 +4,46 @@ All notable changes to the riplex documentation are recorded here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## 2026-05-08
+
+### Added
+
+- Disc fixture testing pattern for end-to-end classification tests using captured disc data.
+- `tests/test_disc_fixtures.py`: new test file for classification testing against real disc layouts.
+
+## 2026-05-04
+
+### Added
+
+- Troubleshooting guide: macOS-specific sections for tkinter/browse button, SSL certificate errors, Gatekeeper blocking, and tools not found despite being installed.
+- Installation guide: new "Install with pipx" section as the recommended install method for end users — provides globally available `riplex` and `riplex-ui` commands without venv activation.
+
+### Changed
+
+- Installation guide: dropped pre-built Intel macOS binary; macOS downloads are now Apple Silicon only. Intel Mac users directed to install with pipx.
+- Installation guide: "Installing from source" section now clearly scoped to developers, with a note pointing users to pipx for global installs.
+- Installation guide: clearer Gatekeeper instructions as a dedicated step with right-click method.
+- Installation guide: added tip for macOS users recommending install from source.
+
 ## 2026-05-03
 
+### Changed
+
+- Installation guide: macOS pre-built executables now ship as `arm64` (Apple Silicon) only; added instructions to 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.5.0/docs/getting-started/installation.md

@@ -0,0 +1,217 @@
+# Installation
+
+There are two ways to install riplex:
+
+- **Download a pre-built executable** (easiest, no Python needed)
+- **Install via pip** (for Python users who want automatic updates)
+
+Both methods require the same external tools (MakeMKV, ffprobe, mkvmerge).
+
+## Option A: Pre-built executables
+
+Download the latest release for your platform from the [GitHub Releases page](https://github.com/AnyCredit5518/riplex/releases):
+
+| Platform | CLI | GUI |
+|---|---|---|
+| Windows | `riplex-windows.exe` | `riplex-ui-windows.exe` |
+| macOS (Apple Silicon) | `riplex-macos` | `riplex-ui-macos.zip` |
+| macOS (Intel) | — | — |
+
+> **Intel Mac users:** GitHub [deprecated their Intel macOS (macos-13) build
+> runners](https://github.blog/changelog/2024-09-16-github-actions-macos-13-larger-runner-image-brownout-dates/),
+> which were the only way to produce Intel-compatible binaries. Please
+> [install with pipx](#option-b-install-with-pipx-recommended) instead — it's
+> straightforward and works on any Mac.
+
+### Windows
+
+1. Download `riplex-windows.exe` (and optionally `riplex-ui-windows.exe`)
+2. Place them in a folder on your PATH (e.g. `C:\Tools\`)
+3. Open a terminal and run `riplex setup`
+
+### macOS
+
+1. Download `riplex-macos` and `riplex-ui-macos.zip` (Apple Silicon only).
+
+    **Intel Mac?** GitHub deprecated the build runners needed to produce Intel
+    binaries, so these won't work on your machine.
+    Skip to [Option B: Install with pipx](#option-b-install-with-pipx-recommended) instead.
+
+2. For the GUI, unzip the `.zip` and move `riplex-ui.app` to `/Applications/`.
+
+3. **Allow the app to open.** macOS blocks apps from unidentified developers by
+   default. The first time you try to open it, you'll see a warning — do **not**
+   click "Move to Trash." Instead:
+
+    - **Right-click** (or Control-click) on `riplex-ui.app` → choose **Open** →
+      click **Open** in the dialog. macOS remembers this and won't ask again.
+
+    - If that doesn't work, open Terminal and run:
+      ```
+      xattr -dr com.apple.quarantine /Applications/riplex-ui.app
+      ```
+      Then open the app normally.
+
+4. For the CLI, make it executable and remove the quarantine flag:
+    ```
+    chmod +x riplex-macos
+    xattr -dr com.apple.quarantine riplex-macos
+    ```
+    Then run `./riplex-macos setup` to configure.
+
+## Option B: Install with pipx (recommended)
+
+[pipx](https://pipx.pypa.io/) installs Python apps in isolated environments but makes their commands available globally — no venv activation needed. `riplex` and `riplex-ui` just work from any terminal.
+
+### 1. Install Python and pipx
+
+- **Windows**: Download Python from https://www.python.org/downloads/ (**check "Add Python to PATH"**), then:
+    ```
+    pip install pipx
+    pipx ensurepath
+    ```
+- **macOS**:
+    ```
+    brew install python pipx
+    pipx ensurepath
+    ```
+- **Linux**:
+    ```
+    sudo apt install python3 pipx
+    pipx ensurepath
+    ```
+
+Restart your terminal after `ensurepath` so the new PATH takes effect.
+
+### 2. Install and register MakeMKV
+
+Download MakeMKV from https://www.makemkv.com/ and install it.
+
+Then register it with the free beta key:
+
+1. Get the current beta key from https://forum.makemkv.com/forum/viewtopic.php?f=5&t=1053
+2. Open MakeMKV, go to Help > Register, and paste the key
+
+The beta key is updated periodically. Without it, `makemkvcon` (the command-line tool riplex uses) won't function.
+
+### 3. Install riplex
+
+```bash
+pipx install "riplex[gui]"
+```
+
+This installs both `riplex` (CLI) and `riplex-ui` (GUI) as globally available commands.
+
+> [!TIP]
+> To install the CLI only (no GUI), run `pipx install riplex` instead.
+
+### 4. Run setup
+
+```bash
+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)
+
+If you skip setup, it runs automatically the first time you use any command.
+
+### 5. Verify
+
+```bash
+riplex --help
+riplex-ui
+```
+
+Both commands should work from any terminal without activating anything.
+
+### Updating
+
+```bash
+pipx upgrade riplex
+```
+
+## Installing from source (for developers)
+
+If you want to contribute or run the latest unreleased code, use a venv:
+
+```bash
+git clone https://github.com/AnyCredit5518/riplex.git
+cd riplex
+python3.12 -m venv .venv
+source .venv/bin/activate   # macOS/Linux
+pip install -e ".[dev,gui]"
+```
+
+> [!NOTE]
+> With a venv, `riplex` and `riplex-ui` only work while the venv is activated.
+> For a global install that works from any terminal, use
+> [pipx](#option-b-install-with-pipx-recommended) instead.
+
+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
+riplex-ui
+```
+
+### 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
+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:
+
+### MakeMKV
+
+Download from https://www.makemkv.com/. Ensure `makemkvcon` is on your PATH.
+
+- Windows default location: `C:\Program Files (x86)\MakeMKV\`
+- macOS: The app bundle includes makemkvcon
+
+MakeMKV requires a registration key. A free beta key is available at https://forum.makemkv.com/forum/viewtopic.php?f=5&t=1053 and must be entered in MakeMKV (Help > Register) before `makemkvcon` will work. The beta key is updated periodically.
+
+### ffprobe (from ffmpeg)
+
+- **Windows**: `winget install Gyan.FFmpeg`
+- **macOS**: `brew install ffmpeg`
+- **Linux**: `sudo apt install ffmpeg`
+
+### MKVToolNix (mkvmerge, mkvpropedit)
+
+- **Windows**: `winget install MoritzBunkus.MKVToolNix` (or download from https://mkvtoolnix.download/)
+- **macOS**: `brew install mkvtoolnix`
+- **Linux**: `sudo apt install mkvtoolnix`

{riplex-0.3.6 → riplex-0.5.0}/docs/troubleshooting.md

@@ -76,3 +76,79 @@ You'll still get duplicate filtering, 4K preference, play-all detection, and TMD
 
 > [!NOTE]
 > A fix to make `orchestrate` and `organize` handle missing dvdcompare data gracefully is planned.
+
+---
+
+## macOS: "Browse" button does nothing (tkinter not installed)
+
+**Symptom:** In the GUI, clicking the folder browse button does nothing or shows a hint to type the path manually.
+
+**Cause:** The browse dialog requires `tkinter`, which Homebrew Python does not include by default.
+
+**Solution:** Install the tkinter package for your Python version:
+
+```
+brew install python-tk@3.12
+```
+
+Then relaunch `riplex-ui`.
+
+---
+
+## macOS: SSL error when launching the GUI for the first time
+
+**Symptom:** The app crashes or shows an SSL certificate error on first launch. This typically happens with Homebrew-installed Python.
+
+**Cause:** Flet downloads its desktop runtime on first launch. Homebrew Python doesn't include system SSL certificates, so the download fails.
+
+**Solution:** Set the SSL certificate path in your venv activate script (one-time 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
+```
+
+Then relaunch `riplex-ui`.
+
+---
+
+## macOS: "app is damaged" / Gatekeeper blocks the app
+
+**Symptom:** macOS says the app "is damaged and can't be opened" or "cannot be opened because the developer cannot be verified."
+
+**Cause:** macOS quarantines apps downloaded from the internet that aren't signed with an Apple Developer certificate.
+
+**Solution:** Right-click (or Control-click) on `riplex-ui.app`, choose **Open**, then click **Open** in the dialog. macOS remembers this choice and won't ask again.
+
+If that doesn't work, remove the quarantine flag manually:
+
+```
+xattr -dr com.apple.quarantine /Applications/riplex-ui.app
+```
+
+---
+
+## macOS: tools not found despite being installed
+
+**Symptom:** `riplex setup` reports that `ffprobe`, `mkvmerge`, or `makemkvcon` are missing, even though MakeMKV or MKVToolNix is installed.
+
+**Cause:** macOS `.app` bundles install their binaries inside the app package, not on your PATH. Homebrew installs to `/opt/homebrew/bin/` (Apple Silicon) or `/usr/local/bin/` (Intel), which may not be on your PATH in all contexts.
+
+**Solution:** riplex automatically checks these locations, so this should resolve itself as of v0.4.0. If tools are still not found, verify they exist:
+
+```
+# MakeMKV
+ls /Applications/MakeMKV.app/Contents/MacOS/makemkvcon
+
+# MKVToolNix
+ls /Applications/MKVToolNix.app/Contents/MacOS/mkvmerge
+
+# ffprobe (Homebrew)
+ls /opt/homebrew/bin/ffprobe    # Apple Silicon
+ls /usr/local/bin/ffprobe       # Intel
+ls ~/.riplex/bin/ffprobe        # auto-downloaded
+```
+
+If the tool exists but riplex can't find it, you can add it to your PATH manually in your shell profile (`~/.zshrc`).

{riplex-0.3.6 → riplex-0.5.0}/issues/planned-features.md

@@ -75,3 +75,19 @@ tracks when ripping, not just the default/English track.
 - 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
+
+
+## Drop Pre-built Intel macOS Binary
+
+The `macos-13` (Intel) CI runner is slow to queue and GitHub is phasing out
+Intel Mac hardware. Intel Macs are a shrinking minority of users.
+
+### Plan
+
+- Remove the `macos-13` / `x86_64` matrix entry from `release.yml`
+- Remove `riplex-macos-x86_64` and `riplex-ui-macos-x86_64.zip` from the
+  release step
+- Update `updater.py` to stop looking for arch-specific assets (only arm64)
+- Update installation docs: macOS section offers only the ARM build; Intel
+  Mac users are directed to install from source (venv + `pip install -e`)
+- Update README download table accordingly

{riplex-0.3.6 → riplex-0.5.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]