• Stars
    star
    135
  • Rank 269,297 (Top 6 %)
  • Language
    Shell
  • License
    GNU General Publi...
  • Created over 5 years ago
  • Updated 11 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🍿 anime scraper/downloader + trackma wrapper

adl
GitHub Repo stars GitHub Repo stars

This is wrapper for animdl + trackma.
The goal? Type adl, hit enter, choose show, watch show, update episode number with as little input as possible.

Note: any visual glitches in the above are caused by the terminal recorder.

Features

  • fetch currently watching anime from your account;
  • ability to switch between lists: watching, completed, rewatching, paused, dropped, plantowatch;
  • option to change account used by trackma;
  • option to update local list;
  • select multiple anime to be watched in sequence;
  • watch any episode from the anime chosen, default is the next episode;
  • easily watch all available episodes after last watched, in order to catch up. Also update list accordingly;
  • prompt user for watching another show;
  • prompt user to add a score to an anime if the anime in question will be set as completed;
  • option to skip all user input - works in combination with the other options as well;
  • download instead of watching; everything from above still applies;
  • use local media instead of streaming:
    • requires identical folder name to anilist anime title; ex: Fruits Basket: 2nd Season should be a folder inside animedir containing the vidoes, otherwise adl will not find the anime folder;
    • considering different naming conventions, fzf is used for episode selecting and perl is used for better matching, but it will search for 0# format;
    • to avoid Scans and other such extras, the find maxdepth is set to 1, as such don't have folders inside folders; use a symlink instead, or change the maxdepth variable.
  • do not display verbose vlc output;
  • warn user if episode wasn't found;
  • download covers from anilist and show them in the terminal. Example:

Requirements

Note: vn-ki/anime-downloader seems to be depricated. As such I have ported to animdl.

  • animdl - make sure this works. Settings for animdl, such as provider, need to be placed in your configuration file.
  • z411/trackma - tested with anilist (you need to set up trackma before using adl). Also adl now needs the following PR merge that fixes issue #9;
  • junegunn/fzf - needed for show selection and cover previews. Make sure you install the latest version from github to prevent issue #35;
  • MPV - used to play the anime (better integration with anime-downloader). VLC can also be used: $adl -p vlc;
  • perl - for regular expressions;
  • frece - optional - $adl -f will show most watched anime at the top of the list. By default frece is not used;
  • ueberzug - optional - $adl -c will download covers from anilist to /tmp/ using cURL and wget, then will display the covers using ueberzug in the fzf anime selection window. Alternatively, the script adl_covers.py in this repo also downloads covers.

Installation

Linux

  • Install all the dependencies from above.
  • Simply download the script into your ~/bin or ~/local/bin folder and make it executable. ~/bin should be added to your $PATH.
mkdir -p "$HOME/bin"
wget https://raw.githubusercontent.com/RaitaroH/adl/master/adl -O "$HOME/bin/adl"
chmod +x "$HOME/bin/adl"

Or:

wget https://raw.githubusercontent.com/RaitaroH/adl/master/adl -O "$HOME/.local/bin/adl"
chmod +x "$HOME/.local/bin/adl"

Windows

Windows platform is not officially supported. User discretion is advised.

  • Install Chocolatey package manager (used to install other dependencies).
  • Install git-for-windows (used to run the bash script).
  • Should not be needed to be installed separately, but perl and curl are also required.
  • Open CMD/PowerShell as /Administrator/ and run the following dependencies. nodejs is not strictly needed, but many providers need it.
choco install -y python3 aria2 mpv fzf nodejs
refreshenv
  • Install trackma and anime-downloader using pip. Note: if needed you may install youtube-dl as well.
pip install -U git+https://github.com/anime-dl/anime-downloader Trackma
  • Setup trackma as seen below. If you already have trackma set up, then skip this step.

  • Change default provider, Anime Downloader Configuration.

  • Download this repository. You will need adl and player_check.bat at the least. You may download the zip or clone the repository. Be mindful of the folder you are in:

git clone https://github.com/RaitaroH/adl.git
cd adl
  • To run the script execute the command from below. C:\Program Files\Git\bin\ should be added to your PATH to simply use bash.exe. You may type refreshenv to reload the environment variables after adding to PATH, or reopen the CMD/PowerShell. Note: .\adl assumes you are currently in the folder where adl is; otherwise specify the full path.
bash .\adl
  • see adl -h for more information.

Windows sepcific issues

  • covers don't work;
  • in the event that adl cannot count watched episodes:
    1. verify that mpv.com exists at C:\ProgramData\chocolatey\lib\mpv.install\tools;
    2. from a CMD run echo %PATHEXT% to test if you get .COM;.EXE;... and not .EXE;.COM.... Change the PATHEXT if needed.
    3. use bash .\adl -p 'mpv.com' as last option. This might break some providers.

Trackma Setup

Setting up Trackma can be done using the GTK and Qt interfaces. Alternatively:

  • In the CMD/PowerShell/Terminal type trackma;
  • Type a to add an account;
  • Type anilist/myanimelist etc;
  • Enter your username;
  • Copy the url in a browser and get your token from the anime site;
  • Paste the pin in the CMD/PowerShell/Terminal;
  • Type retrieve to get your list. Note: you may use adl -r to force retrieve before getting the anime list.

Anime Downloader Configuration

The provider animdl is using, may not work for you. As such configure animdl by editing the config file.

Note - adl used to be able to change providers, as "anime dl" had a flag for it; "animdl" does not, so you will ned to modify the file manually.

Updating

adl also has a function for updating itself from source. To use it run adl -u or adl --update and follow the prompts.

Issues

If the show doesn't start for you, the script will inform you of this. If you are positive that the episode number has aired, then most likely the provider you are using is NOT yet up-to-date.

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Baitinq

πŸ› πŸ’» πŸ€”

Justaus3r

πŸ’» βœ…

This project follows the all-contributors specification. Contributions of any kind welcome!

More Repositories

1

YouTube-DeepDark

Videos should only be watched in the dark. May the dark be kinder on thine eyes. (YouTube dark theme)
CSS
213
star
2

LibreOffice-BreezeDark

Icons, color palette and color scheme for LibreOffice
108
star
3

Stylus-DeepDark

Write thy themes in the dark. May the dark be kinder on thine eyes. (Stylus dark theme)
CSS
46
star
4

MyAnimeList-DeepDark

Satisfy thy craving for anime and organization. May the dark be kinder on thine eyes. (MyAnimeList Dark Theme)
CSS
34
star
5

DuckDuckGo-DeepDark

Light will blind you in your search for answers, dark will make them shine. May the dark be kinder on thine eyes. (DuckDuckGo dark theme)
CSS
25
star
6

DarkWeb

A repository for dark themes (that actually aren't broken) made by many users.
15
star
7

KDE-Terminal-Wallpaper-Changer

πŸŒ† CLI wallpaper changer for KDE Plasma5 + extra goodies
Shell
14
star
8

Import-All-Deepdark

Import my deepdark themes all at once from github. May the dark be kinder on thine eyes.
CSS
14
star
9

BreezeDarkColorSchemes

A few custom breeze dark color schemes based on breeze dark
Shell
10
star
10

DELL-Inspiron-Gaming-7567

How does DELL Inspiron Gaming 7567 perform with Linux on it.
10
star
11

Userstyles-DeepDark

Host your code in the dark. May the dark be kinder on thine eyes. (userstyles.org dark theme)
CSS
8
star
12

ProtonMail-DeepDark

Emails should be written and read in the dark. May the dark be kinder on thine eyes. (PrtonMail dark theme)
CSS
8
star
13

Gmail-DeepDark

Emails should be written and read in the dark. May the dark be kinder on thine eyes. (Gmail dark theme)
CSS
7
star
14

BreezeDarkIconColors

A script that changes the color of the folder icons from breeze dark.
Shell
6
star
15

WhatsApp-DeepDark

Talk with thy friends in the dark. May the dark be kinder on thine eyes. (WhatsApp dark theme)
CSS
5
star
16

sxhkd_plasma

⌨️ Integrating sxhkd into plasma without loosing functionality.
5
star
17

Random-Code

Just a lot of stuff with no place exactly
Vim Script
5
star
18

KissAnime-DeepDark

Watch anime in a bright room with a dark theme. May the dark be kinder on thine eyes. (KissAnime dark theme)
CSS
4
star
19

Vidme-DeepDark

Videos should only be watched in the dark. May the dark be kinder on thine eyes. (Vid.me dark theme)
CSS
3
star
20

Jisho-DeepDark

Learn japanese in the dark. May the dark be kinder on thine eyes. (jisho dark theme)
CSS
2
star
21

Template-DeepDark

A template for deepdark themes.
CSS
2
star
22

Vertex-Breeze-Metacity

A fork from the vertex theme with a touch of KDE's breeze.
CSS
2
star
23

Qwant-DeepDark

Light will blind you in your search for answers, dark will make them shine. May the dark be kinder on thine eyes. (Qwant dark theme)
CSS
2
star
24

Xfce-Goodies-Tutorial

How to use the xfce4-panel as a dock? How to use the Whisker Menu if I am not using Xfce De? How to use the xfce terminal as a drop down terminal? Here is how.
2
star
25

MyAnimeList-MyListClassic

My custom classic style for MAL.
CSS
1
star
26

Conky-Breeze

Conky inspired by Gotham and configured for KDE.
Shell
1
star
27

ksms

Send sms through kdeconnect-cli and fzf
1
star
28

rofi-tools

The rofi/dmenu scripts I use (edit is required for personal use)
Shell
1
star
29

Syncthing-DeepDark

Sync files in the dark. (Syncthing dark theme)
CSS
1
star
30

OpenUserCSS-DeepDark

Host your code in the dark. May the dark be kinder on thine eyes. (openusercss.org dark theme)
CSS
1
star