Skip to main content

CLI for streaming content from MeowTV providers

Project description

🐱 MeowTV CLI - The Purr-fect Streamer


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


PyPI version License: MIT Python: 3.8+

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

Provider Content Type Speciality
MeowVerse Movies & TV Global content, multi-audio, high speed
MeowTV Movies & TV Premium Asian & Global library
MeowToon Anime & Kids Extensive cartoon & anime collection

📦 Installation

pip install -U meowtv

🛠️ Dependencies

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

🚀 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 Optimizations (v1.0.8+)

We've recently overhauled the engine for maximum speed:

  • Parallel Fetching: Fetches all seasons/episodes simultaneously using asyncio.gather.
  • HLS Variant Filtering: Limits stream probing to the top 3 qualities to prevent "14-minute" initial lags.
  • Aggressive Buffering: Optimized MPV arguments (--cache-secs=2) 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

meowtv-1.0.8.tar.gz (36.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

meowtv-1.0.8-py3-none-any.whl (43.5 kB view details)

Uploaded Python 3

File details

Details for the file meowtv-1.0.8.tar.gz.

File metadata

  • Download URL: meowtv-1.0.8.tar.gz
  • Upload date:
  • Size: 36.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for meowtv-1.0.8.tar.gz
Algorithm Hash digest
SHA256 fe16b4482323d9cbe33ecfbaa5337be163dfc7464e9880de6071ae8b60fa82fe
MD5 71fec2595e10424d13c1a79889a2aa1e
BLAKE2b-256 6641ba6e1f1677996689a18e46b40cdb7700d75a4f3ec6b503c153655614143b

See more details on using hashes here.

File details

Details for the file meowtv-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: meowtv-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 43.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for meowtv-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 8db27f06e1935ca80b6d73d6180f9f2bd9ac0040eaa1b7c3b5da1664cadd2114
MD5 ed72d587f6f3d88cc33058ea9dc962e2
BLAKE2b-256 8cd819679309fe14316810685e53842769ffb71823f71af60f8e1a834d1f799d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page