🎬 SumanMovies

A blazing-fast, keyboard-driven Terminal UI for streaming and downloading movies, TV series, anime, and 4K UHD releases directly from your command line.

🚀 Quick Start

Run directly with zero installation:

npx sumanmovies

Or install globally to use anywhere:

npm install -g sumanmovies
sumanmovies

✨ Features

• 🍿 Multi-Provider Aggregator: Stream seamlessly from MovieBox, 4KHDHub (2160p UHD HDR/DV), BDIX, and community addons.
• 🖼️ Terminal Artwork Engine: Concurrent asynchronous poster rendering across Kitty, Sixel, and true-color Unicode terminals.
• ⚡ Auto-Configured Media Player: Integrates with mpv player out of the box with audio track selection, subtitles, and hardware acceleration.
• 🕒 Watch History & Resume: Automatically preserves progress so you can jump right back into your movie or show.
• 🎨 Catppuccin Themes: Mocha, Macchiato, Frappé, Latte, TokyoNight, Nord, Dracula, and High-Contrast modes.

🎮 Controls

| Keybinding | Action | | :--- | :--- | | ↑ ↓ ← → / h j k l | Navigate items & grid | | Enter | Select item / Launch playback | | Tab | Switch Tabs (Continue Watching ↔ Favorites) | | Ctrl + P | Switch Provider (MovieBox / 4KHDHub) | | Ctrl + S | Open Settings Hub (Player, Download Path, Theme) | | Ctrl + T | Cycle Visual Theme | | d | Download selected release / episode | | f | Toggle Favorite | | Esc / q | Back / Quit |

🔄 Updating

To check for updates and update SumanMovies, the engine, and all dependencies to the latest release:

sumanmovies --update

Or use the dedicated update command:

sumanmovies-update

Or via npm:

npm update -g sumanmovies

🗑️ Uninstallation

To remove all downloaded SumanMovies binaries and storage:

sumanmovies --uninstall

To also purge all local app data, history, and configs:

sumanmovies --uninstall --purge

To remove the npm package completely:

npm uninstall -g sumanmovies

👤 Author

Suman

• GitHub: @SumanCH8514
• NPM: sumanmovies