Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ym496/myanimelist-discord-bot
A python bot made to surf MyAnimeList website from discord.
https://github.com/ym496/myanimelist-discord-bot
anime discord-bot discord-py jikan manga myanimelist
Last synced: 2 months ago
JSON representation
A python bot made to surf MyAnimeList website from discord.
- Host: GitHub
- URL: https://github.com/ym496/myanimelist-discord-bot
- Owner: ym496
- License: mit
- Created: 2021-09-06T18:39:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2021-09-09T17:34:19.000Z (over 3 years ago)
- Last Synced: 2023-07-18T10:27:54.133Z (over 1 year ago)
- Topics: anime, discord-bot, discord-py, jikan, manga, myanimelist
- Language: Python
- Homepage:
- Size: 50.8 KB
- Stars: 9
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MyAnimeList-discord-bot
A python bot made to surf MyAnimeList website from discord.
# Overview
A discord bot made to surf the MyAnimeList website on discord with the help of the [Jikan REST API](https://github.com/jikan-me/jikan-rest). View the information about any anime, manga, character etc. using advanced search commands. Look into the pictures of your favourite character from any anime or manga using a single search command. View the anime/manga lists and profile of users.
# Planned
| Commands | Description |
| ----------- | ----------- |
| `+top ` | To view rankings of characters, animes and mangas. |
# Commands
## Search
| Commands | Description | Examples|
| --- | ----------- |---------|
| `+anime ` | Get information about an anime. |+anime Hyouka, +anime NHK ni Youkoso!|
|`+manga ` | Get information about a manga. |+manga attack on titan, +manga Omniscient Reader|
### Screenshot
## Character
| Commands | Description | Examples|
| --- | ----------- |---------|
| `+char ` | Get Information about the requested character. |+character Mikasa, +char Oreki|
|`+images ` | Get images for the requested character. |+images Mikasa, +im Eru Chitanda|
### Screenshots
## User
| Command | Brief | Flags |
| --- | ----------- |---------|
| `+user ` | Shows information about an user. |`manga`
`reading`
`plantoread`
`completed`
`dropped`
`onhold`
`plantowatch`
`watching`|
### Usage
```
+user [--manga] [--reading] [--ptr] [--completed] [--dropped] [--onhold] [--ptw] [--watching]
```
### Description
* Shows detailed information about MyAnimeList user's list or sends you the general profile information about their profile.
* Use flag `--m` or `--manga` to specify if you need manga list of a particular status.
* For example, if you want to look into completed manga(s) of user wildcyclotron:
```
+user wildcyclotron --completed --m
```
* For flags like `--reading` or `--ptr`(or `--plantoread`), you may or may not pass the `--manga` because it's obvious that they belong to manga list.
* The position of flags doesn't matter i.e `--dropped --m` is same as `--m --dropped`
### Examples
```
+user wildcyclotron
+user wildcyclotron --watching
+u wildcyclotron --completed
+u wildcyclotron --onhold
+u wildcyclotron --ptw
+u wildcyclotron --dropped
+u wildcyclotron --completed --m
+u wildcyclotron --dropped --m
+u wildcyclotron --onhold --m
+u wildcyclotron --reading
+u wildcyclotron --ptr
```
### Screenshots
# Installing
* Make sure to get Python 3.8 or higher.
* Set up venv
```
python3.8 -m venv venv
```
* Install dependencies
```
pip install -U -r requirements.txt
```
* To install the development version, do the following:
```
$ git clone https://github.com/WildCyclotron/MyAnimeList-discord-bot.git
```
# Running
* Edit `main.py` and replace the `'Token'` with the your bot's actual token.
* Save your changes and run the `main.py` file.
```
python main.py
```
# DISCLAIMER
Please be respectful towards MyAnimeList's [Terms Of Service](https://myanimelist.net/about/terms_of_use).