/anilibria-cli

Search and watch anime with AniLibria.TV

Primary LanguageShellGNU General Public License v3.0GPL-3.0

anilibria-cli

A POSIX script that allows you to search and watch anime series
with Russian dubbing AniLibria.TV using the official website API


Showcase

Showcase


🧭 Navigation


⚙️ Dependencies

❗ Required dependencies

Dependency Description
jq Parsing JSON responses from a web server.
curl Sending HTTP requests to interact with the API.
mpv OR vlc Playing video and m3u8 playlists.

✔️ Optional dependencies

Dependency Description
fzf More convienient menus.

📥 Install

  1. Install the dependencies listed above

  2. Clone the repository and go to the directory:

    git clone https://github.com/Loureas/anilibria-cli && cd anilibria-cli
  3. Install anilibria-cli with the following commands:

    sudo make install doc

    If you wish to not install documentation run sudo make install instead.

🗑️ Uninstall

To uninstall run the following command:

sudo make uninstall

🖥️ Usage

  1. Run anilibria-cli and you will be prompted to enter a search query:

    Search anime: |
    
  2. Enter a search query. After searching, you will have query results. Choose what you want with numbers:

    Search anime: семь смертных
    

    You can specify external command which will be used for prompt with -p option

    Example: ./anilibria-cli -p 'dmenu -p "{PROMPT}: " < /dev/null'

    [1] Прегрешение: Семь смертных грехов
    [2] Семь небесных добродетелей
    [3] Семь смертных грехов
    [4] Семь смертных грехов 2: Возрождение заповедей
    [5] Семь смертных грехов OVA
    [6] Семь смертных грехов: Гнев богов ТВ-3
    [7] Семь смертных грехов: Знамение священной войны
    [8] Семь смертных грехов: Суд ярости
    [9] Семь смертных грехов: Узники небес
    [p] Back
    [p] Quit
    Choose anime [1-9]: 3
    

    If only one anime is found, it will be selected automatically.

    If fzf is installed or you specified -m option, this menu will be replaced.

    Choosed anime: Семь смертных грехов
    [p] Back
    [q] Quit
    Choose episode [1-24]:
    
  3. Enter episodes:

    One episode:

    Choose episode [1-24]: 4
    

    Negative episode:

    Choose episode [1-24]: -2
    

    This will play 23rd episode

    Multiple episodes:

    Choose episode [1-24]: 2 5 13 -1 -3
    

    A range of episodes:

    Choose episode [1-24]: 3-22
    

    Does not support negative numbers

    If fzf is installed or you specified -M option, this menu will be replaced.

  4. Enjoy watching!

⌨️ Action keys

Key Description
q Exit from the script
p Back to previous action

📝 TODO

  • Man pages support
  • fzf support
  • Thumbnails support
  • History support
  • Featured anime support
  • Quality selection support
  • Download support
  • Download BitTorrent files support
  • Display full anime release information
  • Work out additional options on the command line (quality, episode, search query and etc.)

🆘 Issues

If you have any problems while running the script, you can create a new issue on GitHub or write to Telegram @Loureas with a detailed problem.

🔧 Contribution

You can help improve the script or translate it. Publish changes in Pull Request or Telegram @Loureas. All changes will be reviewed.