8000 GitHub - alvarorichard/GoAnime: A CLI tool to browse, play, and download anime in pt-br (Portuguese)
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

alvarorichard/GoAnime

Repository files navigation

English | Рortuguês

Imagem logo

GitHub license GitHub stars GitHub stars GitHub stars Build Status GitHub contributors Codacy Badge Build Status

GoAnime

GoAnime is a simple command-line interface (CLI) 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 to the user, with a special focus and objective on offering animes that are both subtitled and dubbed in Portuguese.

Features

  • Search for anime by name
  • Browse episodes
  • 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.

Demo

goanime.mp4

Prerequisites

  • Go (at latest version)

  • Mpv(at latest version)

how to install and run

Universal install (Only needs go installed and recommended for most users)

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

Manual install methods

git clone https://github.com/alvarorichard/GoAnime.git
cd GoAnime
go run cmd/goanime/main.go

Linux

Arch Linux / Manjaro (AUR-based systems)

Using Yay:

yay -S goanime

or using Paru:

paru -S goanime

Or, to manually clone and install:

git clone https://aur.archlinux.org/goanime.git
cd goanime
makepkg -si
sudo pacman -S mpv
Debian / Ubuntu (and derivatives)
sudo apt update
sudo apt install mpv

# For x86_64 systems:
curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linux

chmod +x goanime
sudo mv goanime /usr/bin/
goanime
Fedora Installation
sudo dnf update
sudo dnf install mpv

# For x86_64 systems:
curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linux

chmod +x goanime
sudo mv goanime /usr/bin/
goanime
openSUSE Installation
sudo zypper refresh
sudo zypper install mpv

# For x86_64 systems:
curl -Lo goanime https://github.com/alvarorichard/GoAnime/releases/latest/download/goanime-linux

chmod +x goanime
sudo mv goanime /usr/bin/
goanime

Windows

Windows Installation

Strongly Recommended: Use the installer for the best experience on Windows.

Option 1: Using the installer (Recommended)

Option 2: Standalone executable

  • Download the appropriate executable for your system from the latest release

Additional Setup Steps

NixOS install (Flakes)

Temporary Run

nix github:alvarorichard/GoAnime

Install

Add in your flake.nix:

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

Pass inputs to your modules using specialArgs and Then in configuration.nix:

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

Usage in Linux and macOS

go-anime

Usage in Windows

goanime

Advanced Usage

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"

You can use the -h or --help option to display help information about how to use the goanime 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.

Thanks

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

Alternatives

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

Contributing

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 the Development Guide thoroughly
  3. Create your Feature Branch from dev (never from main)
  4. Follow our coding standards (use go 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 the dev branch

Important: Never commit directly to the main branch. All changes must go through the dev branch first.

0