pokeflix-cli

Watch pokeflix.tv in your terminal. Plays in VLC.

Search or browse Pokémon series, movies, and specials. Pick an episode. It plays. Log in to sync your watch history. Inspired by ani-cli.

Requirements

• VLC - plays the video
• ffmpeg - only for --download
• Go 1.23+ - only to build

Install

Install guides (click to expand)

Each guide installs pokeflix to a directory already on your PATH, so you can run pokeflix from any terminal, anywhere. Needs Go 1.23+ to build.

Linux

# 1. dependencies (Arch Linux)
sudo pacman -S go git vlc ffmpeg

# 2. build and install to /usr/local/bin (on PATH by default)
git clone https://github.com/GitJamieK/pokeflix-cli.git
cd pokeflix-cli
go build -o pokeflix ./cmd/pokeflix
sudo install -m755 pokeflix /usr/local/bin/pokeflix

Now run pokeflix from anywhere.

macOS

# 1. dependencies (needs Homebrew: https://brew.sh)
brew install go git
brew install --cask vlc
brew install ffmpeg

# 2. build and install to /usr/local/bin (on PATH by default)
git clone https://github.com/GitJamieK/pokeflix-cli.git
cd pokeflix-cli
go build -o pokeflix ./cmd/pokeflix
sudo install -m755 pokeflix /usr/local/bin/pokeflix

Now run pokeflix from anywhere.

Windows

Install Go, Git, and VLC (plus ffmpeg for --download) first. Then in PowerShell:

# 1. build
git clone https://github.com/GitJamieK/pokeflix-cli.git
cd pokeflix-cli
go build -o pokeflix.exe ./cmd/pokeflix

# 2. install to %USERPROFILE%\bin and add it to your PATH
$dest = "$env:USERPROFILE\bin"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item pokeflix.exe $dest -Force
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ($userPath -notlike "*$dest*") {
    [Environment]::SetEnvironmentVariable("Path", "$userPath;$dest", "User")
}

Open a new terminal, then run pokeflix from anywhere.

Commands

Show commands (click to expand)

Run pokeflix alone for the menu. Or run a command directly.

Command	What it does
pokeflix	Open the menu. It loops until you quit.
pokeflix search <query>	Search, then play.
pokeflix browse	Choose Series / Movies / Specials / Upcoming, then browse it.
pokeflix continue	Open the action menu for the next unwatched episode.
pokeflix history	Pick a series (opens its grid) or Movies you've watched.
pokeflix login	Log in to your account.
pokeflix logout	Forget the saved session.

Flags

Flag	Does
--audio <lang>	Pick audio language (en, fr, de, …). Asks if there are several.
--download	Save an .mp4 into Downloads/ instead of streaming.
--no-fzf	Use numbered prompts instead of the menu.

With --no-fzf: type a number to pick, q to quit.

Examples

pokeflix search mewtwo              # find and watch
pokeflix browse                     # series -> episode grid
pokeflix continue --audio en        # resume in English
pokeflix search pikachu --download  # save instead of stream

Keys

Key	Does
↑ ↓	Move.
type	Filter the list.
Enter	Pick.
Esc	Go back.
Ctrl-X	Quit.

Episode grid

Get past 80% and an episode counts as watched.

Logged in, your account keeps track and syncs back to pokeflix.tv. Logged out, it's all saved locally.

Your data

• ~/.config/pokeflix-cli/session.json - session cookie. Never your password.
• ~/.local/share/pokeflix-cli/history.json - local watch history.