Skip to content

Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.

docs: make Windows installer flow inspectable

Samir Hossainsa6bd3e3bdcc6
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53c495b..0797870 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,7 @@
- **Cross-platform release validation**: Run all-feature locked builds/tests, binary startup smoke tests, Unix and Windows installer syntax checks, and release-target builds in CI.
- **Documentation accuracy**: Document Android intent limitations, the actual Termux binary model, macOS-only IINA support, native runtime verification requirements, and the current automated test count.
- **Installer checksum handling**: Compare SHA-256 values case-insensitively on macOS, Linux, and Termux shells.
+- **Windows installer guidance**: Make the inspectable downloaded PowerShell script the documented path instead of direct remote code execution.
## [0.1.13] - 2026-08-21
diff --git a/README.md b/README.md
index 4eeaa50..d53efb0 100644
--- a/README.md
+++ b/README.md
@@ -79,16 +79,18 @@ mkdir -p ~/.local/bin && mv moviebox-tui ~/.local/bin/
### Windows
-Using **PowerShell**:
+Using **PowerShell** (download the script first so you can inspect it):
```powershell
-irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex
+Invoke-WebRequest https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 -OutFile install.ps1
+Get-Content .\install.ps1
+powershell -ExecutionPolicy Bypass -File .\install.ps1
```
Or manual installation:
1. Download `MovieBox_Windows_x64.zip` (or `MovieBox_Windows_arm64.zip`) from [GitHub Releases](https://github.com/mesamirh/MovieBox-Tui/releases/latest).
2. Extract the archive and place `moviebox-tui.exe` in your PATH (e.g. `%LOCALAPPDATA%\Programs\MovieBox-Tui\bin`).
-*(Note: If Windows SmartScreen displays an "Unknown Publisher" prompt on first launch, click **More info** → **Run anyway**)*
+*(The Windows binaries are currently unsigned, so SmartScreen may show an "Unknown Publisher" warning. Verify the release archive against `SHA256SUMS` before running it.)*
---
diff --git a/docs/known-issues.md b/docs/known-issues.md
index 6c78461..a131148 100644
--- a/docs/known-issues.md
+++ b/docs/known-issues.md
@@ -18,6 +18,10 @@ Tracked here so future work and issue reports reference the same facts.
## Environment-dependent
+- **Windows release binaries are currently unsigned.** SmartScreen may show an
+ `Unknown Publisher` warning. Download the archive manually, verify its entry in
+ `SHA256SUMS`, and inspect `install.ps1` before running it; Authenticode signing
+ remains a release-infrastructure task.
- **4KHDHub mirrors rotate and can be region/rate limited.** A file whose only mirrors
are "probe trap" workers (which refuse real streaming ranges) reports
`no playable mirrors` with the reason in the log. Not fixable in-app.
diff --git a/docs/release-checklist.md b/docs/release-checklist.md
index 70f7c89..5f53166 100644
--- a/docs/release-checklist.md
+++ b/docs/release-checklist.md
@@ -102,6 +102,10 @@ Spot-check:
- `install.sh`
- `install.ps1`
+- Windows installation uses the inspectable downloaded-script flow; do not publish
+ documentation that recommends `irm ... | iex`.
+- Verify the Windows archive against `SHA256SUMS` before running the binary. If
+ Authenticode signing is added, verify the signature and certificate chain too.
- Homebrew formula install path
## Exit criteria
diff --git a/install.ps1 b/install.ps1
index 6404d9a..97a9fe0 100644
--- a/install.ps1
+++ b/install.ps1
@@ -25,7 +25,9 @@ if ($Help) {
MovieBox-TUI Installer (Windows PowerShell)
USAGE:
- irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex
+ Invoke-WebRequest https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 -OutFile install.ps1
+ Get-Content .\install.ps1
+ powershell -ExecutionPolicy Bypass -File .\install.ps1
.\install.ps1 [OPTIONS]
OPTIONS: