Release 1.23.2

This release enabled WAL mode by default for the SQLite databases.

Changelog

🐛 Fixes

kobo

• NullPointer exception (138c0ed), closes #2045

webui

• ignore content negotiation when downloading page (85a33d4), closes #2042

unscoped

• ignore xml namespace in EPUB opf file (3ab21ff), closes #2043

🏎 Perf

• enable SQLite WAL mode by default (e7b56b2)

🔄️ Changes

api

• mark kepubifyPath as deprecated (d147586)

unscoped

• use Jsoup XmlParser instead of HTML parser where needed (4e7c49d)

🛠 Build

deps

• move redundant versions to gradle version catalog (18ec31f)

📝 Documentation

• update sponsors (0bcf1e4)

🌐 Translation

komga-tray

• translated using Weblate (Slovak) (4a598e3)
• translated using Weblate (Assamese) (9ce6258)
• added translation using Weblate (Slovak) (c6a424e)
• translated using Weblate (Ukrainian) (45a105a)

webui

• translated using Weblate (Slovak) (9a6f664)
• translated using Weblate (Ukrainian) (ed271fc)

⚙️ Dependencies

ci

• bump actions/checkout from 4 to 5 (ea5a470)
• bump hydraulic-software/conveyor from 18.1 to 19.0 (a333b75)

webui

• bump brace-expansion from 1.1.11 to 1.1.12 in /komga-webui (777acbb)
• bump ws in /komga-webui (30f6d3a)

unscoped

• bump jsoup to 1.21.1 (8b62988)
• bump nightcompress from 1.1.0 to 1.1.1 (eb8a2df)
• bump ktlint from 1.6.0 to 1.7.1 (54c818e)

Contributors

We'd like to thank the following people for their contributions:
Gauthier, Gauthier Roebroeck, Itsmechinmoy, fantastron27, peter cerny, Максим Горпиніч

Release 1.23.1

Changelog

🐛 Fixes

api

• reduce cache for announcements and releases to 1h (e019f5d)

🏎 Perf

• separate database reads from writes (f9d9139)
• use sqlite temporary tables for long parameter list (7464e64)

🔄️ Changes

benchmark

• replace deprecated methods (9046a61)

unscoped

• ktlint format (9986f9d)
• move lucene commit to separate class (243355f)
• replace deprecated property (cfa3995)

🧪 Tests

• use synchronous lucene committer for tests (0e52bde)
• use synchronous events for tests (a80eb59)

🛠 Build

docker

• downgrade base image from ubuntu:25.04 to ubuntu:24.10 for arm64/arm64 (ffd2d0c), closes #2021

webui

• update Browserslist db (8c4fb26)

⚙️ Dependencies

komga

• bump spring boot to 3.5.4 (d8d2029)
• bump bestbefore-processor-kotlin to 0.2.0 (5af98a5)
• bump spring-session-caffeine to 2.1.0 (0a0bd96)

webui

• bump on-headers and compression in /komga-webui (cd98fed)

Contributors

We'd like to thank the following people for their contributions:
Gauthier, Gauthier Roebroeck

Release 1.23.0

This release introduces a configuration check at startup to ensure the SQLite databases are located on a local filesystem. If database files are detected to be on a remote filesystem (CIFS or NFS), the application will stop.

Changelog

🚀 Features

• check if database files are on local filesystem on startup (93b2130)

🐛 Fixes

• ensure tasksDB parent directory is created (eb1e602)

🔄️ Changes

• ktlint format (756d9f9)
• use guard condition in when (83a995f)
• remove redundant qualifier (d82af1b)
• rename unused exceptions (5ba13d0)
• simplify condition (b84a958)
• simplify regex string (c955f2d)
• remove explicit type (65c8575)
• replace enum.values() with enum.entries (03993ac)
• remove unused code (b7d1824)
• fix warning on startup (209792f)

🛠 Build

• add os name to junit test report (ba83452)
• publish junit test report (8952b83)

🌐 Translation

webui

• translated using Weblate (Turkish) (dc1248e)

Contributors

We'd like to thank the following people for their contributions:
Gauthier, Gauthier Roebroeck, Serhat Gülaştı

Release 1.22.1

Changelog

🐛 Fixes

• don't strip accents on input data and sort series title with unicode collation (c2c697f)
• epub divina heuristic (5f9cc44), closes #1997

🔄️ Changes

komga

• remove artemis cleanup (9567df1)

komga-tray

• remove deprecated methods (d56c3e3)

unscoped

• use interpolation prefix (1de36b7)
• add param target for some annotations to fix archunit tests (1975ff2)
• fix types for new Kotlin compiler (34c7d8b)
• replace deprecated AntPathRequestMatcher with PathPatternRequestMatcher (f674d65)
• remove unused params (d4de08a)
• use new syntax for gradle task registation (d112e69)

🛠 Build

docker

• bump base image from ubuntu:24.10 to ubuntu:25.04 for amr64/arm64 (6f951bd)

komga

• align jooq version for jooq plugin (5f00bd5)
• add kotlin compiler parameter to remove warnings (ce7816b)

webui

• update Browserslist db (ddc5f72)

unscoped

• update ktlint gradle plugin configuration (eacf305)
• update build.gradle for newer Kotlin (f2841ea)
• use Java 21 (71e8e9a)
• add enable native access attribute to jar manifest (8602740)

📝 Documentation

• minimum Java version is 21 (388349d)

🌐 Translation

komga-tray

• translated using Weblate (Ukrainian) (c960e45)

webui

• translated using Weblate (Dutch) (239be60)
• translated using Weblate (Ukrainian) (7873671)
• translated using Weblate (Tamil) (da2bf7d)

⚙️ Dependencies

build

• update Gradle to 8.14.3 (267292d)
• bump JReleaser from 1.10.0 to 1.19.0 (4189833)
• bump Gradle from 8.11.1 to 8.14.2 (a980009)

komga

• bump deps (48207cb)
• bump ksp plugin (4b9a146)
• bump deps (c898906)
• bump Gradle plugins (e7a0a52)
• bump Spring Boot to 3.5.3 (9ac225b)
• bump icu4j from 76.1 to 77.1 (39bc3b2)

komga-tray

• bump Gradle plugins (0f74e6e)

unscoped

• bump ben-manes version plugin to 0.52.0 (cd99019)
• bump ktlint to 1.6.0 (9bc3794)
• bump Kotlin to 2.2.0 (aa80ef8)
• bump ktlint plugin to 13.0.0 (1235220)

Contributors

We'd like to thank the following people for their contributions:
Anatolii, Ben, Gauthier, Gauthier Roebroeck, தமிழ்நேரம்

Release 1.22.0

Changelog

🚀 Features

api

• user creation supports restrictions (1f0817b)

🐛 Fixes

api

• add CSP response header for untrusted epub resources (25de597)
• marking already read announcement as read would return error 500 (8cf2403)

🛠 Build

release

• remove unused announce step (2911348)

webui

• update Browserslist db (bc8a5df)

📝 Documentation

api

• add /actuator/info in OpenAPI specification (1ab46a7)
• document remember-me parameter on Retrieve Current User API (cc78cd3)

openapi

• rename Claim Server tag to avoid conflict with operation name (a17ff43)

🌐 Translation

komga-tray

• translated using Weblate (Assamese) (56e7cff)
• translated using Weblate (Indonesian) (4082451)
• translated using Weblate (Bulgarian) (fb7f144)

webui

• translated using Weblate (Chinese (Simplified Han script)) (aad3e4a)
• translated using Weblate (Chinese (Traditional Han script)) (b228f0e)
• translated using Weblate (Korean) (324262f)
• translated using Weblate (Finnish) (0423f82)
• translated using Weblate (French) (d77d9cb)
• translated using Weblate (Spanish) (80e7cfb)
• translated using Weblate (Dutch) (b762fe0)
• translated using Weblate (Indonesian) (f00ec95)
• translated using Weblate (Italian) (d8a374a)
• translated using Weblate (Hungarian) (299ef6c)
• translated using Weblate (Portuguese) (009bc6e)
• translated using Weblate (Japanese) (1197ecf)
• translated using Weblate (German) (6629741)
• translated using Weblate (Turkish) (b570169)

⚙️ Dependencies

ci

• bump hydraulic-software/conveyor from 18.0 to 18.1 (e2a0b94)

Contributors

We'd like to thank the following people for their contributions:
1024mb, Arief Hidayat, Ben, Dániel Vadon, Gauthier, Gauthier Roebroeck, Gino Cicatiello, Horus68, Itsmechinmoy, Ivan, M, Rafael M, Serhat, Smayzy, YongJin Yoon, devchung, dwong33, jonoafi, nazo6, plum7x, なお, 無情天

Release 1.21.3

Changelog

🐛 Fixes

webui

• add missing characters for Japanese series grouping (0a2c3ac), closes #1959
• webtoon page margin is not restored (80fa75a), closes #1944

unscoped

• epubs would have a "null" comment in the Media (343add1)

🔄️ Changes

• remove startup task to fix missing thumbnail metadata (a568a7d)
• rename REST controller operations for better clarity in generated openapi spec (95afb4b)

🛠 Build

conveyor

• update conveyor compatibility to 18 (2120edb)

webui

• update Browserslist db (e0a8edf)
• update Browserslist db (#1926) (9ae39c0), closes #1926

📝 Documentation

api

• better operationId (f03ba84)

⚙️ Dependencies

ci

• bump hydraulic-software/conveyor from 17.0 to 18.0 (ec7d4e3)
• bump peter-evans/dockerhub-description from 4.0.0 to 4.0.2 (08941f0)

webui

• bump http-proxy-middleware in /komga-webui (6c486c0)
• bump @babel/helpers from 7.22.15 to 7.27.0 in /komga-webui (c618047)
• bump @babel/runtime from 7.22.15 to 7.27.0 in /komga-webui (77c8aa5)

Contributors

We'd like to thank the following people for their contributions:
Gauthier, Gauthier Roebroeck, Tatsuhiko Kono

Release 1.21.2

Changelog

⚠️ The Linux Desktop application has been discontinued. If you were using it, you will need to migrate to either the jar or Docker version.

🐛 Fixes

conveyor

• disable Linux builds for desktop app (0d144a6)

opds

• keep reading paging would spill over to on-deck (9be980d)

webui

• import book details does not show format (b7069c2)

unscoped

• replace UriUtils.decode with URLDecode.decode (6553437), closes #1909
• better handling of epub path with anchor on windows (cd6b83d), closes #1909
• more robust process handling for kepubify (48e6eaf)
• don't fail epub analysis when optional features are missing (465467c), closes #1909

🔄️ Changes

conveyor

• remove key added by mistake (1250a97)

🛠 Build

• fix parameterized test (62d193d)
• add corner cases for epub nav (01ef2b0)
• also run tests on windows and macos (d299020)

⚙️ Dependencies

webui

• bump axios from 1.7.4 to 1.8.2 in /komga-webui (#1910) (9454552), closes #1910

Contributors

We'd like to thank the following people for their contributions:
Gauthier Roebroeck

Release 1.21.1

Changelog

🐛 Fixes

api

• book import would return incorrect matched series (10e0bde)

Contributors

We'd like to thank the following people for their contributions:
Gauthier Roebroeck

Release 1.21.0

Changelog

🚀 Features

api

• use unique cookie names (e7335fa), closes #1889
• allow isNull / isNotNull on some search criteria (171cf8c)

webui

• add media status condition in books view filters (9563310)
• add unavailable condition in series and books filters (1b8fa45), closes #1580
• add any/none filtering on more criteria (87d73cc), closes #1884

🐛 Fixes

api

• better matching of series name when importing books with metadata (8b6d23e)
• missing admin permission on global settings endpoint (1fe7a00)

webui

• remove pin/unpin from library action menu (278ae7a), closes #1887
• better handling of dates missing leading zero series filters (400135c)
• better handling of dates missing leading zero in book edit dialogs (a3bf04a)
• better display of edit recommended dialog on mobile (d2aaf40)
• better placement of edit dashboard button on mobile (4d3e6e4)
• libraries ordering does not work on Chrome (e528c7e)

🔄️ Changes

• ktlint (bf3a978)
• rename swagger package to openapi (6b27836)
• remove openapi annotations from OPDS controllers (1638d2b)

🛠 Build

komga-tray

• bump jdk to 23 (ca93ed8)
• update conveyor compatibility to 17 (7f93aae)

webui

• update Browserslist db (23fa56e)

unscoped

• use .svu.yml configuration file (42223b7)
• dispatch events when openapi.json changes (fb9459b)

📝 Documentation

api

• update cookie names (fd8b05f)
• only include servers when generating the openapi reference (66c711e), closes #1890
• add required roles in operation descriptions (f2280b8)
• add missing global security requirements (51c4617)
• add missing default port value for localhost server (707f9a0)
• fix broken link (d475a33)

unscoped

• typo in openApi spec (d6b5bca)

🌐 Translation

webui

• translated using Weblate (Chinese (Simplified Han script)) (fafbe6c)
• translated using Weblate (Korean) (c43f0a3)
• translated using Weblate (Finnish) (b87f78a)
• translated using Weblate (French) (ab65970)
• translated using Weblate (Spanish) (7e436ed)
• translated using Weblate (Italian) (1a5c395)
• translated using Weblate (Hungarian) (5977218)
• translated using Weblate (Croatian) (c1963fe)
• translated using Weblate (Portuguese) (4b2826c)
• translated using Weblate (Czech) (e235ed7)
• translated using Weblate (Japanese) (e5b8254)

⚙️ Dependencies

ci

• bump hydraulic-software/conveyor from 16.0 to 17.0 (40b2508)

Contributors

We'd like to thank the following people for their contributions:
1024mb, Dániel Vadon, Gauthier, Gauthier Roebroeck, Gino Cicatiello, Horus68, Matthieu Sontag, Milo Ivir, Noa Himesaka, Petr Šimek, jonoafi, minahoku, 無情天

Release 1.20.0

Another release full of UI enhancements, and more!

Komga now has a Client Settings API, that can be used to store various settings from Client applications, either globally or per user. This has been put to work to enable new features in the WebUI:

• Global settings
  • Hide login/password fields if OAuth2 is enabled
  • Auto-login with OAuth2 if only a single provider is configured. Note that the pop-up may be blocked by the browser as it is triggered programmatically.
  • Group series by Japanese characters
• Per user settings
  • Blur posters for unread series/books
  • Stretch posters to fill

Other WebUI features include:

• Libraries in the side drawer can now be reordered, and can also be pinned or unpinned. The Libraries view will only show content for pinned libraries.
• The Recommended view can be configured, each section can be enabled or disabled, and sections can be reordered.

The OpenAPI documentation (Swagger) has been cleaned up entirely. It is now properly ordered, and all operations have proper descriptions.

The REST API know supports using API keys for authentication, through a X-API-Key header.

Changelog

🚀 Features

api

• books can be sorted by series title (9bab9f6)
• referential APIs accept multiple library_id for filtering (4de763a)
• add client settings API (3b1504c)
• add support for API keys in REST API via X-API-Key header (64b192c)

webui

• new view to browse all books (406ae4b), closes #1153
• sort books within a series by last modified date or read date (1f852db)
• only shows filter values for pinned libraries (ef01550)
• add ability to configure recommended view per library (e980e33), closes #1539
• add UI setting to group series using japanese characters (6c71e07), closes #1715
• add ability to reorder libraries (a2a689f)
• add ability to pin/unpin libraries (c8e4a46), closes #1560
• add user setting to blur unread posters (4892945), closes #1549
• add UI setting to stretch poster to fit card (c82c8b0), closes #1825
• add UI settings section with OAuth2 options (961832e)

🐛 Fixes

api

• embedded fonts would not load on windows (0546deb), closes #1877
• add missing permissions for history api (d4d3f64)
• oauth2 providers endpoint should only expose get (c1fb307)
• use proper media type for fonts (6fa976f), closes #1849
• incorrect format keyword in generated fonts css (0f05a06), closes #1849

webui

• add missing admin guard for history view (b5928eb)

🔄️ Changes

api

• rework client-settings API validation (7f55fe1)
• add validation on client-settings api (c423d7c)
• rework client-settings API (0b37257)

webui

• dashboard edit button hides the bottom bar on mobile (e1acc58)
• remove unused component references (25dc282)
• remove 3-dots menu for all libraries in main view (f90b415)
• remove unused imports (8c64639)
• use reworked client-settings API (05f73f0)

unscoped

• ktlint format (9511c11)

🛠 Build

• adjust svu options for v3 (6875e6e)
• cleanup openapi reference generation (77c1069)
• enable repository dispatch on release (a70a3b2)

📝 Documentation

api

• move deprecated endpoints to the top (8b66308)
• update openapi description (9dcdb1d)
• add servers and logout endpoint (3273048)
• add Open API documentation for Client Settings API (7fbf9c7)
• add replacement for deprecated APIs (fab59bc)

unscoped

• cleanup openApi documentation (ad8ee86)

🌐 Translation

komga-tray

• translated using Weblate (Hungarian) (b4d97d4)

webui

• translated using Weblate (Chinese (Simplified Han script)) (a88d8a0)
• translated using Weblate (Finnish) (0c7baf9)
• translated using Weblate (Spanish) (c1dcb78)
• translated using Weblate (Italian) (b82fb17)
• translated using Weblate (Hungarian) (85fa17f)
• translated using Weblate (Croatian) (e9a5120)
• translated using Weblate (Portuguese) (cf3fcab)
• translated using Weblate (Czech) (8d9840c)
• translated using Weblate (Japanese) (8a2bce2)
• translated using Weblate (German) (17be53d)

⚙️ Dependencies

webui

• bump serialize-javascript in /komga-webui (4d72ec0)

Contributors

We'd like to thank the following people for their contributions:
1024mb, Deleted User, Dániel Vadon, Gauthier, Gauthier Roebroeck, Gino Cicatiello, Horus68, M, Milo Ivir, Petr Šimek, jonoafi, minahoku, 無情天