# pystardust/ani-cli

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/pystardust-ani-cli).**

11,408 stars · 690 forks · Shell · gpl-3.0

## Links

- GitHub: https://github.com/pystardust/ani-cli
- awesome-repositories: https://awesome-repositories.com/repository/pystardust-ani-cli.md

## Topics

`anime` `cli` `fzf` `linux` `mac` `posix` `rofi` `shell` `steamdeck` `syncplay` `terminal` `termux` `webscraping` `windows`

## Description

ani-cli is a command line interface designed for searching, streaming, and downloading anime content. It functions as a terminal-based media utility that isolates and retrieves direct video streams from external web sources, allowing users to browse catalogs and play media without a web browser.

The tool distinguishes itself through a modular provider architecture that uses pattern matching to extract metadata and stream links from various sites. It delegates actual video decoding and playback to external system media players, providing users with control over resolution, audio tracks, and player selection.

Beyond basic streaming, the project supports offline media archiving by enabling the download of individual or bulk episodes to local storage. It also includes automated playback features, such as the ability to detect and skip opening theme sequences to maintain continuous viewing.

The software is distributed as a shell-based utility and interacts directly with the host operating system to manage configuration files and download directories.

## Tags

### Graphics & Multimedia

- [Video Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/video-streaming.md) — Enables searching for and streaming anime content directly within a terminal environment. ([source](https://github.com/pystardust/ani-cli#readme))
- [Terminal Media Streamers](https://awesome-repositories.com/f/graphics-multimedia/terminal-media-streamers.md) — Provides a terminal-based interface for searching and streaming anime content from external web sources.
- [Media Players](https://awesome-repositories.com/f/graphics-multimedia/media-players.md) — Delegates video playback to external system media players by passing resolved stream URLs.
- [Media Streaming](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming.md) — Fetches and plays video streams by isolating media data from external web sources. ([source](https://github.com/pystardust/ani-cli/blob/master/disclaimer.md))
- [Video Downloaders](https://awesome-repositories.com/f/graphics-multimedia/video-downloaders.md) — Downloads individual or bulk anime episodes to local storage for offline viewing. ([source](https://github.com/pystardust/ani-cli#readme))
- [Media Content Archivers](https://awesome-repositories.com/f/graphics-multimedia/media-production-suites/media-management-production/media-archiving/media-content-archivers.md) — Supports offline media archiving by downloading episodes to local storage.
- [Stream Extractors](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/video-streaming/stream-extractors.md) — Isolates and retrieves direct video stream links from web pages to enable playback in external media players.

### User Interface & Experience

- [Terminal User Interfaces](https://awesome-repositories.com/f/user-interface-experience/terminal-user-interfaces.md) — Provides an interactive terminal-based interface for browsing and managing media content.
- [Playback Automation](https://awesome-repositories.com/f/user-interface-experience/playback-controllers/playback-automation.md) — Enhances viewing by automating playback sequences like skipping intros and configuring resolution.
- [Playback Preferences](https://awesome-repositories.com/f/user-interface-experience/user-preference-settings/playback-preferences.md) — Configures video resolution, audio tracks, and player selection for personalized viewing. ([source](https://github.com/pystardust/ani-cli#readme))

### Operating Systems & Systems Programming

- [Media Streaming Clients](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/media-streaming-clients.md) — Enables searching, streaming, and downloading anime content directly from the command line.

### Networking & Communication

- [Media Stream Parsers](https://awesome-repositories.com/f/networking-communication/media-stream-parsers.md) — Isolates and retrieves direct video links from remote web pages for browser-less playback.

### Business & Productivity Software

- [Media Downloaders](https://awesome-repositories.com/f/business-productivity-software/media-downloaders.md) — Saves video files to local storage with support for custom output directories. ([source](https://github.com/pystardust/ani-cli/blob/master/README.md))

### Development Tools & Productivity

- [Remote Media Catalog Searchers](https://awesome-repositories.com/f/development-tools-productivity/integration-metadata-retrievers/media-metadata-retrievers/remote-media-catalog-searchers.md) — Queries external media catalogs using keywords to retrieve lists of available titles. ([source](https://github.com/pystardust/ani-cli/blob/master/hacking.md))
- [Playback Sequence Automators](https://awesome-repositories.com/f/development-tools-productivity/open-source-software/open-source-media-players/playback-sequence-automators.md) — Automatically detects and skips opening theme sequences during video playback. ([source](https://github.com/pystardust/ani-cli#readme))

### Web Development

- [Regex Extractors](https://awesome-repositories.com/f/web-development/web-automation-scraping/web-scraping-automation/web-scraping/regex-extractors.md) — Extracts media metadata and stream URLs from raw HTML using pattern-based matching.

### Software Engineering & Architecture

- [Modular Extension Architectures](https://awesome-repositories.com/f/software-engineering-architecture/modular-extension-architectures.md) — Uses a modular provider architecture to separate site-specific extraction logic into independent, maintainable scripts.
