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.

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

• 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

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

• mpv (Media player, latest version recommended)

Choose the installation method that best fits your system.

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

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

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

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

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.

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 Enter to pick an anime.
5. Watch: Select an episode, choose your preferred streaming quality, and the video will automatically launch in mpv.

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

goanime "Naruto"

Keep GoAnime updated to the newest features without manual downloads:

goanime --update

To view all available commands and flags:

goanime -h

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.

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

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.

All changes must go through the dev branch first.