dkcheun/aniverse

Aniverse

An uneducated attempt at rewriting Consumet / Anify in Go.

Join the Discord

TODO

Authenticaiton

• Basic OAuth Authentication (AniList -- forced)

Anime Information

• Fetch ANime information from AniList (by ID or Title)
  • Cache anime details with Redis to minimize API calls and improve performance.

Anime Search

• Basic Search (anime by title from GogoAnime)
  • Improve search functionality to support filters such as year, genre, etc...

Episodes

• Fetch episode list from gogo anime
• Combine Seasons: Implement logic to merge multiple seasons into a single result i

Streaming Sources

• Fetch streaming sources for episode
• **Ensure Compatibility w/ Other Servers: Verify and ensure compatibility with additional streaming proviers.

Mappings

• Map AniList Data to other List providers and streaming sources.
• Support additional providers, expanding the mapping system to support more anime databases like MAL, Kitsu, etc...
  • Mapping Between Providers:
    This involves creating a system that allows anime information to be fetched from one provider (e.g, AniList) to be correctly mapped to another provder.
  • Future Proofing
    The system should be expandable to support future providers like MAL, Kitsu, and other services.

Additional Enhancements

• Implement Pagination for large episode lists and search resuts
• Rate Limiting: Add it... no shit
• Error Handling: Improve overall error handling and add better error messages for clarity.

Providers

• AniList

1. Get Anime Information

Fetch information about an anime by its ID or title from AniList.

Query Parameters

• provider (optional): The provider to fetch the anime information from. Default is anilist.

Request Examples

By ID

GET /info/166531?provider=anilist

By Title

GET /info/oshi-no-ko-2nd-season??provider=anilist

Response

Success (200 OK)

{
  "id": 166531,
  "title": {
    "romaji": "[Oshi no Ko] 2nd Season",
    "english": "Oshi no Ko Season 2",
    "native": "【推しの子】第2期",
    "synonyms": null
  },
  "coverImage": {
    "large": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/medium/bx166531-dAL5MsqDHUkj.jpg",
    "extraLarge": "https://s4.anilist.co/file/anilistcdn/media/anime/cover/large/bx166531-dAL5MsqDHUkj.jpg",
    "color": "#e44343"
  },
  "description": "The second season of [Oshi no Ko]. Aqua’s desire for revenge takes center stage as he navigates the dark underbelly of the entertainment world alongside his twin sister, Ruby. While Ruby follows in their slain mother’s footsteps to become an idol, Aqua joins a famous theater troupe in hopes of uncovering clues to the identity of his father — the man who arranged their mother’s untimely death, and the man who once starred in the same troupe Aqua hopes to infiltrate. (Source: HIDIVE)",
  "status": "RELEASING",
  "episodes": 13,
  "duration": 24,
  "season": "SUMMER",
  "seasonYear": 2024,
  "genres": [
    "Drama",
    "Mystery",
    "Psychological",
    "Supernatural"
  ],
  "synonyms": [
    "我推的孩子"
  ],
  "averageScore": 81,
  "meanScore": 81,
  "popularity": 79741,
  "trailer": {
    "id": "QMuajQlx64c",
    "site": "youtube",
    "thumbnail": "https://i.ytimg.com/vi/QMuajQlx64c/hqdefault.jpg"
  },
  "bannerImage": "https://s4.anilist.co/file/anilistcdn/media/anime/banner/166531-vUu7iDwUkC67.jpg"
}   

2. Search Anime

Search for an anime by its title from GogoAnime.

Query Parameters

• provider (optional): The provider to fetch the anime information from. Default is gogoanime.
• query: The search query.

GET /search?provider=gogoanime&query=oshi-no-ko

[
  {
    "id": "/category/oshi-no-ko",
    "title": "\"Oshi no Ko\"",
    "altTitles": [],
    "year": 2023,
    "format": "TV",
    "img": "https://gogocdn.net/cover/oshi-no-ko-1680121500.png",
    "providerId": "gogoanime"
  },
  {
    "id": "/category/oshi-no-ko-dub",
    "title": "\"Oshi no Ko\" (Dub)",
    "altTitles": [],
    "year": 2023,
    "format": "TV",
    "img": "https://gogocdn.net/cover/oshi-no-ko-dub.png",
    "providerId": "gogoanime"
  },
  ...
]

3. Get Episodes

Fetch all episodes for a given anime ID from GogoAnime. Query Parameters

• provider (optional): The provider to fetch the episodes from. Default is gogoanime

GET /episodes/oshi-no-ko

{
    "id": " /oshi-no-ko-episode-1",
    "title": "EP 1",
    "number": 1,
    "isFiller": false,
    "img": null,
    "hasDub": false,
    "description": null,
    "rating": null
  },
  {
    "id": " /oshi-no-ko-episode-2",
    "title": "EP 2",
    "number": 2,
    "isFiller": false,
    "img": null,
    "hasDub": false,
    "description": null,
    "rating": null
  }
  ...

4. Get Episode

Fetch the streaming sources for a given episode from GogoAnime.

GET /watch/oshi-no-ko-2nd-season/1

{
  "sources": [
    {
      "url": "${this is the source}",
      "type": "hls",
      "is_m3u8": true,
      "thumbnail": "",
      "thumbnail_type": "",
      "flags": null
    },
    {
      "url": "${this is the source}",
      "type": "hls",
      "is_m3u8": true,
      "thumbnail": "",
      "thumbnail_type": "",
      "flags": [
        0
      ]
    }
  ],
  "subtitles": null,
  "audio": null,
  "intro": {
    "start": 0,
    "end": 0
  },
  "outro": {
    "start": 0,
    "end": 0
  },
  "headers": null
}