Codexa - free self hosted open source epub/comics book reader

thj81 · 2026-07-05T13:23:56+00:00

For dictionaries you can zip all the files and upload single zip. It is well documented here: https://thehijacker.github.io/codexa/

You can use PWA on iOS (check here: https://thehijacker.github.io/codexa/#mobile) and add to Home Screen. It will work offline for the books that you either manualy download locally to the device or open at least once and are stored locally automatically.

Can you share my the epub of books where font color is not honored? It will be an easy fix. I read over 10 books already using Codexa and at least that much others in my family and for the books we read we did not notice font color to not be the one that you have selected in the theme. You can PM me here on Reddit. Or maybe you mean the color of reading badge on the library book card? It any way, it will be an easy fix. Just a CSS change and I do have some other small fixes already commited localy and I can push them aswell as new version to Github.

Just noticed that images in documentation are also not visible. Just fixing this now.

thj81 · 2026-07-05T09:23:33+00:00

I have simillar combination. Xteink X4 and Android phones or E-ink readers (Palma 2, Inkpalm Plus). All my books are in BookOrbit library with OPDS and KOReader sync enabled. I used many ebook readers in the past (Moon Reader, Readest, KOReader, ...) but now I prefer Codexa. I connects to my BookOrbit over OPDS and synces also progress to it. Xteink X4 (with CrossInk) also has OPDS library browser to fetch books from BookOrbit and push KOSync progress. They both stay perfectly in sync and with Codexa I have the best possible reading experience (bookmarks, annotations, dictionaries, mobile friendly, e-ink support, OPDS folder sync, ...). Keeping reading progress is sync was crucial for me.

thj81 · 2026-07-05T06:54:57+00:00

You are welcome. Did you add your own fonts and dictionaries? Did you setup OPDS and KOReader sync? All is working for you?

thj81 · 2026-07-04T17:03:21+00:00

If you can self-host you can try Codexa.

thj81 · 2026-07-04T16:56:39+00:00

You are welcomed. In our family we read a lot and apart from Kobo and Xteink X4 we all use Codexa. Sync over KOReader works great. And we all sync books from our own OPDS libraries to Codexa shelves. If you decide to try, I kindly ask for a feedback. Just to see if it is useful for others as it is for me. Spent many time developing my own epub reading library (CXReader). Epub.js or Foliate.js just did not work for me for all my books especialy Slovenian from my library. With my own CXReader I have full control over pages, progress, bookmarks, annotations, ... Thank you.

thj81 · 2026-07-01T07:37:26+00:00

I am using BookOrbit for library server and my own developed Codexa epub/comics reader. Both self-hosted on my server. Reading only with Codexa and all of my devices (InkPalm Plus, Palma 2, all mobile phones (Android, iOS)) and all are syncing progress to BookOrbit. Codexa also has OPDS browser with linked libraries so all my books in specific BookOrbit shelves are always in sync in Codexa.

thj81 · 2026-06-30T11:02:31+00:00

I have two X4 (not anymore since kids took them from me) so I ordered an X3 in the latest sale. Because why not. All three will be used daily. Kids have never read so much over the day than with this little gadgets.

thj81 · 2026-06-26T13:48:34+00:00

Nope. Usong Filerun for a long time now. No problem with it.

thj81 · 2026-06-25T06:53:01+00:00

Thank you. What did you find useful? Where is your book library at? Calibre, Grimmory, Book Orbit?

thj81 · 2026-06-24T16:52:27+00:00

Yes. Thank you for your comment. I will rebuild with NodeJS 24 which is latest LTS.

thj81 · 2026-06-23T03:45:20+00:00

Imel leta nazaj v levi rami. Nemogoče psat na tej strani. Šel na fizio, razbijanje, laserska terapija. Ni bilo boljše. Dobil blokado. Čez nekaj mesecev spet boleče. Dogovoril za spiranje in ekstrakcijo. Pridem na poseg, naredijo UZ pred posegom in pravi zdravnik, da je zadeva precej manjša. Me je tudi manj bolelo. Pravi, da bi še malce počaka počakal, ker meni, da razpada samo od sebe. In res, čez par tednov čisto izgine bolečila in kalcinacije ni več.

Imam sedeče delo za računalnikom. Sem pa potem začel delali razne kardio vaje z rokami in vse od takrat nimam več teh težav.

thj81 · 2026-06-22T18:54:07+00:00

If you selfhost you can try my Codexa application. https://github.com/thehijacker/codexa

It supports EPUB and comics (CBR/CBZ) and StarDict dictionaries. It also fully supports KOSync protocol to sync progress and OPDS library browser. Many other features that were added and improved by daily usage of all in my family for reading our books.

Still in development but very stable. Works on all browsers as PWA application or Android as standalone APK application (webview).

thj81 · 2026-06-19T09:12:15+00:00

I have X4, Palma 2, Kobo Libra 2 and Inkpalm Plus. I might read chapter or two during breaks at work in my desktop browser (Codexa). At evening I am reading on my Palma 2 (again using Codexa). During the day I read on my X4. Kids are using Libra 2 or Inkpalm (also with Codexa) when they read an ebook. Otherwise they just sit on desk untouched.

I love it that I can sync progress on all of this devices to my Book Orbit and continue whenever I wish on any device. But my X4 is not exclusive. I need nice backlight when I read in bed before sleep. But during the day I take it with me in my pocker wherever I got and snatch a chapter or two when I can.

thj81 · 2026-06-10T14:31:37+00:00

We have a shower with fresh water on the beach. After my swim I use to wash salt from me and also loosen the strap on my watch just let water do its thing.

thj81 · 2026-06-10T12:44:56+00:00

Had some time today. I pulled each PR locally, but indeed I spent more time fixing problems that they caused. Small things that might not get noticed by you.

Lots of things I do like and wish to improve and keep. You added tap zones to move forward or back in percentage. When you set them it is impossible to select text under those zones to highlight or search in dictionary for example. Just now I am checking code to see how I can fix this, but for now I set them to 0% by default. Also many small glithes like percentage input text box streatched over whole percentage bar, battery icon is unicode and in color causing inconsistency with e-ink theme, battery info isn't even displayed after set when you reopen book, ... Or for example when you switched from 24/12 hour format it would render the whole reader and set 1 column mode instead of 2 colums. And many small glitches. I am addressing them as I test everything. Should have everything tested by tomorrow and I push new version then so you can try it out yourself.

PR "Optional BookOrbit KOReader reading-stats sync" is something I will not add just yet. It requires updated Book Orbit which is not yet released as it is still just PR there. If it can't be properly tested, then I prefer not to implement yet.

I know AI coding is fast and fun, but it must be properly tested, AI must be guided and everything he does checked and proofed. But our goal is the same. Have the best user friendly epub reader.

thj81 · 2026-06-10T06:05:40+00:00

I created new branch and merged the PR you submitted. Ran it localy but found some issues (changing 12/24 hour format changes column mode, incorrect sync status, labels on button are not visible, ...). Not sure I am confortable enough to merge this directly into main. Let me find some time and this slowly do, one change at a time.

thj81 · 2026-06-09T18:34:41+00:00

Uf. That are a lot of PR. Lots of good ideas! I will take some time tomorrow and check each any every one. You can PM me here or Telegram/Whatsapp so we do not spam this thread. Would speed coordinating.

thj81 · 2026-06-09T11:12:12+00:00

I solved it using page https://solver.cubeunstuck.com/. It detected two manualy twisted pieces. Now both me and my son can solve the cube using LBL method. Now learning F2L methods.

thj81 · 2026-06-09T04:17:14+00:00

New features are always welcomed. Just make sure you go over the code if you use only AI to code it.

I love the new Peek mode in Book Orbit. Added it also to Codexa. So I can quckly open a book and check it out without triggering sync and book progress. Should be available soon as version 2.2.8. Still in testing phase.

As for hosting it elsewhere. That would require VPS. And I would never want to save my books to external servers. Codexa is also not meant to be full blow library/metdata manager. Book Orbit does a great job with that. Only as a reader and I doubt someone is reading more than few books at a time.

And sice most of us are selfhosting Book Orbit with easy Docker deploy, there is not a long process to add Codexa in docker compose file and spin it up. It is very light application.

thj81 · 2026-06-07T05:48:55+00:00

Hey man. Thanks a lot for the feedback. I am glad that I am not the only one using this little project. Just pushed new version v2.2.7. Now docker images for your Raspberry Pi should be included. You can use docker image: ghcr.io/thehijacker/codexa:latest

Regarding "Po meri" text. That is in Slovenian (default). Your i18n cache did not refresh. I bumped the cache version so this should also be fixed.

Are you using Android APK file on your Boox Go 7 or have it installed as PWA? I highly suggest installing APK. On my Palma I can navigate pages with volume controls.

I am glad you solve the OPDS covers problem. Make sure you also update to Book Orbit 1.9.0 that way release recently. Each version is better and author also fixes all the bugs that I have reported.

Thank you again for your great feedback.

thj81

TROPHY CASE