You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
80 lines
4.3 KiB
80 lines
4.3 KiB
# MyAnimeList Attributes
|
|
|
|
Configuring [MyAnimeList](https://myanimelist.net/) is optional but is required for MyAnimeList based collections to function.
|
|
|
|
A `mal` mapping is in the root of the config file.
|
|
|
|
Below is a `mal` mapping example and the full set of attributes:
|
|
```yaml
|
|
mal:
|
|
client_id: ################################
|
|
client_secret: ################################################################
|
|
authorization:
|
|
access_token:
|
|
token_type:
|
|
expires_in:
|
|
refresh_token:
|
|
```
|
|
|
|
| Attribute | Allowed Values | Required |
|
|
|:----------------|:--------------------------------------|:--------:|
|
|
| `client_id` | MyAnimeList Application Client ID | ✅ |
|
|
| `client_secret` | MyAnimeList Application Client Secret | ✅ |
|
|
|
|
* All other attributes will be filled in by the script.
|
|
|
|
* To connect to MyAnimeList.net you must create a MyAnimeList application and supply the script the `client id` and `client secret` provided, please do the following:
|
|
1. [Click here to create a MyAnimeList API application.](https://myanimelist.net/apiconfig/create)
|
|
2. Enter an `App Name` for the application. Ex. `Plex Meta Manager`
|
|
3. Select `web` for `App Type`.
|
|
4. Enter an `App Description` for the application Ex. `Plex Meta Manager manages metadata and collections`
|
|
5. Enter `http://localhost/` for `App Redirect URL`.
|
|
6. Enter `https://github.com/meisnate12/Plex-Meta-Manager` for `Homepage URL`.
|
|
7. Select `non-commercial` for `Commercial / Non-Commercial`.
|
|
8. Enter any name under `Name / Company Name`.
|
|
9. Select `hobbyist` for `Purpose of Use`.
|
|
10. Agree to the API License and Developer Agreement and hit the `Submit` button
|
|
11. You should see `Successfully registered.` followed by a link that says `Return to list` click this link.
|
|
12. On this page Click the `Edit` button next to the application you just created.
|
|
13. Record the `Client ID` and `Client Secret` found on the application page.
|
|
|
|
* On the first run, the script will walk the user through the OAuth flow by producing a MyAnimeList URL for the user to follow. After following the URL login to MyAnimeList.net and authorize the application by clicking the `Allow` button which will redirect the user to `http://localhost/`. Copy the entire URL and paste it into the script and if the URL is correct then the script will populate the `authorization` sub-attributes to use in subsequent runs.
|
|
|
|
On first run:
|
|
```
|
|
|====================================================================================================|
|
|
| Connecting to My Anime List... |
|
|
| |
|
|
| Navigate to: https://myanimelist.net/v1/oauth2/authorize?response_type=code&client_id=BING&code_challenge=BANG |
|
|
| |
|
|
| Login and click the Allow option. You will then be redirected to a localhost |
|
|
| url that most likely won't load, which is fine. Copy the URL and paste it below |
|
|
| URL:
|
|
|
|
```
|
|
|
|
Click on that URL to open your browser to MyAnimeList; you'll be looking at a page like this:
|
|
|
|
|
|
|
|
Click "Allow", and you will be taken to a page that will not load. That's fine and expected.
|
|
|
|
|
|
|
|
Copy the URL, which will be `localhost/?code=BLAH` and paste it at the prompt.
|
|
```
|
|
| URL: http://localhost/?code=BOING
|
|
| Saving authorization information to /path/to/Plex-Meta-Manager/config/config.yml |
|
|
| My Anime List Connection Successful |
|
|
|====================================================================================================|
|
|
|
|
```
|
|
|
|
<h4>OAuth Flow using Docker</h4>
|
|
|
|
To authenticate MyAnimeList the first time, you need run the container with the `-it` flags in order to walk through the OAuth flow mentioned above. Once you have the MyAnimeList authentication data saved into the YAML, you'll be able to run the container normally.
|
|
|
|
<h4>OAuth Flow using unRAID Docker</h4>
|
|
|
|
Directions on how to authenticate MyAnimeList on unRAID can be found on the [unRAID Walkthrough](../home/guides/unraid.md#advanced-installation-authenticating-trakt-or-myanimelist) page.
|