🐱 MeowTV CLI - The Purr-fect Streamer

Stream movies, TV shows, and cartoons directly from your terminal.
Fast, lightweight, and absolutely paw-some.

MeowTV CLI is a feature-rich terminal application for streaming content. Built with speed in mind, it leverages parallel fetching, HLS proxying, and intelligent variant filtering to give you a buffer-free experience.

🔥 Key Features

• 🌍 Universal Search: Search across multiple high-quality providers simultaneously.
• 🚀 Turbo Startup: Parallelized metadata fetching and subtitle downloads for instant launch.
• 🎬 High Quality: Support for 1080p+, Multi-audio, and Dual-audio streams.
• 🛡️ Smart Proxy: Built-in Flask HLS proxy with Variant Filtering to prevent connection starvation.
• 💬 Subtitles Support: Multi-language support with automatic local downloading for player compatibility.
• 📥 Integrated Downloads: Save your favorite content for offline viewing.
• ⭐ Watchlist: Manage your personal library with local favorites.

🌌 Providers

📦 Installation

pip install -U meowtv

🛠️ Dependencies

• mpv (Highly recommended) or VLC.
• FFmpeg (Required for HLS downloads).

Windows (via Scoop)

# Install Scoop (if not already installed)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

# Install dependencies
scoop install mpv ffmpeg

macOS (via Homebrew)

# Install Homebrew (if not already installed)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install dependencies
brew install mpv ffmpeg

Linux (via Package Manager)

Ubuntu/Debian:

sudo apt update && sudo apt install mpv ffmpeg

Arch Linux:

sudo pacman -S mpv ffmpeg

🚀 Quick Start

Start the interactive terminal UI:

meowtv

⌨️ CLI Commands

Search & Play:

meowtv search "interstellar"
meowtv search "one piece" -p meowtoon

Direct Play:

meowtv play <content_id> --player vlc

Downloads:

meowtv download <content_id> -o ~/Videos

🏎️ Performance & Stability (v1.2.1)

We've recently overhauled the engine for maximum reliability:

• Intelligent Proxy Fallback: Automatically detects worker failures and switches to direct connections for zero downtime.
• Parallel Fetching: Fetches all seasons/episodes simultaneously using asyncio.gather.
• HLS Variant Filtering: Limits stream probing to the top 3 qualities to prevent long initial lags.
• Aggressive Buffering: Optimized MPV arguments for near-instant playback.

⚙️ Configuration

Configuration is stored in ~/.config/meowtv/config.json.

meowtv config --show
meowtv config --player mpv

⚖️ Disclaimer & License

Disclaimer: This tool is for educational purposes only. The developers do not host any content. All content is scraped from third-party publicly available sources.

Licensed under the MIT License.

Made with ❤️ by the MeowTV Community