Repository files navigation

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.

• Search for anime by name
• Browse episodes
• Support subbed and dubbed content in English and Portuguese
• Skip anime Intro
• Play online with quality selection
• Download single episodes
• Discord RPC about the anime
• Batch download multiple episodes
• Resume playback from where you left off (in builds with SQLite support)
• Track watched episodes (in builds with SQLite support)

Note: GoAnime can be built with or without SQLite support for tracking anime progress.
See the build options documentation for more details.

⚠️ Warning: Portuguese (PT-BR) source availability

If you want to watch anime in Portuguese (PT-BR) and you are outside Brazil, you’ll need a VPN, proxy, or any method to obtain a Brazilian IP address. The PT-BR provider blocks access from IPs outside Brazil.

• Go (at latest version)

• Mpv(at latest version)

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

git clone https://github.com/alvarorichard/GoAnime.git

cd GoAnime

go run cmd/goanime/main.go

yay -S goanime

paru -S goanime

git clone https://aur.archlinux.org/goanime.gitcd goanimemakepkg -sisudo pacman -S mpv

sudo apt updatesudo apt install mpv# For x86_64 systems:curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linuxchmod +x goanimesudo mv goanime /usr/bin/goanime

sudo dnf updatesudo dnf install mpv# For x86_64 systems:curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linuxchmod +x goanimesudo mv goanime /usr/bin/goanime

sudo zypper refreshsudo zypper install mpv# For x86_64 systems:curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linuxchmod +x goanimesudo mv goanime /usr/bin/goanime

# Install Homebrew if you haven't already/bin/bash -c"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# Install mpvbrew install mpv# Download and install GoAnimecurl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-apple-darwinchmod +x goanimesudo mv goanime /usr/local/bin/goanime

# Install mpv using MacPortssudo port install mpv# Download and install GoAnimecurl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-apple-darwinchmod +x goanimesudo mv goanime /usr/local/bin/goanime

nix github:alvarorichard/GoAnime

Add in yourflake.nix:

inputs.goanime.url="github:alvarorichard/GoAnime";

Pass inputs to your modules usingspecialArgs and Then inconfiguration.nix:

environment.systemPackages=[inputs.goanime.packages.${pkgs.system}.GoAnime];

go-anime

goanime

You can also use parameters to search for and play anime directly. Here are some examples:

• To search for and play an anime directly, use the following command:

goanime"anime name"

• To update GoAnime to the latest version, use the update flag:

goanime --update

This command will automatically download and install the latest version of GoAnime using Go's built-in update mechanism.

You can use the-h or--help option to display help information about how to use thegoanime command.

goanime -h

The program will prompt you to input the name of an anime. Enter the name of the anime you wish to watch.

The program will present a list of anime which match your input. Navigate the list using the arrow keys and press enter to select an anime.

The program will then present a list of episodes for the selected anime. Again, navigate the list using the arrow keys and press enter to select an episode.

The selected episode will then play in mpv media player.

@KitsuneSemCalda,@RushikeshGaikwad and@the-eduardo for help and improve this application

If you're looking for more options, check out this alternative project by my friend@KitsuneSemCalda calledAnimatic-v2, which was inspired by GoAnime.

Contributions to improve or enhance are always welcome. Before contributing, please read our comprehensive development guide for detailed information about our workflow, coding standards, and project structure.

📖Development Guide - Essential reading for contributors

Quick Start for Contributors:

1. Fork the Project
2. Read theDevelopment Guide thoroughly
3. Create your Feature Branch fromdev (never frommain)
4. Follow our coding standards (usego fmt, add meaningful comments)
5. Ensure all tests pass and add tests for new features
6. Commit your Changes using conventional commit format
7. Push to the Branch
8. Open a Pull Request to thedev branch

Important: Never commit directly to themain branch. All changes must go through thedev branch first.