grimmory-tools/grimmory v3.3.0 on GitHub

3.3.0 (2026-08-06)

This minor release of Grimmory has a large number of bug fixes, features, and refactors to prepare for the performance improvements we're looking to make in the near future. We've made a lot of improvements to our Hardcover and RanobeDB metadata parsers, fixed over twenty outstanding bugs, and have also added Korean and Czech language support.

Changelog

Full Changelog: v3.2.4...v3.3.0

Features

author: derive and store author sort name on save (#1897) (55b9d34)
language: use consistent language normalization across the frontend (#2258) (1d707ff)
metadata: improve RanobeDB search (#1804) (b68e022)
metadata: improve hardcover edition selection (#1800) (fbd1d5e)
ui: app-menu based shelf assignment component (#2058) (daae463)
emit actual koreader device / device ID (#2025) (e978098)

Internationalization

i18n: add support for Korean (ko) and Czech (cs) (#1880) (0d287a0)

Bug Fixes

amazon: parse kindle ebook metadata (#2201) (4d4df8c)
api: avoid missing-cover.jpg when getting book thumbnails (#2256) (1420634)
api: use safer default file naming pattern (#2252) (be2ac14)
api: emit 401 on bad credentials during login (#2130) (3376d33)
api: ensure JWTs always have a unique JWT ID (#2246) (5a6b0e5)
api: handle exceptions with status codes (#2160) (6056f8f)
api: ignore unused tasks to stop warnings (#2213) (38a0c47)
db: add explicit collation for icon map migration (#1944) (0792e0b)
docker: disable heap dumps by default (#2027) (1ff4619)
epub: ignores non-publication dates for published metadata (#2226) (c077551)
epub: remove refines when referenced elements are removed (#2048) (9dd8bcc)
fb2: prioritize explicit cover binary elements (#2230) (106a2eb)
fb2: use base64 decoder aware of newlines (#2229) (027ac6c)
magic-shelf: remove OPDS permission gate (#2144) (f410ecb)
magic-shelf: remove timestamp from magic shelf date checks (#2097) (8edf135)
metadata: require Google Books API key (#1795) (4df5816)
properly flush books during detach (#2085) (f1f86bc)
ranobedb: prioritize English results (#2133) (068d006)
resolve timezone offset in reading session heatmap tooltip (#1870) (2e4f85c)
support getAuthenticatedUser() in OPDS (#2041) (108c5c1)
ui: add missing page titles (#2073) (dbc0ccc)
ui: drop chartjs plugin datalabels (#2021) (15446a8)
ui: prevent ng-deep overrides from hiding upload modal text (#2227) (754637a)
use expected ranobedb rate limit (#2051) (e28b911)

Refactors

api: migrate away from nightcompress (#2103) (134e97f)
books: add /api/v1/books/facets endpoint (#1898) (d2c0836)
books: add /api/v1/books/ids select-all endpoint (#1899) (30d8760)
books: frontend book query service and pagination basics (#2094) (111670e)
books: initial book command service and shared command options (#2168) (cb88558)
books: paginate /api/v1/books/page with cursor, sort, facet, search (#1853) (ef51479)
covers: consolidate cover images into app-cover (#1928) (b4570e3)
epub: use archiveservice instead of epub4j to read archive (#2066) (b67b32a)
ui: autocomplete pagination and infinite scroll (#1965) (0b1fa83)
ui: rebuilt app-menu to angular aria template-based component (#2044) (0b71406)
ui: migrate controls to lucide (#1840) (891f900)
ui: mobile enhancements to UI controls (#1916) (88faeb6)
ui: new page header component and page size foundation (#1966) (a1a6031)
ui: switch library and shelf menu to app-menu (#2057) (0acd8bc)
ui: use app-cover for metadata searcher (#2254) (68f024b)
ui: simplify control transition guard (#2171) (d77a580)

Chores

drop unused demo-user permission (#2045) (f2b64c1)
drop unused jsoup connection factory (#2151) (6417224)
icons: remove bundled svgs and migrate preferences to default library (#1929) (9c59e91)
repo: add just ui dev-unsafe command (#2142) (1b911b0)
ui: drop unused missing-cover.jpg (#2260) (41f6c93)
ui: drop unused secure-src direcctive (#2255) (5898153)
use SERVER_PORT env var for listening port (#2018) (74642c1)
use grimmory.local for fake email domains (#2023) (ef707ab)
use Grimmory branding for basic auth realms (#2049) (a078fd5)
use grimmory in sidecar generatedby (#2024) (2859e4e)
use Grimmory branding for fallback koreader device / device ID (#2026) (bd478ce)
use Grimmory user agent for comicvine / ranobedb / fileservice (#2014) (9e3c503)

Dependencies

deps: bump @analogjs/vite-plugin-angular from 2.6.2 to 2.6.3 in the frontend group (#1985) (7e6e027)
deps: bump @angular/* from 21.2.18 to 21.2.19 (#2240) (7b0dfed)
deps: bump actions/cache/restore from 5.0.5 to 6.1.0 (#1982) (a451984)
deps: bump actions/cache/save from 5.0.5 to 6.1.0 (#1904) (4bd4542)
deps: bump actions/checkout from 6.0.3 to 7.0.0 (#1925) (0e483a2)
deps: bump actions/checkout from 7.0.0 to 7.0.1 (#2208) (349a0c3)
deps: bump actions/setup-java from 5.2.0 to 5.4.0 (#1908) (c94fc1a)
deps: bump actions/setup-java from 5.4.0 to 5.6.0 (#2205) (ccc3746)
deps: bump actions/setup-node from 6.4.0 to 7.0.0 (#2207) (86bf550)
deps: bump azure/setup-helm from 5.0.0 to 5.0.1 (#1906) (efd8280)
deps: bump codeql from 4.36.2 to 4.36.3 (#1922) (9838041)
deps: bump com.github.ben-manes.versions from 0.54.0 to 0.56.0 in /backend in the gradle-dependencies group (#2179) (9d78cba)
deps: bump conventional-changelog-conventionalcommits from 10.2.0 to 10.2.1 in the release-tooling group across 1 directory (#1970) (35959a6)
deps: bump conventional-changelog-conventionalcommits from 9.3.1 to 10.2.0 in the release-tooling group across 1 directory (#1919) (5733d43)
deps: bump docker/build-push-action from 7.2.0 to 7.3.0 (#1926) (4a2aa1f)
deps: bump docker/login-action from 4.2.0 to 4.4.0 (#1981) (82d5313)
deps: bump docker/metadata-action from 6.1.0 to 6.2.0 (#1923) (eb28439)
deps: bump docker/setup-buildx-action from 4.1.0 to 4.2.0 (#1924) (c389c7b)
deps: bump docker/setup-qemu-action from 4.1.0 to 4.2.0 (#1905) (e381ce5)
deps: bump github/codeql-action from 4.36.3 to 4.37.0 (#1980) (01687be)
deps: bump github/codeql-action from 4.37.0 to 4.37.3 (#2206) (a4ba65c)
deps: bump grimmory-epub4j to 1.5.0 (#2163) (a7a8464)
deps: bump semantic-release from 25.0.5 to 25.0.7 in the release-tooling group (#2042) (2cfe5d2)
deps: bump semantic-release from 25.0.7 to 25.0.8 in the release-tooling group (#2089) (9741c6d)
deps: bump taiki-e/install-action from 2.81.11 to 2.82.7 (#1907) (263e54f)
deps: bump taiki-e/install-action from 2.82.7 to 2.83.1 (#1983) (6154d3e)
deps: bump taiki-e/install-action from 2.82.7 to 2.85.4 (#2204) (61e9da7)
deps: bump the frontend group across 1 directory with 10 updates (#2101) (bf093b9)
deps: bump the frontend group across 1 directory with 18 updates (#2043) (d3c0c29)
deps: bump the frontend group with 10 updates (#2181) (51afd6c)
deps: bump the frontend group with 14 updates (#1972) (fa72429)
deps: bump the frontend group with 19 updates (#1921) (d28aea3)
deps: bump the gradle-dependencies group across 1 directory with 4 updates (#1920) (db20fcc)
deps: bump the gradle-dependencies group across 1 directory with 8 updates (#2008) (634e9e2)
deps: bump the gradle-dependencies group in /backend with 3 updates (#2090) (ce79661)
deps: bump the release-tooling group across 1 directory with 2 updates (#2180) (2e04b1a)
deps: drop deprecated angular packages (#2242) (b18c444)
deps: replace tailwindcss-primeui with optimus-ui-tailwindcss (#2175) (8152cd4)
deps: switch PrimeNG to Optimus UI (#2093) (cc8a53b)
deps: update pnpm to 11.18.0 (#2193) (2e60cb4)
fix pnpm peer dependency issues (#2074) (9be80a4)

Documentation

update instructions on bug reports (#2184) (99f21b5)
drop agent instructions (#2053) (840837a)
use actual docker tags instead of fake examples (#2139) (edacce6)

Contributors

We'd like to thank the contributors for this release for taking the time to make Grimmory better.

Including but not limited to: @alexhb1 @ftibi93 @imnotjames @NichaesMol @nightt5879 @pyrox0 @sabrina553 @terminalchai @zachyale @zanivann

New Contributors

@terminalchai made their first contribution in #1795
@NichaesMol made their first contribution in #1804
@nightt5879 made their first contribution in #2027
@pyrox0 made their first contribution in #2075
@zanivann made their first contribution in #1870
@ftibi93 made their first contribution in #2073

grimmory-tools/grimmory v3.3.0 Release v3.3.0 on GitHub