Skip to content

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

docs: add TUR installation instructions and troubleshooting steps to README

Samir Hossains3d4e4ca1d73a
diff --git a/README.md b/README.md
index d957b3e..9a83eca 100644
--- a/README.md
+++ b/README.md
@@ -95,23 +95,29 @@ The installer selects x86_64 or ARM64, installs under `%LOCALAPPDATA%\MovieBox-T
MovieBox-Tui runs natively in Termux and opens videos directly in your installed Android video apps (VLC, MX Player, etc).
+Preferred install via TUR (Termux User Repository):
+
```bash
-pkg install rust openssl pkg-config
-cargo install moviebox-tui --locked
+pkg install tur-repo
+pkg install moviebox-tui
termux-setup-storage
```
-*(Running `termux-setup-storage` ensures downloads are saved to your real Android `Download` folder)*
-<details>
-<summary><b>Cargo</b></summary>
+TUR packages are distributed separately from crates.io. New MovieBox-Tui GitHub
+releases may take some time to appear in TUR, and users still need to update
+packages normally in Termux (for example via `pkg upgrade`).
+If you previously installed MovieBox-Tui with `cargo install`, see
+[Troubleshooting](#troubleshooting) for the Termux PATH fix.
-Requires Rust 1.90 or newer (this only applies to Cargo and source builds; binary users do not need Rust installed):
+Alternative source-based install:
```bash
+pkg install rust openssl pkg-config
cargo install moviebox-tui --locked
+termux-setup-storage
```
-
-</details>
+*`termux-setup-storage` is recommended if you want downloads saved to the real
+Android `Download` folder.*
<details>
<summary><b>Build from source</b></summary>
@@ -315,6 +321,34 @@ MovieBox-TUI supports inline images via Kitty, Sixel, and iTerm2 protocols.
</details>
+<details>
+<summary><b>Termux: TUR install works, but `moviebox-tui` still points to `~/.cargo/bin`</b></summary>
+
+This usually means you installed MovieBox-Tui with Cargo earlier and your shell
+is still preferring the old Cargo path over the TUR package in `$PREFIX/bin`.
+
+Check the installed TUR binary directly:
+
+```bash
+$PREFIX/bin/moviebox-tui --version
+```
+
+Then clear the shell command cache:
+
+```bash
+hash -r
+```
+
+If needed, move Termux's bin directory earlier in your shell startup file:
+
+```bash
+export PATH="$PREFIX/bin:$HOME/.cargo/bin:$PATH"
+```
+
+Then reload your shell and try `moviebox-tui` again.
+
+</details>
+
<details>
<summary><b>"moviebox-tui: command not found" (Linux / macOS)</b></summary>