English | Рortuguês

GoAnime

GoAnime is a simple text-based user interface (TUI) built in Go, allowing users to search for anime and either play or download episodes directly in mpv. It scrapes data from websites to provide a selection of anime and episodes, with support for both subbed and dubbed content in English and Portuguese.

Table of contents

1. Features
2. Prerequisites
3. Installation
4. How to use
5. Advanced usage
6. Troubleshooting
7. Community and mobile
8. Contributing

Features

• Search for anime, movies, and TV shows by name
• Simultaneous multi-source searching by default across all active platforms
• Support for subbed and dubbed content in English and Portuguese
• Play online with quality selection or download episodes
• Discord RPC integration to show what you're watching
• Progress tracking: Resume playback and track watched episodes

• Built-in upscaling (Anime4K) for better video quality

Prerequisites

Before installing GoAnime, ensure you have the following dependency installed:

• mpv (Media player, latest version recommended)

Installation

Choose the installation method that best fits your system.

Universal installation

If you have Go installed on your system, you can install GoAnime via go install:

go install github.com/alvarorichard/Goanime/cmd/goanime@latest

macOS

Install mpv using Homebrew, then download and configure GoAnime:

brew install mpv
curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-apple-darwin
chmod +x goanime
sudo mv goanime /usr/local/bin/
sudo xattr -d com.apple.quarantine /usr/local/bin/goanime

Linux

sudo apt update
sudo apt install mpv -y
curl -LO https://github.com/alvarorichard/Goanime/releases/latest/download/goanime-linux-amd64.tar.gz
tar -xzf goanime-linux-amd64.tar.gz
chmod +x goanime-linux-amd64
sudo mv goanime-linux-amd64 /usr/local/bin/goanime

yay -S goanime

sudo dnf update
sudo dnf install mpv
curl -LO https://github.com/alvarorichard/Goanime/releases/latest/download/goanime-linux-amd64.tar.gz
tar -xzf goanime-linux-amd64.tar.gz
chmod +x goanime-linux-amd64
sudo mv goanime-linux-amd64 /usr/local/bin/goanime

Windows

Strongly Recommended: Use our installer for the best experience.

1. Download and run the GoAnime Windows Installer.
2. Install mpv for Windows and ensure it is available in your system's path.

How to use

Follow these steps for a simple, interactive watching experience:

1. Open your terminal.
2. Start the app: Type goanime and press Enter.
3. Search: Provide the name of the anime you want to watch.
4. Select: Navigate the resulting list using your arrow keys and press

1. Watch: Select an episode, choose your preferred streaming quality, and

Advanced usage

Direct search

To bypass the initial prompt, directly pass the anime name:

goanime "Naruto"

Updating the app

Keep GoAnime updated to the newest features without manual downloads:

goanime --update

Help

To view all available commands and flags:

goanime -h

Troubleshooting

TLS errors behind a corporate proxy or custom CA

If every request fails with a certificate error — typically on a network that inspects TLS with its own root CA — point GoAnime at that CA bundle:

export SSL_CERT_FILE=/path/to/corporate-ca.pem   # a single PEM bundle
export SSL_CERT_DIR=/path/to/ca-certificates.d   # or a directory of PEMs

Since Go 1.27 these variables are honoured on Windows and macOS as well, not just Linux: when either is set, GoAnime verifies certificates with Go's own verifier against your bundle instead of the platform certificate store. To go back to the platform store without unsetting the variables, run with GODEBUG=x509sslcertoverrideplatform=0.

Community and mobile

Join our Discord for support, feedback, and updates: Join the Discord server

A mobile version of GoAnime is also available for Android devices: GoAnime Mobile

Contributing

Contributions to improve or enhance are always welcome.

See the development guide.

Quick start:

1. Fork the project and read the development guide.
2. Create your feature branch from dev (git checkout -b feature/foo).
3. Follow formatting standards (go fmt).
4. Commit your changes (git commit -m 'feat: add foo').
5. Push to the branch (git push origin feature/foo).
6. Open a pull request to the dev branch.