From ea43074852c0bb787020c215e1a007eba111ea85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kristofer=20S=C3=B6derstr=C3=B6m?=
 <kristofer.soderstrom@gmail.com>
Date: Mon, 2 Mar 2026 17:17:35 +0100
Subject: [PATCH] Update README.md: Add manual installation instructions for
 troubleshooting launcher issues

---
 README.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/README.md b/README.md
index 03f4ae4..ea3636a 100644
--- a/README.md
+++ b/README.md
@@ -46,6 +46,21 @@ Run `./run_Mac.sh` — it will auto-install everything on first run. See [Mac in
 
 > **Note:** The first run with a given model will download it (~75 MB for base, ~500 MB for medium). After that, everything works offline.
 
+### Manual installation (if the launchers don't work)
+If `run_Windows.bat` or `run_Mac.sh` fails (e.g. Python isn't on PATH, or permissions issues), open a terminal in the project folder and run these steps manually:
+```
+python -m venv .venv
+```
+Activate the virtual environment:
+- **Windows:** `.venv\Scripts\activate`
+- **Mac / Linux:** `source .venv/bin/activate`
+
+Then install and run:
+```
+python install.py
+python app.py
+```
+
 ## GPU Support
 This program **does support running on NVIDIA GPUs**, which can significantly speed up transcription times. faster-whisper uses CTranslate2, which requires NVIDIA CUDA libraries for GPU acceleration.