Skip to content

Web UI ​

Start it with:

bash
aniworld -w

The default address is http://localhost:8080.

Everyday workflow ​

  1. Pick a site at the top of the Home page.
  2. Search or choose a title from the browse sections.
  3. Pick a download folder and episodes, plus a language/provider when the site offers a choice.
  4. Add the selection to the queue.
  5. Open Queue to watch progress, reorder items, retry failures, or cancel work.

Search failures display an error, and failed browse rows offer Try again. Moflix's homepage title row and keyword searches allow up to two minutes for requests that may need verification. Retrying a failed browse row fetches it again.

The remaining pages are intentionally simple:

PageWhat it does
LibraryShows downloaded folders and lets admins remove files
Auto-SyncAdmin page that checks AniWorld’s new-episode feed for titles already in your library; disabled by default
SettingsAdmin page for paths, defaults, users, interface options, and the Discord bot

Queue items are processed one at a time. A batch is marked completed if at least one episode succeeds, even when others fail; inspect its errors before treating it as fully downloaded. Retry is available for failed/cancelled batches, so failed episodes inside a completed batch must be submitted again. Clearing finished entries also removes failed and cancelled records.

Normal cancellation waits for the current episode. Force cancellation can interrupt the active FFmpeg process; direct HTTP, parallel HLS, and manga downloads may continue until their current operation finishes.

For AniWorld and SerienStream, episode labels use an explicit number from the English title when available, with the seasonal index as fallback. Selecting an episode submits its original source URL. See episode numbering for supported markers, existing files and numbering conflicts.

The Library view scans title folders for video files and episode markers. Display, grouping and deletion use the numbers in the filenames, including S01E01, S01E001 and S01E1100. A file retained at its seasonal path keeps that filename and its Library label; the download dialog can display the English-title number for the same episode. Temporary download and remux outputs are excluded from episode and movie lists. Loose videos at the download root are not listed, and manga images/CBZ/EPUB files do not have a reader or chapter listing. Naming patterns without recognized episode markers can make a series appear as a movie.

With language separation enabled, Library locations include only the four German/English dub/sub folders. Hanime downloads use a japanese folder, which is currently omitted from that view.

For manga output formats and page selection, see manga usage.

Manga page download markers check loose image files only. Pages stored in CBZ/EPUB archives can appear undownloaded even though repeating the archive download reuses their valid images.

Custom download paths ​

Admins can add named folders in Settings > Custom Paths. A path can also be the default for selected sites. The process must be able to write there or create the folder beneath a writable parent. Saving a custom path does not check filesystem permissions.

Open it on your network ​

bash
aniworld -w --web-expose

This binds to 0.0.0.0. Other devices can connect through the computer's local IP and port 8080.

Add authentication

Do not expose an unauthenticated Web UI to the internet. Use local auth or OIDC behind HTTPS.

Local accounts ​

bash
aniworld -w --web-expose --web-auth

If no admin exists, the first visit asks you to create one. Admins can add users and assign roles from Settings. Setup and local account forms require passwords of at least eight characters. Failed local logins are limited to five per username or ten per client IP within fifteen minutes; a blocked attempt returns 429 with Retry-After. These counters reset when the server restarts.

For unattended setup, define both values before the first start:

dotenv
ANIWORLD_WEB_ADMIN_USER=admin
ANIWORLD_WEB_ADMIN_PASS=replace-this-password

OIDC SSO ​

Install the optional dependency, set the OIDC values, then enable SSO:

bash
python -m pip install "aniworld[sso]"
aniworld -w --web-auth --web-sso

Use --web-force-sso for SSO-only login. SSO alone does not enable login protection; keep --web-auth when offering both methods. The required environment variables and admin-bootstrap behavior are listed under Web authentication.

Captchas ​

When a running queue item needs a captcha, click its CAPTCHA action to open the browser screenshot. Click the image to interact with the challenge, including widgets inside iframes. Click positions are scaled to the browser screenshot's size. The viewer closes when the attempt finishes, including on timeout or failure. Checkbox challenges are tried automatically by default, while image challenges need your input.

Set ANIWORLD_CAPTCHA_MANUAL=1 to handle widgets yourself. The browser stays off-screen in the normal Web UI flow, and screenshots remain available even with ANIWORLD_CAPTCHA_VISIBLE=0. See CAPTCHA configuration for visibility, timeout and debug logging options.

Kinox may require opening the title page and solving its challenge manually before retrying.

Settings and persistence ​

Most general settings changed in the Web UI last until the process restarts. Put values in the app directory's .env (~/.aniworld/.env by default) when they must survive restarts. Custom paths, users, API keys, queue data, and Auto-Sync exclusions are stored in the Web UI database. Themes and Discord bot settings also persist. See Configuration for the distinction and the settings export option.

Automation and integrations ​

Browse rows for recently added titles provide discovery lists. Auto-Sync follows titles present in the download library.

Sites and languages ​

Enable or disable site tabs in Settings. Disabled-by-default sources and their capabilities are listed under Supported Sites. The download dialog normally restricts languages using the first episode's provider data. Enable Always offer every language (ANIWORLD_SHOW_ALL_LANGUAGES=1) when later episodes offer another language, then reload Home to apply that choice to the page. This keeps all presets for the selected site available, subject to the English Sub restriction; it does not add a missing stream or switch languages automatically. HentaiTV/HentaiHaven retain their fixed preset.

Genre browsing is available for AniWorld, SerienStream, BurningSeries, MegaKino, Kinox, FilmPalast, Filmo, Hanime, MangaFire, and Moflix. Genre names come from each site's current listing. Additional filters such as production years and sorting remain available through Python search functions.

Hanime (hanime.tv) has a Web UI tab with keyword search and genre browsing. It is disabled by default; enable it in Settings or with ANIWORLD_ENABLE_HTV=1. HentaiTV (hentai.tv) and HentaiHaven (hentaihaven.xxx) also have optional keyword-search and download tabs: set ANIWORLD_ENABLE_HENTAITV=1 or ANIWORLD_ENABLE_HENTAIHAVEN=1. Their UI uses a fixed English Sub preset and the matching site provider; they have no genre listing or homepage browse rows. Subtitle availability still depends on the stream. AnimeIDHentai remains CLI/Python only.

AniWorld Downloader is open source.