Awesome
<h4 align="center"> <p> <b>English</b> | <a href="https://github.com/alvarorichard/GoAnime/blob/main/README_pt-br.md">Рortuguês</a> </p> </h4> <p align="center"> <img src="https://github.com/alvarorichard/GoAnime/assets/102667323/49600255-d5a2-4405-81d1-a08cebae569a" alt="Imagem logo" /> </p>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.
Demo
https://github.com/alvarorichard/GoAnime/assets/88117897/ffec6ad7-6ac1-464d-b048-c80082119836
Prerequisites
-
Go (at latest version)
-
Mpv(at latest version)
-
yt-dlp(at latest version)
Dependencies
- PuerkitoBio/goquery
- manifoldco/promptui
- cavaliergopher/grab/v3
- ktr0731/go-fuzzyfinder
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
sudo bash install.sh
Arch Linux Install (AUR)
For Arch Linux users, GoAnime is available in the AUR. You can install it using an AUR helper like paru
or yay
:
Using paru
:
paru -S goanime
Using yay
:
yay -S goanime
Windows install only
To install GoAnime on Windows using the install.ps1
PowerShell script, follow these steps:
-
Open PowerShell as Administrator
-
Enable PowerShell Script Execution (if not already enabled):
In the PowerShell window, execute the following command to allow the execution of scripts:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
3.Run the Install Script:
Execute the install.ps1
script:
.\install.ps1
Additional Recommendations for Users
For a smoother setup experience, it's recommended to install mpv
and yt-dlp
using Scoop as it automatically adds them to your system's PATH. Follow these steps to install these tools:
- Install Scoop (if not installed):
Open PowerShell and execute:
iwr -useb get.scoop.sh | iex
- Install
mpv
andyt-dlp
using Scoop:
scoop install mpv yt-dlp
This method ensures that mpv and yt-dlp are added to your PATH automatically, eliminating the need for manual configuration.
Rember add mpv to path
use this command to add mpv to path
set PATH=%PATH%;C:\Program Files\mpv
or follow this tutorial for add mpv to path
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 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. Please adhere to the standard pull request process for contributions.
- Fork the Project
- Create your Feature Branch
- Commit your Changes
- Push to the Branch
- Open a Pull Request.