# AniDB Builders

You can find anime using the features of [AniDB.net](https://anidb.net/) (AniDB).

No configuration is required for these builders.

| Attribute                           | Description                                                                                    | Works with Movies | Works with Shows | Works with Playlists and Custom Sort |
|:------------------------------------|:-----------------------------------------------------------------------------------------------|:-----------------:|:----------------:|:------------------------------------:|
| [`anidb_id`](#anidb-id)             | Finds the anime specified by the AniDB ID                                                      |      ✅      |     ✅      |               ❌               |
| [`anidb_relation`](#anidb-relation) | Finds all anime in the relation graph of the specified AniDB ID                                |      ✅      |     ✅      |               ❌               |
| [`anidb_popular`](#anidb-popular)   | Finds every anime in AniDB's [Popular Anime](https://anidb.net/latest/anime/popular/?h=1) list |      ✅      |     ✅      |               ✅                |
| [`anidb_tags`](#anidb-tag)          | Finds every anime in a AniDB Tag                                                               |      ✅      |     ✅      |               ❌               |

## AniDB ID

Finds the anime specified by the AniDB ID.

The expected input is an AniDB ID or AniDB Anime URL. Multiple values are supported as either a list or a comma-separated string.

```yaml
collections:
  Sword Art Online Shows:
    anidb_id: 8692, 8691, 13494
```
```yaml
collections:
  Sword Art Online Shows:
    anidb_id: https://anidb.net/anime/8692, https://anidb.net/anime/8691, https://anidb.net/anime/13494
```

## AniDB Relation

Finds all anime in the relation graph of the specified AniDB ID.

To see the relation graph of an anime use: `https://anidb.net/anime/<ANIDB_ID>/relation/graph` but replace `<ANIDB_ID>` with the AniDB ID you want to see the relations for.

The expected input is an AniDB ID, AniDB Anime URL, or AniDB Anime Relation URL. Multiple values are supported as either a list or a comma-separated string.

```yaml
collections:
  All Sword Art Online:
    anidb_relation: 8692
```
```yaml
collections:
  All Sword Art Online:
    anidb_relation: https://anidb.net/anime/8692
```
```yaml
collections:
  All Sword Art Online:
    anidb_relation: https://anidb.net/anime/8692/relation/graph
```

## AniDB Popular

Finds every anime in AniDB's [Popular Anime](https://anidb.net/latest/anime/popular/?h=1) list.

The expected input is a single integer value of how much anime to query with a max of 30.

The `sync_mode: sync` and `collection_order: custom` Details are recommended since the lists are continuously updated and in a specific order. 

```yaml
collections:
  AniDB Popular:
    anidb_popular: 30
    collection_order: custom
    sync_mode: sync
```

## AniDB Tag

Finds anime with the specified AniDB Tag the options are detailed below. 

| Attribute | Description                                                   | Required | Default |
|:----------|:--------------------------------------------------------------|:--------:|:-------:|
| `tag`     | AniDB Tag ID to search by                                     | &#9989;  |   N/A   |
| `limit`   | Number of Anime to query from AniDB (use 0 for all; max: 500) | &#10060; |    0    |

```yaml
collections:
  Pirates Anime:
    anidb_tag:
      tag: 1700
      limit: 500
    sync_mode: sync
```

* To find possible tags go to the [AniDB Anime](https://anidb.net/tag) page to find the tags available. Copy the link and find the tag ID at the end of the url.