🎬 SageMovies TUI (sagemovies-tui)

A modern Rust-based terminal user interface (TUI) for SageMovies. Fast, lightweight, keyboard-first, and cross-platform. Stream movies, TV series, anime, and 24/7 live TV directly from your terminal into your favorite media player.

---

⚡ Quick Installation

The easiest way to install and run SageMovies TUI is using the quick install command below:

🍎 macOS & 🐧 Linux

curl -fsSL https://raw.githubusercontent.com/phcodesage/sagemovies-tui/main/install.sh | bash

🪟 Windows (PowerShell)

powershell -c "irm https://raw.githubusercontent.com/phcodesage/sagemovies-tui/main/install.ps1 | iex"

---

📦 Install via Cargo

If you already have Rust & Cargo installed:

cargo install --git https://github.com/phcodesage/sagemovies-tui.git

Or build from source locally:

git clone git@github.com:phcodesage/sagemovies-tui.git
cd sagemovies-tui
cargo build --release

---

🚀 Features

• 🎬 Movies & 📺 TV Series:
  • Discover trending, popular, and top-rated movies & shows.
  • Drill down into TV series with Season and Episode selectors.
• 🐉 Anime Catalog:
  • Browse animation series and movies powered by TMDB.
• 📡 24/7 Live TV Channels:
  • Stream free live television streams (NASA TV, Bloomberg, France 24, DW News, Red Bull TV, Sky News, EuroNews, CNA, Al Jazeera).
• 🔍 Instant Search & Side Preview:
  • Press / or s anytime for live instant search with rich side preview metadata (IMDb/TMDB rating, release year, overview).
• 🎥 Media Player Support:
  • Automatically launches streams in VLC (vlc), MPV (mpv), FFplay (ffplay), or your default browser.
• 🌐 Multi-Server Embed Sources:
  • Pick stream sources on the fly (Videasy, 2Embed, Vidsrc.me, SuperEmbed).
• ⭐ Watchlist & History:
  • Press f to favorite titles. Config & history are stored in ~/.config/sagemovies/config.json.

---

⌨️ Controls & Keybindings

Key	Action
Tab / Shift+Tab	Switch category tabs (Movies, TV Series, Anime, Live TV, Watchlist)
↑ / ↓ or k / j	Navigate items in catalog or lists
/ or s	Open Instant Search input
Enter	View item details, seasons, and episodes
p	Quick Play / Select Stream Server
f	Toggle title in Watchlist ⭐
m	Cycle default player (VLC, MPV, FFplay, Browser)
r	Refresh catalog
?	Toggle Keybindings Help modal
Esc	Close modal / clear search
q or Ctrl+C	Quit app

---

🖥️ Command Line Flags

# Launch interactive TUI
sagemovies-tui

# Search directly from terminal launch
sagemovies-tui --query "Inception"

# Open specific category
sagemovies-tui --category anime

# Specify preferred player
sagemovies-tui --player vlc

---

📄 License

Distributed under the MIT License. Created by Rechcel Toledo (rechceltoledo@gmail.com).