eaglestelle/swaratelle repository overview

⁠Swaratelle

Swaratelle is a self-hosted web interface for managing Iwara downloads through a bundled iwaradl runtime. It provides a browser UI for queueing videos, monitoring active downloads, searching history, and reconciling downloaded files with a SQLite-backed record store.

⁠Features

• Queue Iwara video URLs from a browser UI.
• Track active downloads with progress parsed from iwaradl.
• Deduplicate downloads by Iwara video_id.
• Browse and search completed or failed download history.
• Reconcile history against files on disk.
• Expose a token-protected API for scripts and server-to-server integrations.

⁠Docker

Swaratelle is distributed as eaglestelle/swaratelle:latest.

Create a docker-compose.yml like this:

services:
  swaratelle:
    image: eaglestelle/swaratelle:latest
    container_name: swaratelle
    restart: unless-stopped
    environment:
      SWARATELLE_USERNAME: "root"
      SWARATELLE_PASSWORD: "swaratelle"
      SWARATELLE_API_TOKEN: "replace-this-with-a-long-random-token"
      SWARATELLE_DOWNLOAD_CONCURRENCY: "2"
    volumes:
      - ./data:/data
      - ./media:/media
      - ./scratch:/scratch
    ports:
      - "8842:8842"

Replace SWARATELLE_API_TOKEN with a long random value before starting the container.

Start it:

docker compose up -d

Open:

http://localhost:8842

Stop the service:

docker compose down

The default port mapping is 8842:8842. If host port 8842 is already in use, change only the left side in docker-compose.yml, for example:

ports:
  - "9000:8842"

Then open http://localhost:9000.

⁠Credits

• iwara-dl / iwaradl⁠ by Izumiko: the downloader used by Swaratelle. The Docker image builds it from the upstream v1.5.4 tag.
• Next.js⁠ and React⁠ for the frontend application.
• TanStack Query⁠ for client-side API state.
• Lucide⁠ for interface icons.
• modernc.org/sqlite⁠ for the pure-Go SQLite driver.

Swaratelle is an independent project and is not affiliated with Iwara or the iwaradl maintainers.