Home

Awesome

<p align="center"> <h1 align="center">FastAnime</h1> </p> <p align="center"> <sup> Browse anime from the terminal </sup> </p> <div align="center">

PyPI - Downloads GitHub Actions Workflow Status Discord GitHub Issues or Pull Requests GitHub deployments PyPI - License Static Badge

</div> <p align="center"> <a href="https://discord.gg/HBEmAwvbHV"> <img src="https://invidget.switchblade.xyz/C4rhMA4mmK"> </a> </p>

fastanime

<details> <summary> <b>My Rice</b> </summary>

Anilist results menu: image

Episodes menu preview: image

Without preview images enabled: image

Desktop notifications + episodes menu without image preview: image

</details> <details> <summary><b>fzf mode</b></summary>

fastanime-fzf.webm

</details> <details> <summary><b>rofi mode</b></summary>

fa_rofi_mode.webm

</details> <details> <summary><b>Default mode</b></summary>

fa_default_mode.webm

</details> <!--toc:start-->

Installation

Windows Linux/BSD Arch Linux MacOS Android

The app can run wherever python can run. So all you need to have is python installed on your device. On android you can use termux. If you have any difficulty consult for help on the discord channel

Installation on nixos

Static Badge

nix profile install github:Benexl/fastanime

Installation using your favourite package manager

Currently the app is only published on pypi. With the following extras available:

Using uv

Recommended method of installation is using uv.

# generally:
uv tool install "fastanime[standard]"

# or stripped down installations:
uv tool install fastanime
uv tool install "fastanime[api]"
uv tool install "fastanime[mpv]"
uv tool install "fastanime[notifications]"

Using pipx


pipx install fastanime
# -- or for the development version --
pipx install 'fastanime==<latest-pre-release-tag>.dev1'
# example
# pipx install 'fastanime==0.60.1.dev1'

Using pip

pip install fastanime
# -- or for the development version --
pip install 'fastanime==<latest-pre-release-tag>.dev1'
# example
# pip install 'fastanime==0.60.1.dev1'

Installing the bleeding edge version

To install the latest build which are created on every push by GitHub actions, download the fastanime_debug_build of your choosing from the GitHub actions page. Then:

unzip fastanime_debug_build

# outputs fastanime<version>.tar.gz

pipx install fastanime<version>.tar.gz

# --- or ---

pip install fastanime<version>.tar.gz

Building from the source

Requirements:

To build from the source, follow these steps:

  1. Clone the repository: git clone https://github.com/Benexl/FastAnime.git --depth 1
  2. Navigate into the folder: cd FastAnime
  3. Then build and Install the app:
# build and install fastanime with uv
uv tool install .
  1. Enjoy! Verify installation with:
fastanime --version

[!Tip]

Download the completions from here for your shell. To add completions:

External Dependencies

The only required external dependency, unless you won't be streaming, is MPV, which i recommend installing with uosc :fire: and thumbfast for the best experience since they add a better interface to it.

[!NOTE]

The project currently sees no reason to support any other video player because we believe nothing beats MPV and it provides everything you could ever need with a small footprint. But if you have a reason feel free to encourage as to do so. However, on android this is not the case so vlc is also supported

Other external dependencies that will just make your experience better:

Usage

The project offers a featureful command-line interface and MPV interface through the use of python-mpv. The project also offers subs in different languages thanks to hianime provider.

The Commandline interface :fire:

Designed for efficiency and automation. Plus has a beautiful pseudo-TUI in some of the commands. If you are stuck anywhere just use --help before the command you would like to get help on

Overview of main commands:

Overview of options

Most options are directly passed into fastanime directly and are shared by multiple subcommands.

Most of the options override your config file.

This is a convention to make the dev time faster since it reduces redundancy and also makes switching of subcommands with the same options easier to the end user.

In general fastanime --<option-name>

Available options for the fastanime include:

Example usage of the above options

# example of syncplay intergration
fastanime --sync-play --server sharepoint search -t <anime-title>

# --- or ---

# to watch with anilist intergration
fastanime --sync-play --server sharepoint anilist

# downloading dubbed anime
fastanime --dub download -t <anime>

# use  icons and fzf for a more elegant ui with preview
fastanime --icons --preview --fzf anilist

# use icons with default ui
fastanime --icons --default anilist

# viewing manga
fastanime --manga search -t <manga-title>

The anilist command :fire: :fire: :fire:

Uses the AniList API to create a terminal anilist client which is then intergrated with the scraping capabilities of the project.

Running without any subcommand

Run fastanime anilist to access the main interface.

Subcommands

The subcommands are mainly their as convenience. Since all the features already exist in the main interface. Most of the subcommands share the common option --dump-json or -d which will print only the json data and suppress the ui.

FastAnime Anilist Search subcommand 🔥 🔥 🔥

It is by far one of the most powerful commands. It offers the following options:

Example:

# get anime with the tag of isekai
fastanime anilist search -T isekai

# get anime of 2024 and sort by popularity
# that has already finished airing or is releasing
# and is not in your anime lists
fastanime anilist search -y 2024 -s POPULARITY_DESC --status RELEASING --status FINISHED --not-on-list

# get anime of 2024 season WINTER
fastanime anilist search -y 2024 --season WINTER

# get anime genre action and tag isekai,magic
 fastanime anilist search -g Action -T Isekai -T Magic

# get anime of 2024 thats finished airing
fastanime anilist search -y 2024 -S FINISHED

# get the most favourite anime movies
fastanime anilist search -f MOVIE -s FAVOURITES_DESC

For more details visit the anilist docs or just get the completions which will improve the experience.

Like seriously get the completions and the experience will be a 💯 💯 better.

Fastanime anilist download: Supports all the options for search except its used for downloading. it also supports all options for fastanime download Example:

# get anime with the tag of isekai
fastanime anilist download -T isekai

# get anime of 2024 and sort by popularity
# that has already finished airing or is releasing
# and is not in your anime lists
fastanime anilist download -y 2024 -s POPULARITY_DESC --status RELEASING --status FINISHED --not-on-list

# get anime of 2024 season WINTER
fastanime anilist download -y 2024 --season WINTER

# get anime genre action and tag isekai,magic
 fastanime anilist download -g Action -T Isekai -T Magic

# get anime of 2024 thats finished airing
fastanime anilist download -y 2024 -S FINISHED

# get the most favourite anime movies
fastanime anilist download -f MOVIE -s FAVOURITES_DESC

The following are commands you can only run if you are signed in to your AniList account:

Plus: fastanime anilist notifier 🔥

# basic form
fastanime anilist notifier

# with logging to stdout
fastanime --log anilist notifier

# with logging to a file. stored in the same place as your config
fastanime --log-file anilist notifier

The above commands will start a loop that checks every 2 minutes if any of the anime in your watch list that are airing has just released a new episode.

The notification will consist of a cover image of the anime in none windows systems.

You can place the command among your machines startup scripts.

For fish users for example you can decide to put this in your ~/.config/fish/config.fish:

if ! ps aux | grep -q '[f]astanime .* notifier'
  echo initializing fastanime anilist notifier
  nohup fastanime --log-file anilist notifier>/dev/null &
end

[!NOTE] To sign in just run fastanime anilist login and follow the instructions. To view your login status fastanime anilist login --status To erase login data fastanime anilist login --erase

download subcommand

Download anime to watch later dub or sub with this one command. Its optimized for scripting due to fuzzy matching; basically you don't have to manually select search results.

So every step of the way has been and can be automated. Uses a list slicing syntax similar to that of python as the value for the -r option.

[!NOTE]

The download feature is powered by yt-dlp so all the bells and whistles that it provides are readily available in the project. Like continuing from where you left of while downloading, after lets say you lost your internet connection.

Syntax:

# Download all available episodes
# multiple titles can be specified with -t option
fastanime download -t <anime-title> -t <anime-title>
# -- or --
fastanime download -t <anime-title> -t <anime-title> -r ':'

# download latest episode for the two anime titles
# the number can be any no of latest episodes but a minus sign
# must be present
fastanime download -t <anime-title> -t <anime-title> -r '-1'

# latest 5
fastanime download -t <anime-title> -t <anime-title> -r '-5'

# Download specific episode range
# be sure to observe the range Syntax
fastanime download -t <anime-title> -r '<episodes-start>:<episodes-end>:<step>'

fastanime download -t <anime-title> -r '<episodes-start>:<episodes-end>'

fastanime download -t <anime-title> -r '<episodes-start>:'

fastanime download -t <anime-title> -r ':<episodes-end>'

# download specific episode
# remember python indexing starts at 0
fastanime download -t <anime-title> -r '<episode-1>:<episode>'

# merge subtitles with ffmpeg to mkv format; hianime tends to give subs as separate files
# and dont prompt for anything
# eg existing file in destination instead remove
# and clean
# ie remove original files (sub file and vid file)
# only keep merged files
fastanime download -t <anime-title> --merge --clean --no-prompt

# EOF is used since -t always expects a title
# you can supply anime titles from file or -t at the same time
#
# from stdin
echo -e "<anime-title>\n<anime-title>\n<anime-title>" | fastanime download -t "EOF" -r <range> -f -

# from file
fastanime download -t "EOF" -r <range> -f <file-path>

search subcommand

Powerful command mainly aimed at binging anime. Since it doesn't require interaction with the interfaces.

Uses a list slicing syntax similar to that of python as the value of the -r option.

Syntax:

# basic form where you will still be prompted for the episode number
# multiple titles can be specified with the -t option
fastanime search -t <anime-title> -t <anime-title>

# binge all episodes with this command
fastanime search -t <anime-title> -r ':'

# watch latest episode
fastanime search -t <anime-title> -r '-1'

# binge a specific episode range with this command
# be sure to observe the range Syntax
fastanime search -t <anime-title> -r '<start>:<stop>'

fastanime search -t <anime-title> -r '<start>:<stop>:<step>'

fastanime search -t <anime-title> -r '<start>:'

fastanime search -t <anime-title> -r ':<end>'

grab subcommand

Helper command to print streams to stdout so it can be used by non-python applications.

The format of the printed out data is json and can be either an array or object depending on how many anime titles have been specified in the command-line or through a subprocess.

[!TIP] For python applications just use its python api, for even greater and easier control. So just add fastanime as one of your dependencies.

Uses a list slicing syntax similar to that of python as the value of the -r option.

Syntax:

# --- print anime info + episode streams ---

# multiple titles can be specified with the -t option
fastanime grab -t <anime-title> -t <anime-title>

# -- or --

# print all available episodes
fastanime grab -t <anime-title> -r ':'

# print the latest episode
fastanime grab -t <anime-title> -r '-1'

# print a specific episode range
# be sure to observe the range Syntax
fastanime grab -t <anime-title> -r '<start>:<stop>'

fastanime grab -t <anime-title> -r '<start>:<stop>:<step>'

fastanime grab -t <anime-title> -r '<start>:'

fastanime grab -t <anime-title> -r ':<end>'

# --- grab options ---

# print search results only
fastanime grab -t <anime-title> -r <range> --search-results-only

# print anime info only
fastanime grab -t <anime-title> -r <range> --anime-info-only

# print episode streams only
fastanime grab -t <anime-title> -r <range> --episode-streams-only

downloads subcommand

View and stream the anime you downloaded using MPV.

Syntax:

fastanime downloads

# view individual episodes
fastanime downloads --view-episodes
# --- or ---
fastanime downloads -v

# to set seek time when using ffmpegthumbnailer for local previews
# -1 means random and is the default
fastanime downloads --time-to-seek <intRange(-1,100)>
# --- or ---
fastanime downloads -t <intRange(-1,100)>

# to watch a specific title
# be sure to get the completions for the best experience
fastanime downloads --title <title>

# to get the path to the downloads folder set
fastanime downloads --path
# useful when you want to use the value for other programs

config subcommand

Edit FastAnime configuration settings using your preferred editor (based on $EDITOR environment variable so be sure to set it).

Syntax:

fastanime config

# to get config path which is useful if you want to use it for another program.
fastanime config --path

# add a desktop entry
fastanime config --desktop-entry

# view current contents of your configuration or can be used to get an example config
fastanime config --view

[!Note]

If it opens vim you can exit by typing :q 😉.

cache subcommand

Easily manage the data fastanime has cached; for the previews.

Syntax:

# delete everything in the cache dir
fastanime cache --clean

# print the path to the cache dir and exit
fastanime cache --path

# print the current size of the cache dir and exit
fastanime cache --size

# open the cache dir and exit
fastanime cache

update subcommand

Easily update fastanime to latest

Syntax:

# update fastanime to latest
fastanime update

# check for latest release
fastanime update --check

completions subcommand

Helper command to setup shell completions

Syntax:

# try to detect your shell and print completions
fastanime completions
# print fish completions
fastanime completions --fish
# print bash completions
fastanime completions --bash
# print zsh completions
fastanime completions --zsh

fastanime serve

Helper command that starts a rest server. This requires you to install fastanime with the api extra or standard extra.

# default options
fastanime serve

# specify host and port
fastanime serve --host <host> --port <port>

MPV specific commands

The project now allows on the fly media controls directly from mpv. This means you can go to the next or previous episode without the window ever closing thus offering a seamless experience. This is all powered with python-mpv which enables writing mpv scripts with python just like how it would be done in lua.

Key Bindings

<shift>+n fetch the next episode

<shift>+p fetch the previous episode

<shift>+t toggle the translation type from dub to sub

<shift>+a toggle auto next episode

<shit>+r reload episode

Script Messages

Commands issued in the MPV console.

Examples:

# to select episode from mpv without window closing
script-message select-episode <episode-number>

# to select server from mpv without window closing
script-message select-server <server-name>

# to select quality
script-message select-quality <1080/720/480/360>

styling the default interface

The default interface uses inquirerPy which is customizable. Read here to findout more https://inquirerpy.readthedocs.io/en/latest/pages/env.html

Configuration

The app includes sensible defaults but can be customized extensively. Configuration is stored in .ini format at ~/.config/FastAnime/config.ini on arch linux; for the other operating systems you can check by running fastanime config --path.

[!TIP] You can now use the option --update to update your config file from the command-line For Example: fastanime --icons --fzf --preview config --update the above will set icons to true, use_fzf to true and preview to true in your config file

By default if a config file does not exist it will be auto created with comments to explain each and every option. The default config:

[general]
icons = False

quality = 1080

normalize_titles = True

provider = allanime

preferred_language = english

downloads_dir = ~/Videos/FastAnime

preview = False

ffmpegthumbnailer_seek_time = -1

use_fzf = False

use_rofi = False

rofi_theme =

rofi_theme_input =

rofi_theme_confirm =

notification_duration = 2

sub_lang = eng

default_media_list_tracking = None

force_forward_tracking = True

cache_requests = True

use_persistent_provider_store = False

recent = 50


[stream]
continue_from_history = True

preferred_history = local

translation_type = sub

server = top

auto_next = False

auto_select = True

skip = False

episode_complete_at = 80

use_python_mpv = False

force_window = immediate

format = best[height<=1080]/bestvideo[height<=1080]+bestaudio/best

player = mpv

Contributing

We welcome your issues and feature requests. However, due to time constraints, I currently do not plan to add another provider. But if you are willing to add one yourself pr's are welcome.

If you find an anime title that does not correspond with a provider or is just weird just edit the data file and open a pr, i will ignore issues 😝.

Receiving Support

For inquiries, join our Discord Server.

<p align="center"> <a href="https://discord.gg/HBEmAwvbHV"> <img src="https://invidget.switchblade.xyz/C4rhMA4mmK"> </a> </p>

Supporting the Project

More pr's less issues 🙃 Those who contribute at least five times will be able to make changes to the repo without my review.

Show your support by starring the GitHub repository or buying me a coffee.

Disclaimer

[!IMPORTANT]

This project currently scrapes allanime, hianime, nyaa, yugen and animepahe. The developer(s) of this application does not have any affiliation with the content providers available, and this application hosts zero content. DISCLAIMER