If you run Komga at home, your whole library already lives on your own server — but reading it on your phone usually means either a browser tab or an app that shows you a bare list of filenames with no covers.
Shiori connects to Komga directly. Done the right way, you get your covers, your authors, your series structure, and your reading position synced back to the server. This guide shows the exact steps, and — more importantly — which of Shiori's three Komga options you should actually pick.
Komga, OPDS, or Komga API? Pick the right one first
When you add a server, Shiori offers several quick-fill options, and three of them mention Komga. They are not equivalent:
| Option | Protocol | Features |
|---|---|---|
| Komga | OPDS v1 | Browsing & downloading only |
| Komga v2 | OPDS v2 | Browsing & downloading only |
| Komga API ⭐ | Native REST API | Covers, full book details & reading-progress sync |
OPDS is a generic catalog standard, so it works with almost any server — Calibre, Calibre-Web, Standard Ebooks, Project Gutenberg. That generality is also its limit: it carries just enough information to list and download a file.
Komga's own API knows about series, metadata and read progress, so Shiori can show you a real library instead of a file list, and tell Komga where you stopped reading.
Use "Komga API" unless you have a specific reason not to.
What you need
- Komga running and reachable on your network
- Your Komga username and password (or an API key, if you prefer)
- Your server's LAN address — not
localhost - Shiori installed on your Android device
localhost?localhost means this device. Typed into your phone, it points at the phone, not at your server. You need the address your server has on your network — something like 192.168.1.33.
หากคุณรัน Komga ไว้ที่บ้าน คลังหนังสือทั้งหมดของคุณจะอยู่บนเซิร์ฟเวอร์ส่วนตัวอยู่แล้ว — แต่การอ่านบนโทรศัพท์มักจะต้องเปิดผ่านเว็บเบราว์เซอร์หรือแอปที่แสดงเพียงรายชื่อไฟล์เปล่าๆ โดยไม่มีภาพปก
Shiori สามารถเชื่อมต่อกับ Komga ได้โดยตรง หากตั้งค่าอย่างถูกต้อง คุณจะได้ทั้งภาพปก รายชื่อผู้แต่ง โครงสร้างซีรีส์ และตำแหน่งการอ่านที่ซิงค์กลับไปยังเซิร์ฟเวอร์ คู่มือนี้จะแนะนำขั้นตอนอย่างละเอียด และที่สำคัญที่สุดคือ ควรเลือกตัวเลือก Komga ตัวไหนจากทั้งหมด 3 ตัวเลือกใน Shiori
Komga, OPDS หรือ Komga API? เลือกตัวเลือกที่ถูกต้องก่อนเป็นอันดับแรก
เมื่อคุณเพิ่มเซิร์ฟเวอร์ Shiori จะมีตัวเลือกเติมข้อมูลด่วนให้เลือกหลายแบบ ซึ่งในนั้นมี 3 ตัวเลือกที่พูดถึง Komga แต่ละตัวเลือกไม่ได้เหมือนกัน:
| ตัวเลือก | โปรโตคอล | ความสามารถ |
|---|---|---|
| Komga | OPDS v1 | สำหรับเรียกดูและดาวน์โหลดเท่านั้น |
| Komga v2 | OPDS v2 | สำหรับเรียกดูและดาวน์โหลดเท่านั้น |
| Komga API ⭐ | REST API หลัก | ภาพปก, ข้อมูลหนังสือครบถ้วน และซิงค์ความคืบหน้าการอ่าน |
OPDS เป็นมาตรฐานแคตตาล็อกทั่วไป จึงใช้งานได้กับเซิร์ฟเวอร์เกือบทุกประเภท ไม่ว่าจะเป็น Calibre, Calibre-Web, Standard Ebooks หรือ Project Gutenberg แต่ความครอบคลุมทั่วไปนี้ก็คือข้อจำกัดเช่นกัน เพราะมันส่งข้อมูลเพียงพอสำหรับการแสดงรายการและดาวน์โหลดไฟล์เท่านั้น
API ของ Komga โดยเฉพาะนั้นเข้าใจเรื่องซีรีส์ ข้อมูลเมทาดาตา และความคืบหน้าการอ่าน Shiori จึงสามารถแสดงคลังหนังสือจริงๆ แทนที่จะเป็นแค่รายการไฟล์ และยังแจ้ง Komga ได้ว่าคุณอ่านค้างไว้ที่ตรงไหน
แนะนำให้เลือก "Komga API" เว้นแต่คุณจะมีเหตุผลเฉพาะเจาะจงในการเลือกตัวเลือกอื่น
สิ่งที่คุณต้องเตรียม
- Komga ที่กำลังทำงานและสามารถเข้าถึงได้บนเครือข่ายของคุณ
- ชื่อผู้ใช้และรหัสผ่าน Komga ของคุณ (หรือ API key หากคุณสะดวกใช้มากกว่า)
- ที่อยู่ LAN ของเซิร์ฟเวอร์ — ไม่ใช่
localhost - แอป Shiori ที่ติดตั้งอยู่บนอุปกรณ์ Android ของคุณ
localhost?localhost หมายถึง อุปกรณ์เครื่องนี้ หากพิมพ์ลงในโทรศัพท์ จะเป็นการชี้กลับมาที่ตัวโทรศัพท์เอง ไม่ใช่เซิร์ฟเวอร์ของคุณ คุณต้องใช้ที่อยู่ IP ที่เซิร์ฟเวอร์ได้รับในเครือข่ายของคุณ เช่น 192.168.1.33
自宅で Komga を運用していれば、ライブラリ全体がすでに自分のサーバー上に構築されているはずです。しかし、スマートフォンで読むとなると、ブラウザのタブを開くか、表紙も表示されない単純なファイル名のリストを表示するアプリを使うことになりがちです。
ShioriはKomgaに直接接続できます。正しく設定すれば、表紙、著者名、シリーズ構造、そして読書の進捗状況までサーバーと同期できます。この記事では、具体的な手順と、Shioriで提供されている3つのKomgaオプションのうちどれを選ぶべきかについて詳しく解説します。
Komga、OPDS、それとも Komga API？ まずは正しい接続方法を選ぼう
サーバーを追加する際、Shioriはいくつかの自動入力オプション（クイックフィル）を提供しており、そのうち3つにKomgaの名前が含まれています。これらは機能が異なります：
| 選択肢 | 通信プロトコル | 対応機能 |
|---|---|---|
| Komga | OPDS v1 | 閲覧とダウンロードのみ |
| Komga v2 | OPDS v2 | 閲覧とダウンロードのみ |
| Komga API ⭐ | ネイティブ REST API | 表紙、詳細な本情報、読書進捗の同期 |
OPDSは汎用的なカタログ規格であるため、Calibre、Calibre-Web、Standard Ebooks、Project Gutenbergなど、ほぼすべてのサーバーで動作します。しかし、その汎用性の高さゆえに限界もあり、ファイルをリスト表示してダウンロードするための最小限の情報しか保持できません。
一方、Komga独自のAPIはシリーズ、メタデータ、読書進捗を識別できるため、Shioriはファイル一覧ではなく本物のライブラリを表示でき、どこまで読んだかをKomgaに伝えることができます。
特別な理由がない限り、「Komga API」を使用してください。
必要なもの
- ネットワーク上で稼働しており、アクセス可能なKomgaサーバー
- Komgaのユーザー名とパスワード（またはAPIキー）
- サーバーのLANアドレス（
localhostではないもの） - Androidデバイスにインストールされた Shiori
localhost ではダメなのか？localhost は「このデバイス自身」を意味します。スマホでこれを入力すると、サーバーではなくスマホ自身を指してしまいます。ネットワーク上でのサーバーのアドレス（例: 192.168.1.33）を入力する必要があります。
如果你在家运行 Komga，你的整个书库就已经托管在自己的服务器上了——但在手机上阅读通常意味着要使用浏览器标签页，或者使用只能显示无封面文件名列表的软件。
Shiori 可以直接连接至 Komga。采用正确的设置方式，你可以获得封面、作者信息、系列结构，并将阅读进度实时同步回服务器。本指南将展示具体的设置步骤，更重要的是——告诉你应该在 Shiori 提供的三种 Komga 选项中选择哪一个。
Komga、OPDS 还是 Komga API？首先选择正确的选项
添加服务器时，Shiori 会提供几个快捷填充选项，其中有三个涉及 Komga。它们并不相同：
| 选项 | 协议类型 | 支持功能 |
|---|---|---|
| Komga | OPDS v1 | 仅支持浏览与下载 |
| Komga v2 | OPDS v2 | 仅支持浏览与下载 |
| Komga API ⭐ | 原生 REST API | 封面、完整图书详情与阅读进度同步 |
OPDS 是一种通用的目录标准，因此它几乎兼容所有服务器——Calibre、Calibre-Web、Standard Ebooks、Project Gutenberg 等。但通用性也是它的局限所在：它包含的信息仅够列出和下载文件。
而 Komga 的原生 API 了解系列、元数据和阅读进度，因此 Shiori 可以为你展示一个真正的书库，而不是单纯的文件列表，并能将你的阅读进度反馈给 Komga。
除非你有特定原因，否则请始终使用 "Komga API"。
准备工作
- Komga 正在运行且可以在你的网络中访问
- 你的 Komga 用户名和密码（或者你更倾向使用的 API 密钥）
- 服务器的局域网地址（LAN 地址）——而不是
localhost - 在 Android 设备上安装好 Shiori
localhost？localhost 代表“本机”。如果在手机上输入它，它指向的是手机本身，而不是你的服务器。你需要的是服务器在局域网中的 IP 地址——例如 192.168.1.33。
Se você executa o Komga em casa, toda a sua biblioteca já fica no seu próprio servidor — mas lê-la no seu celular geralmente significa usar uma aba do navegador ou um aplicativo que mostra apenas uma lista simples de nomes de arquivos sem capas.
O Shiori se conecta ao Komga diretamente. Feito da maneira certa, você obtém suas capas, seus autores, a estrutura das suas séries e sua posição de leitura sincronizada de volta ao servidor. Este guia mostra os passos exatos e — mais importante — qual das três opções do Komga no Shiori você realmente deve escolher.
Komga, OPDS ou Komga API? Escolha a opção certa primeiro
Quando você adiciona um servidor, o Shiori oferece várias opções de preenchimento rápido, e três delas mencionam o Komga. Elas não são equivalentes:
| Opção | Protocolo | Recursos |
|---|---|---|
| Komga | OPDS v1 | Apenas navegação e download |
| Komga v2 | OPDS v2 | Apenas navegação e download |
| Komga API ⭐ | REST API Nativa | Capas, detalhes completos do livro e sincronização do progresso |
O OPDS é um padrão de catálogo genérico, por isso funciona com quase qualquer servidor — Calibre, Calibre-Web, Standard Ebooks, Project Gutenberg. Essa generalidade também é o seu limite: ele carrega apenas informações suficientes para listar e baixar um arquivo.
A própria API do Komga conhece séries, metadados e progresso de leitura, permitindo que o Shiori mostre uma biblioteca de verdade em vez de uma lista de arquivos, e informe ao Komga onde você parou de ler.
Use "Komga API" a menos que você tenha um motivo específico para não usar.
O que você precisa
- O Komga em execução e acessível na sua rede
- Seu nome de usuário e senha do Komga (ou uma chave de API, se preferir)
- O endereço de rede local (LAN) do seu servidor — não
localhost - O Shiori instalado no seu dispositivo Android
localhost?localhost significa este dispositivo. Digitado no seu celular, ele aponta para o próprio celular, não para o seu servidor. Você precisa do endereço que seu servidor possui na sua rede — algo como 192.168.1.33.
Si tienes Komga en casa, toda tu biblioteca ya vive en tu propio servidor; sin embargo, leerla en el teléfono suele significar abrir una pestaña del navegador o usar una aplicación que solo muestra una lista básica de nombres de archivo sin portadas.
Shiori se conecta directamente a Komga. Si lo configuras de la forma correcta, obtendrás tus portadas, autores, la estructura de las series y la sincronización de tu posición de lectura con el servidor. Esta guía muestra los pasos exactos y, lo que es más importante, cuál de las tres opciones de Komga que ofrece Shiori deberías elegir.
¿Komga, OPDS o Komga API? Elige primero la opción correcta
Al añadir un servidor, Shiori ofrece varias opciones de autocompletado, y tres de ellas mencionan a Komga. No son equivalentes:
| Opción | Protocolo | Características |
|---|---|---|
| Komga | OPDS v1 | Solo navegación y descargas |
| Komga v2 | OPDS v2 | Solo navegación y descargas |
| Komga API ⭐ | REST API Nativa | Portadas, detalles completos de libros y sincronización de lectura |
OPDS es un estándar genérico de catálogos, por lo que funciona con casi cualquier servidor: Calibre, Calibre-Web, Standard Ebooks o Project Gutenberg. Esa universalidad es también su límite: solo transporta la información justa para listar y descargar un archivo.
La propia API de Komga gestiona series, metadatos y progreso de lectura, permitiendo que Shiori te muestre una biblioteca real en lugar de una lista de archivos y le comunique a Komga dónde dejaste de leer.
Utiliza «Komga API» a menos que tengas un motivo concreto para no hacerlo.
Lo que necesitas
- Komga en funcionamiento y accesible en tu red
- Tu nombre de usuario y contraseña de Komga (o una clave API, si lo prefieres)
- La dirección LAN de tu servidor (no
localhost) - Shiori instalado en tu dispositivo Android
localhost?localhost significa este dispositivo. Si lo escribes en tu teléfono, apuntará al propio teléfono, no a tu servidor. Necesitas la dirección que tiene tu servidor en tu red local, como por ejemplo 192.168.1.33.
