๐ŸŽฅ

Chimimouryou

Stream anime from your terminal

GitHubยทbrew install mortezafa/chimi-homebrew-tap/chimi

Overview

Chimimouryou is a CLI tool that lets you search for anime and stream episodes directly in your terminal. Run chimi search, pick a show, choose an episode, and it launches in MPV fullscreen. No browser, no ads, no accounts. About 950 lines of Go.

How It Works

01

Search

Type your query into a centered text input. The TUI sends it to a custom Vercel backend that wraps GoGoAnime.

02

Browse

Results come back as a styled, keyboard-navigable list. Arrow keys to move, enter to select.

03

Pick an Episode

Select a show and get the full episode list. Same keyboard-driven navigation.

04

Stream

The app fetches an M3U8 stream URL, prioritizing 1080p with a 720p fallback, and launches MPV in fullscreen.

Architecture

The app is a state machine with four screens: search, anime list, episode list, and video playback. Each screen is an independent Bubble Tea model following the Elm architecture โ€” Model, Update, View. No callbacks. Everything flows through message passing.

CLI Layer

Cobra parses commands and flags

TUI Layer

Bubble Tea handles state and rendering

API Layer

HTTP client talks to Vercel backend

Tech Stack

Language

Go 1.23

TUI

Bubble Tea + Lipgloss

CLI

Cobra

Streaming

MPV (M3U8)

Backend

Custom Vercel API

Distribution

Homebrew tap

The Terminal UI

The interface is styled with Lipgloss using a red accent theme and rounded borders. It runs in alt-screen mode so your terminal stays clean when you quit. The layout responds to window resizing and everything is keyboard-driven โ€” no mouse needed. Navigation feels like moving through screens on a phone, just with arrow keys and enter.

API Layer

Instead of scraping directly, Chimimouryou talks to a custom Vercel backend that wraps GoGoAnime. Three endpoints handle everything:

/anime/gogoanime/{query}

Search for anime by name

/anime/gogoanime/info/{id}

Get episode list for a show

/anime/gogoanime/watch/{ep}

Get M3U8 stream URLs for an episode