From cc5e5359e5b1babeaa8db51f5c03a83757ac406a Mon Sep 17 00:00:00 2001 From: pat-e Date: Mon, 2 Mar 2026 14:18:08 +0100 Subject: [PATCH] docs: Enhance fonttools installation instructions and error messages to differentiate between pip and pipx usage. --- README.md | 9 ++++++++- cleanup_fonts.py | 3 ++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 90dfd3d..0d0572d 100644 --- a/README.md +++ b/README.md @@ -18,11 +18,18 @@ Ensure the following tools and libraries are installed and accessible in your sy 2. **MKVToolNix** (specifically `mkvmerge` and `mkvextract`) 3. **fonttools** (Python library) -Install the required Python dependency via pip: +Install the required Python dependency: + +For Windows or Ubuntu, you can use `pip`: ```bash pip install fonttools ``` +For ArchLinux (or if your system enforces PEP 668), it is recommended to use `pipx`: +```bash +pipx install fonttools +``` + ## Usage Simply place the script inside the directory containing the `.mkv` files you wish to process and run it. You can also place the script in your personal `bin` or `PATH` folder to run it from anywhere. diff --git a/cleanup_fonts.py b/cleanup_fonts.py index eb80759..0e3de73 100644 --- a/cleanup_fonts.py +++ b/cleanup_fonts.py @@ -13,7 +13,8 @@ try: from fontTools.ttLib import TTFont except ImportError: print("Error: 'fonttools' is required to accurately read internal font names.") - print("Please install it by running: pip install fonttools") + print("Please install it by running: pip install fonttools (for Windows/Ubuntu)") + print("Or: pipx install fonttools (for ArchLinux)") sys.exit(1) def get_ass_font_names(ass_path):