anilibria-cli icon indicating copy to clipboard operation
anilibria-cli copied to clipboard

Search and watch anime with AniLibria.TV

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
    • Optional dependencies
  • Install
    • Uninstall
  • Usage
    • Action keys
  • TODO
  • Issues
  • Contribution

:gear: Dependencies

:exclamation: 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.

:heavy_check_mark: Optional dependencies

Dependency Description
fzf More convienient menus.

:inbox_tray: 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.

:wastebasket: Uninstall

To uninstall run the following command:

sudo make uninstall

:desktop_computer: 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.

    :exclamation: 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

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

  4. Enjoy watching!

:keyboard: Action keys

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

:memo: TODO

  • [ ] Man pages support
  • [x] 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.)

:sos: 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.

:wrench: Contribution

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