Terminal interface to find, download, and stream movies, TV shows, and live TV using local media players.
param(
[string]$Version = "",
[string]$InstallDir = "",
[switch]$Force,
[switch]$DryRun,
[switch]$NoModifyPath,
[switch]$Uninstall,
[switch]$Help
)
$ErrorActionPreference = "Stop"
$ProgressPreference = "SilentlyContinue"
try {
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
} catch {}
try {
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls13
} catch {}
Set-StrictMode -Version Latest
$AppName = "MovieBox-Tui"
$BinName = "moviebox-tui.exe"
$Repo = "mesamirh/MovieBox-Tui"
$DefaultInstallDir = Join-Path $env:LOCALAPPDATA "Programs\MovieBox-Tui\bin"
if ($Help) {
Write-Host @"
MovieBox-TUI Installer (Windows PowerShell)
USAGE:
irm https://raw.githubusercontent.com/mesamirh/MovieBox-Tui/main/install.ps1 | iex
.\install.ps1 [OPTIONS]
OPTIONS:
-Version <tag> Install a specific version (e.g. v0.1.14)
-InstallDir <path> Install binary to a custom directory
-Force Reinstall even if already at the latest version
-DryRun Perform preflight checks without writing files
-NoModifyPath Do not modify User PATH environment variable
-Uninstall Uninstall MovieBox-TUI from your system
-Help Show this help message
"@
return
}
function Write-Step { param([string]$Message) Write-Host " > " -ForegroundColor Cyan -NoNewline; Write-Host $Message }
function Write-Success { param([string]$Message) Write-Host " + " -ForegroundColor Green -NoNewline; Write-Host $Message }
function Write-Warn { param([string]$Message) Write-Host " ! " -ForegroundColor Yellow -NoNewline; Write-Host $Message }
function Write-Err { param([string]$Message) Write-Host " x " -ForegroundColor Red -NoNewline; Write-Host $Message }
if ($Version -and $Version[0] -ne "v") {
$Version = "v$Version"
}
function Get-UserPathRaw {
param([ref]$Kind)
$key = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey("Environment")
if (-not $key) { return "" }
try {
$raw = $key.GetValue("Path", "", [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
try { $Kind.Value = $key.GetValueKind("Path") } catch { $Kind.Value = [Microsoft.Win32.RegistryValueKind]::ExpandString }
return [string]$raw
} finally {
$key.Close()
}
}
function Set-UserPathRaw {
param([string]$NewPath, [Microsoft.Win32.RegistryValueKind]$ValueKind)
$key = [Microsoft.Win32.Registry]::CurrentUser.OpenSubKey("Environment", $true)
if (-not $key) { return }
try { $key.SetValue("Path", $NewPath, $ValueKind) } finally { $key.Close() }
}
function Broadcast-EnvironmentChange {
try {
if (-not ([System.Management.Automation.PSTypeName]'Win32.NativeMethods'.Type)) {
Add-Type -Namespace Win32 -Name NativeMethods -MemberDefinition @'
[DllImport("user32.dll", SetLastError = true, CharSet = CharSet.Auto)]
public static extern IntPtr SendMessageTimeout(
IntPtr hWnd, uint Msg, UIntPtr wParam, string lParam,
uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);
'@ -ErrorAction SilentlyContinue
}
[UIntPtr]$result = [UIntPtr]::Zero
[Win32.NativeMethods]::SendMessageTimeout(
[IntPtr]0xffff, 0x001A, [UIntPtr]::Zero, "Environment", 2, 5000, [ref]$result) | Out-Null
} catch {}
}
function Add-ToUserPath {
param([string]$Directory)
$kind = [Microsoft.Win32.RegistryValueKind]::ExpandString
$raw = Get-UserPathRaw -Kind ([ref]$kind)
$segments = @($raw -split ";" | Where-Object { $_ })
if ($segments -notcontains $Directory.TrimEnd("\")) {
$joined = if ($raw.Trim()) { "$raw;$Directory" } else { $Directory }
Set-UserPathRaw -NewPath $joined -ValueKind $kind
Broadcast-EnvironmentChange
return $true
}
return $false
}
function Remove-FromUserPath {
param([string[]]$Directories)
$kind = [Microsoft.Win32.RegistryValueKind]::ExpandString
$raw = Get-UserPathRaw -Kind ([ref]$kind)
if (-not $raw) { return $false }
$normalized = @($Directories | ForEach-Object { $_.TrimEnd("\").ToLowerInvariant() })
$kept = @($raw -split ";" | Where-Object { $_ -and ($normalized -notcontains $_.TrimEnd("\").ToLowerInvariant()) })
if ($kept.Count -eq @($raw -split ";" | Where-Object { $_ }).Count) { return $false }
Set-UserPathRaw -NewPath ($kept -join ";") -ValueKind $kind
Broadcast-EnvironmentChange
return $true
}
function Get-TerminalCols {
$Cols = 80
try {
if ($Host.UI.RawUI.WindowSize.Width -gt 0) {
$Cols = $Host.UI.RawUI.WindowSize.Width
}
} catch {
$Cols = 80
}
return $Cols
}
function Print-Header {
$Cols = Get-TerminalCols
if ($Cols -ge 65) {
$BannerWidth = 60
$Lines = @(
" __ __ _ ____ _____ _ _ ___ ",
"| \/ | _____ _(_) ___| __ ) _____ __ |_ _| | | |_ _|",
"| |\/| |/ _ \ \ / / |/ _ \ _ \ / _ \ \/ / | | | | | || | ",
"| | | | (_) \ V /| | __/ |_) | (_) > < | | | |_| || | ",
"|_| |_|\___/ \_/ |_|\___|____/ \___/_/\_\ |_| \___/|___|"
)
} elseif ($Cols -ge 36) {
$BannerWidth = 31
$Lines = @(
"█▀▄▀█ █▀█ █ █ █ █▀▀ █▀▄ █▀█ ▀▄▀",
"█ ▀ █ █▄█ ▀▄▀ █ ██▄ █▄▀ █▄█ █ █"
)
} else {
$BannerWidth = 12
$Lines = @(
"MovieBox-TUI"
)
}
$BannerPad = [Math]::Max(0, [int][Math]::Floor(($Cols - $BannerWidth) / 2))
$Sub = "Official Installer"
$SubPad = [Math]::Max(0, [int][Math]::Floor(($Cols - $Sub.Length) / 2))
foreach ($Line in $Lines) {
if ($BannerPad -gt 0) {
Write-Host ((" " * $BannerPad) + $Line) -ForegroundColor Magenta
} else {
Write-Host $Line -ForegroundColor Magenta
}
}
if ($SubPad -gt 0) {
Write-Host ((" " * $SubPad) + $Sub + "`n") -ForegroundColor Cyan
} else {
Write-Host ($Sub + "`n") -ForegroundColor Cyan
}
}
function Do-Uninstall {
Print-Header
Write-Step "Uninstalling $AppName..."
$Found = $false
$TargetDirs = @(
$DefaultInstallDir,
"$env:LOCALAPPDATA\MovieBox-Tui"
)
foreach ($Dir in $TargetDirs) {
$Exe = Join-Path $Dir $BinName
if (Test-Path $Exe) {
try {
$RunningProcesses = Get-Process -Name "moviebox-tui" -ErrorAction SilentlyContinue
if ($RunningProcesses) {
$RunningProcesses | Stop-Process -Force
Start-Sleep -Seconds 1
}
Remove-Item -Path $Exe -Force -ErrorAction SilentlyContinue
Write-Success "Removed $Exe"
$Found = $true
} catch {
Write-Warn "Could not remove $Exe"
}
}
}
if ($Found) {
$Removed = Remove-FromUserPath -Directories @($DefaultInstallDir, "$env:LOCALAPPDATA\MovieBox-Tui\bin")
Write-Success "$AppName was successfully uninstalled."
if ($Removed) {
Write-Success "Removed stale entry from User PATH."
}
} else {
Write-Warn "No installed binary of $BinName was found."
}
return
}
if ($Uninstall) {
Do-Uninstall
return
}
Print-Header
$Architecture = if ($env:PROCESSOR_ARCHITEW6432) { $env:PROCESSOR_ARCHITEW6432 } else { $env:PROCESSOR_ARCHITECTURE }
if ($Architecture -eq "ARM64") {
$ArchiveName = "MovieBox_Windows_arm64.zip"
$PlatformName = "Windows (arm64)"
} elseif ($Architecture -eq "AMD64") {
$ArchiveName = "MovieBox_Windows_x64.zip"
$PlatformName = "Windows (x64)"
} else {
Write-Err "Unsupported Windows architecture: $Architecture"
return
}
Write-Step "[1/4] Checking environment & resolving version..."
$TargetVersion = $Version
if (-not $TargetVersion) {
try {
$Request = [System.Net.WebRequest]::Create("https://github.com/$Repo/releases/latest")
$Request.AllowAutoRedirect = $false
$Response = $Request.GetResponse()
$Location = $Response.Headers["Location"]
if ($Location) {
$TargetVersion = $Location.Split("/")[-1].Trim()
}
$Response.Close()
} catch {
try {
$ReleaseJson = Invoke-RestMethod -Uri "https://api.github.com/repos/$Repo/releases/latest" -Headers @{ "User-Agent" = "MovieBox-Installer" } -UseBasicParsing
$TargetVersion = $ReleaseJson.tag_name.Trim()
} catch {
Write-Err "Failed to contact GitHub for latest release. Please check your internet connection."
return
}
}
}
if (-not $TargetVersion) {
Write-Err "Could not resolve latest release version from GitHub."
return
}
Write-Success "[1/4] Environment ready ($PlatformName - $TargetVersion)"
$EffectiveInstallDir = if ($InstallDir) { $InstallDir } else { $DefaultInstallDir }
$ExePath = Join-Path $EffectiveInstallDir $BinName
if (Test-Path $ExePath) {
if (-not $Force) {
$IsInteractive = [Environment]::UserInteractive -and (-not [Console]::IsInputRedirected)
if ($IsInteractive) {
Write-Host ""
Write-Warn "$AppName is already installed at $ExePath"
Write-Host " What would you like to do?"
Write-Host " 1) Reinstall / Update to latest version"
Write-Host " 2) Uninstall"
Write-Host " 3) Cancel"
Write-Host ""
$Choice = Read-Host " Enter choice [1-3] (default 1)"
if ($Choice -eq "2") {
Do-Uninstall
return
} elseif ($Choice -eq "3") {
Write-Success "No changes made. Exiting."
return
}
} else {
try {
$CurrentVerOutput = (& $ExePath --version 2>&1 | Out-String)
if ($CurrentVerOutput -match "moviebox-tui\s+([\d\.]+)") {
$CurrentVer = "v" + $matches[1]
if ($CurrentVer -eq $TargetVersion) {
Write-Success "MovieBox-TUI $TargetVersion is already installed at $ExePath. Use -Force to reinstall."
return
}
}
} catch {}
}
}
}
if ($DryRun) {
Write-Success "[Dry Run] Target package: $ArchiveName"
Write-Success "[Dry Run] Target install directory: $ExePath"
Write-Success "[Dry Run] All preflight checks passed."
return
}
$TempDir = Join-Path ([System.IO.Path]::GetTempPath()) ("moviebox-tui-" + [guid]::NewGuid())
New-Item -ItemType Directory -Force -Path $TempDir | Out-Null
$ZipFile = Join-Path $TempDir $ArchiveName
$ChecksumFile = Join-Path $TempDir "SHA256SUMS"
$BaseUrl = "https://github.com/$Repo/releases/download/$TargetVersion"
$Url = "$BaseUrl/$ArchiveName"
try {
Write-Step "[2/4] Downloading $ArchiveName..."
Invoke-WebRequest -Uri $Url -OutFile $ZipFile -UseBasicParsing
Invoke-WebRequest -Uri "$BaseUrl/SHA256SUMS" -OutFile $ChecksumFile -UseBasicParsing
try { Unblock-File -Path $ZipFile -ErrorAction SilentlyContinue } catch {}
Write-Success "[2/4] Downloaded $ArchiveName"
Write-Step "[3/4] Verifying SHA256 checksum..."
$ChecksumLine = Get-Content $ChecksumFile | Where-Object { $_ -match "\s+$([regex]::Escape($ArchiveName))$" } | Select-Object -First 1
if (-not $ChecksumLine) {
throw "Release checksum is missing for $ArchiveName."
}
$ExpectedHash = ($ChecksumLine -split "\s+")[0].Trim().ToUpper()
$ActualHash = (Get-FileHash -Path $ZipFile -Algorithm SHA256).Hash.Trim().ToUpper()
if ($ActualHash -ne $ExpectedHash) {
throw "Checksum verification failed."
}
Write-Success "[3/4] Cryptographic checksum verified"
Write-Step "[4/4] Installing binary to $EffectiveInstallDir..."
if (-not (Test-Path $EffectiveInstallDir)) {
New-Item -ItemType Directory -Force -Path $EffectiveInstallDir | Out-Null
}
$RunningProcesses = Get-Process -Name "moviebox-tui" -ErrorAction SilentlyContinue
if ($RunningProcesses) {
$RunningProcesses | Stop-Process -Force
Start-Sleep -Seconds 1
}
Expand-Archive -Path $ZipFile -DestinationPath $TempDir -Force
$ExtractedExe = Join-Path $TempDir $BinName
if (-not (Test-Path $ExtractedExe)) {
throw "Binary not found in archive."
}
try { Unblock-File -Path $ExtractedExe -ErrorAction SilentlyContinue } catch {}
Move-Item -Path $ExtractedExe -Destination $ExePath -Force
try { Unblock-File -Path $ExePath -ErrorAction SilentlyContinue } catch {}
try {
$SmokeOutput = (& $ExePath --version 2>&1 | Out-String)
if ($LASTEXITCODE -ne 0) {
Write-Warn "Verification note: $SmokeOutput"
}
} catch {
Write-Warn "Verification note: $_"
}
Write-Success "[4/4] Binary installed to $ExePath"
} catch {
Remove-Item $TempDir -Recurse -Force -ErrorAction SilentlyContinue
Write-Err "Installation failed: $_"
return
} finally {
Remove-Item $TempDir -Recurse -Force -ErrorAction SilentlyContinue
}
$PathModified = $false
if (-not $NoModifyPath) {
if (Add-ToUserPath -Directory $EffectiveInstallDir) {
$PathModified = $true
}
if (@($env:PATH -split ";") -notcontains $EffectiveInstallDir.TrimEnd("\")) {
$env:PATH = "$env:PATH;$EffectiveInstallDir"
}
}
$PlayerDetected = ""
if ((Get-Command "mpv" -ErrorAction SilentlyContinue) -or (Test-Path "C:\Program Files\mpv\mpv.exe") -or (Test-Path "C:\Program Files\MPV Player\mpv.exe") -or (Test-Path "C:\mpv\mpv.exe") -or (Test-Path "$env:LOCALAPPDATA\Programs\mpv\mpv.exe")) {
$PlayerDetected = "mpv"
} elseif ((Get-Command "vlc" -ErrorAction SilentlyContinue) -or (Test-Path "C:\Program Files\VideoLAN\VLC\vlc.exe") -or (Test-Path "C:\Program Files (x86)\VideoLAN\VLC\vlc.exe") -or (Test-Path "$env:LOCALAPPDATA\Programs\VLC\vlc.exe")) {
$PlayerDetected = "VLC"
}
Write-Host ""
Write-Host " + MovieBox-Tui $TargetVersion successfully installed!" -ForegroundColor Green
Write-Host ""
Write-Host " - Binary: " -ForegroundColor DarkGray -NoNewline
Write-Host $ExePath -ForegroundColor White
if ($PlayerDetected) {
Write-Host " - Player: " -ForegroundColor DarkGray -NoNewline
Write-Host "$PlayerDetected (ready)" -ForegroundColor Green
} else {
Write-Host " - Player: " -ForegroundColor DarkGray -NoNewline
Write-Host "None detected (mpv or VLC recommended)" -ForegroundColor Cyan
}
if ($PathModified) {
Write-Host " - Shell: " -ForegroundColor DarkGray -NoNewline
Write-Host "PATH updated in User Environment" -ForegroundColor Magenta
}
Write-Host ""
Write-Host " To start streaming:" -ForegroundColor White
Write-Host " moviebox-tui" -ForegroundColor Green
Write-Host ""
if (-not $PlayerDetected) {
Write-Host " [i] Note: A media player (mpv or VLC) is recommended for video playback.`n" -ForegroundColor Cyan
}
if ($PathModified) {
Write-Host " [i] In existing terminal windows, restart the window or run:" -ForegroundColor Cyan
Write-Host " & `"$ExePath`"`n" -ForegroundColor White
}