Lanraragi Integration

Lanraragi Integration

Connect Tsumihon to your self-hosted Lanraragi instance to search your personal archive and import metadata.

What is Lanraragi?

Lanraragi is a self-hosted web application for managing and reading doujinshi and eromanga archives. Tsumihon can connect to your Lanraragi instance as a search provider, letting you browse your archive and import book metadata directly.

Prerequisites

  • A running Lanraragi instance (v0.8.0 or later recommended).
  • The server URL must be reachable from your device.
  • Your Lanraragi API key (found in Lanraragi settings).

Setup

  1. Open Tsumihon and go to Settings.
  2. Find the Lanraragi configuration section.
  3. Enter your Server URL (e.g., http://192.168.1.100:3000 or https://lanraragi.example.com).
  4. Enter your API Key.
  5. Tap Save and test the connection.

Features

  • Search — Browse and search your Lanraragi library from within Tsumihon.
  • Import metadata — Pull title, tags, and other metadata from Lanraragi into your Tsumihon collection.
  • Preview covers — View cover thumbnails from your archive.

Web Considerations

When using Tsumihon in a browser, your Lanraragi server needs to be reachable from the internet. If your server is on a local network, consider exposing it via HTTPS using a reverse proxy like Caddy or nginx.

Troubleshooting

Connection refused

  • Verify the server URL is correct and includes the port number.
  • Ensure Lanraragi is running and the API is enabled.
  • Check that your device can reach the server (try opening the URL in a browser).

Authentication failed

  • Double-check your API key in Lanraragi settings.
  • Regenerate the API key if needed and update it in Tsumihon.