mal
is a command-line client for MyAnimeList.net which uses the official API.
It should remain functional indefinitely (unlike web-scraping alternatives).
It is currently in alpha development so new ideas are welcome!
This project was inspired initially in mal.
- Searching your anime list
- Fetch your anime list
- List animes in certain status (e.g. watching)
- Increment or decrement episodes seen of animes
- Add animes to your plan to watch list
- Edit contents of your animes on its your own preferred text editor: tags, status, score.
- Print your MAL stats! Just like MyAnimeList stats.
And more are currently being developed!
- Python 3.4+
- setuptools (For installing and developing)
- requests
- appdirs
- decorating
- argparse (Merged into stdlib since version 3.2)
Check requirements.txt for exact versions.
From the command line run:
pip install --user mal
Clone this project and run inside it:
make install
Probably we'll need have super-user permissions, but I'd recommend you to install inside of a virtualenv or use the `pip install --user' stuff.
If you're using the archlinux distro this project has been packaged and uploaded to the AUR as python-mal-git.
The program needs your credentials to access your list. In the first call to any valid command the program will ask for your username and password and save it in plain text in the default path (on linux ~/.config/mal/myanimelist.ini
).
The file will be save in the following format:
[mal]
username = your_username
password = your_password
After authenticating you can start using the program.
When mal
is executed without any arguments the help message is displayed:
usage: mal [-h] [-v]
{search,filter,increase,inc,decrease,dec,login,list,config,drop,stats,add,edit}
...
MyAnimeList command line client.
positional arguments:
{search,filter,increase,inc,decrease,dec,login,list,config,drop,stats,add,edit}
commands
search search an anime
filter find anime in users list
increase (inc) increase anime's watched episodes by one
decrease (dec) decrease anime's watched episodes by one
login save login credentials
list list animes
config Print current config file and its path
drop Put a selected anime on drop list
stats Show anime watch stats
add add an anime to the list
edit edit entry
optional arguments:
-h, --help show this help message and exit
-v, --version show the version of mal
You can also use the -h
or --help
options on mal
or any of its subcommands to see specific help message.
Look at CONTRIBUTING.md