{"id":24107455,"url":"https://github.com/elpideus/tadako","last_synced_at":"2026-02-18T09:02:26.442Z","repository":{"id":270070903,"uuid":"909255263","full_name":"elpideus/tadako","owner":"elpideus","description":"An unofficial AnimeWorld API","archived":false,"fork":false,"pushed_at":"2025-03-13T23:24:54.000Z","size":3131,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-25T03:55:04.375Z","etag":null,"topics":["anime","api","bun","italian","library","node","node-js","nodejs","npm","npm-package","scraping"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/tadako","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elpideus.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-28T06:37:39.000Z","updated_at":"2025-03-28T22:11:35.000Z","dependencies_parsed_at":"2025-05-12T16:46:39.839Z","dependency_job_id":"ec649661-a6bf-42d0-9121-c01c1a59f652","html_url":"https://github.com/elpideus/tadako","commit_stats":null,"previous_names":["elpideus/tadako.js","elpideus/tadako"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/elpideus/tadako","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elpideus%2Ftadako","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elpideus%2Ftadako/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elpideus%2Ftadako/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elpideus%2Ftadako/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elpideus","download_url":"https://codeload.github.com/elpideus/tadako/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elpideus%2Ftadako/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29574065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T08:38:15.585Z","status":"ssl_error","status_checked_at":"2026-02-18T08:38:14.917Z","response_time":162,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anime","api","bun","italian","library","node","node-js","nodejs","npm","npm-package","scraping"],"created_at":"2025-01-10T22:30:08.153Z","updated_at":"2026-02-18T09:02:26.424Z","avatar_url":"https://github.com/elpideus.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![npm Version](https://img.shields.io/badge/npm-v11.0.0-informational?style=for-the-badge\u0026logo=npm)\n![GitHub release ](https://img.shields.io/github/v/release/elpideus/tadako?include_prereleases\u0026style=for-the-badge\u0026logo=github)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/elpideus/tadako?style=for-the-badge\u0026logo=github)\n![GitHub all releases](https://img.shields.io/github/downloads/elpideus/tadako/total?style=for-the-badge\u0026logo=github)\n![npm weekly downloads](https://img.shields.io/npm/dt/tadako?label=Weekly%20Downloads\u0026style=for-the-badge\u0026logo=npm)\n![GitHub](https://img.shields.io/github/license/elpideus/tadako?style=for-the-badge)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/y/elpideus/tadako?style=for-the-badge\u0026label=Updates%20Frequency)\n![GitHub last commit](https://img.shields.io/github/last-commit/elpideus/tadako?style=for-the-badge\u0026label=Updated)\n![GitHub Repo stars](https://img.shields.io/github/stars/elpideus/tadako?label=Stars\u0026style=for-the-badge\u0026logo=github)\n![GitHub forks](https://img.shields.io/github/forks/elpideus/tadako?label=Forks\u0026style=for-the-badge\u0026logo=github)\n![GitHub watchers](https://img.shields.io/github/watchers/elpideus/tadako?label=Watchers\u0026style=for-the-badge\u0026logo=github)\n\n# Tadako - An unofficial AnimeWorld API\n\nThis is a library inspired by [MainKronos' AnimeWorld-API](https://github.com/MainKronos/AnimeWorld-API).\nTadako is still under development and as such expect changes and relatively frequent refactoring.\n\n---\n\n## Installation\nThis library depends on [puppeteer](https://github.com/puppeteer/puppeteer/) and [cheerio](https://github.com/cheeriojs/cheerio).\\\nWe love and support [bun](https://bun.sh/) and as such the library is tailored to work perfectly with it.\n\nInstallation via bun:\n```shell script\nbun install -g tadako\n```\n\nInstallation via npm:\n```shell script\nnpm install -g tadako\n```\n\n\u003e If you want to use the cli remember to install [mpv](https://mpv.io/) as well on your system. To do that you can use one\n\u003e of the following commands:\n\u003e\n\u003e #### Windows\n\u003e There are many different ways you can install mpv depending on your preferences.\n\u003e\n\u003e [chocolatey](https://chocolatey.org/):\n\u003e ```shell\n\u003e choco install mpvio.install\n\u003e ```\n\u003e \n\u003e [scoop](https://scoop.sh/):\n\u003e ```shell\n\u003e scoop bucket add extras\n\u003e scoop install extras/mpv\n\u003e ```\n\u003e You can also download the official first-party nightly build by clicking [here](https://nightly.link/mpv-player/mpv/workflows/build/master/mpv-x86_64-windows-msvc.zip).\n\u003e\n\u003e #### Linux\n\u003e \n\u003e Arch (Manjaro / SteamOS*): \n\u003e ```shell\n\u003e sudo pacman -S mpv\n\u003e ```\n\u003e \n\u003e Debian (Ubuntu):\n\u003e ```shell\n\u003e sudo apt update\n\u003e sudo apt install mpv\n\u003e ```\n\u003e \n\u003e Fedora:\n\u003e ```shell\n\u003e sudo dnf install mpv\n\u003e ```\n\u003e \n\u003e OpenSuse:\n\u003e ```shell\n\u003e sudo zypper install mpv\n\u003e ```\n\u003e \n\u003e Gentoo:\n\u003e ```shell\n\u003e sudo emerge media-video/mpv\n\u003e ```\n\u003e \n\u003e Void Linux\n\u003e ```shell\n\u003e sudo xbps-install -S mpv\n\u003e ```\n\u003e\n\u003e Flatpak*\n\u003e ```shell\n\u003e flatpak install flathub io.mpv.Mpv\n\u003e flatpak run io.mpv.Mpv\n\u003e  ```\n\u003e\n\u003e ###### The * indicates a distro/method that hasn't been tested thoroughly.\n\u003e \n\u003e #### Mac OS\n\u003e ###### We didn't test any of the following sources and cannot provide support for Mac OS.\n\u003e Mac OS 13 (Intel) -\u003e [Download](https://nightly.link/mpv-player/mpv/workflows/build/master/mpv-macos-13-intel.zip) \\\n\u003e Mac OS 14 (Arm) -\u003e [Download](https://nightly.link/mpv-player/mpv/workflows/build/master/mpv-macos-14-arm.zip) \\\n\u003e Mac OS 15 (Arm) -\u003e [Download](https://nightly.link/mpv-player/mpv/workflows/build/master/mpv-macos-15-arm.zip)\n\n---\n\n## CLI Usage\n\n### Streaming\nIt is possible to watch anime directly through tadako.\n```shell\ntadako \"violet evergarden\"\n```\n\n### Downloading\nDownloading anime from AnimeWorld has never been as easy.\n```shell\ntadako \"violet evergarden\" download\n```\n\n---\n\n## Library Usage\n\n### Importing\nYou can import the library into your project and just start working with it.\n\n```typescript\nimport Tadako from \"tadako\";\n```\n\n### Fetching\nWe tried to make the entire process of fetching data as straightforward as possible, while at the \nsame time sending as few requests as possible to [AnimeWorld](https://animeworld.so).\\\nAs such some data like the title or the poster are fetched directly from the search request, as shown below:\n\n```typescript\nTadako.search(\"re:zero\").then(data =\u003e {\n    console.log(data.results[0].title)\n});\n```\n\nHowever, as some data needs to be fetched from other locations, forcing us to make another request. That doesn't happen\nautomatically as it would send a lot of useless requests to the server. We can manually call an update with the\nremaining data by using `.init()` or `.data()` on any `Anime` object. \n\n```typescript\nTadako.search(\"re:zero\").then(data =\u003e {\n    data.results[0].data().then(remainingResults =\u003e {\n        console.log(remainingResults.episodes[0].getDownloadURL());\n    })\n});\n```\n\nWe highly recommend working with asynchronous functions as it highly reduces nesting and verbosity.\n\n```typescript\nconst main = async () =\u003e {\n    const search = await Tadako.search(\"re:zero\");\n    const anime = await search.results[0].data();\n    console.log(anime.episodes[0].getDownloadURL());\n}\n\nmain();\n```\n\n### Filtering\n\nAll the filters usable on the official AnimeWorld website are also available here.\n\nWe tried to make filters as easy to use as possible. We went as far as to creating an\nenumerator for all the available studios, so you don't even have to remember how they are called exactly, and you don't\neven have to bother remembering the correct casing. We handle it all.\n\n```typescript\nimport Tadako, {Studio} from \"./index\";\n\nconst main = async () =\u003e {\n    const search = await Tadako.search(\"re:zero\", {studio: Studio.WHITE_FOX});\n    const animeList = search.results;\n    animeList.forEach(anime =\u003e console.log(anime.title));\n}\n\nmain();\n```\n\nDepending on your environment and the IDE/Text Editor you are using, intellisense will help you find the studio you are\nsearching for in seconds. In the screenshot below we are using [Jetbrains](https://www.jetbrains.com/)' \n[Webstorm](https://www.jetbrains.com/webstorm/).\n![./assets/img/studio_intellisense_screenshot.png](assets/img/studio_intellisense_screenshot.png)\n\nWe are actively working on compiling small snippets of information for each and every studio and we also cite all the\nsources that are helping us in doing so.\n![studio_intellisense_jsdoc_description_screenshot.png](assets/img/studio_intellisense_jsdoc_description_screenshot.png)\n\n---\n\n## TODO:\n\nThese are things that we still need to implement in no specific order.\n\n- Implement localization system\n- Add more data in `info` (and more accurate)\n- Add support for different download servers\n- Create documentation website\n- Finish descriptions of all the studios.\n- Automatic download of platform-specific dependencies (like mpv)\n- Add proxy support\n- Make [Jellyfin](https://jellyfin.org/) plugin","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felpideus%2Ftadako","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felpideus%2Ftadako","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felpideus%2Ftadako/lists"}