Troubleshooting epub files

howardgo · 04-19-2020, 05:26 PM

I buy my books in many different locations and use Calibre to remove the DRM for my own backup purposes and to read them on KOReader. Recently, I have two books that KOReader will not open.

They both appear in the list of books. One looks normal but only has a blank page. Going to the next page brings up the end of book dialog. The other book just shows a message that the epub has an error instead of a book title. Both of these books open in Calibre and on the native Kobo side of my Kobo Aura One.

Does anyone know how I can troubleshoot the issue with these two epubs so I can read them on KOReader?

Frenzie · 04-19-2020, 05:36 PM

There's a program called epubcheck, on Linux you can easily install it. You can also use it online through http://validator.idpf.org/

Besides that there's an EPUB scrambler you can use to share the documents with us. Unfortunately I can't quite recall the right term to find it atm, but I'm sure @NiLuJe will help me out.

NiLuJe · 04-19-2020, 06:36 PM

Yup: https://www.mobileread.com/forums/sh...d.php?t=267998

.

howardgo · 04-19-2020, 07:00 PM

Thanks to both of you! Unfortunately, that still leaves me with a non-working ebook. I ran it through both the epub validator online and also used the Calibre check. No errors were found by either one. The file loads onto my ereader wirelessly, but when I open it, it says there is an error with the epub file. The cover image also doesn't show on the list like the rest of my epubs.

I have attached the scrambled file. I appreciate any help or hints. Thanks!

Frenzie · 04-20-2020, 06:00 AM

Did you test the scrambled document yourself? It seems to open just fine for me.

JSWolf · 04-20-2020, 06:09 AM

Quote:

Originally Posted by Frenzie

There's a program called epubcheck, on Linux you can easily install it. You can also use it online through http://validator.idpf.org/

Besides that there's an EPUB scrambler you can use to share the documents with us. Unfortunately I can't quite recall the right term to find it atm, but I'm sure @NiLuJe will help me out.

Forget the online validator. Use the plugin for Calibre or Sigil to use epubcheck locally.

howardgo · 04-21-2020, 09:20 AM

I installed the ebpub check plugin. It also shows no errors, but the epub can't be read in KOReader and shows an error reader it.

Any ideas?

pazos · 04-21-2020, 09:28 AM

The file you attached works fine.

howardgo · 04-21-2020, 09:47 AM

It seems to be an issue with the latest (April) release of KOReader for Kobo. The same epub file works on my Android phone with the same version of KOReader installed. Anyone know how I report the issue?

JSWolf · 04-21-2020, 11:48 AM

Quote:

Originally Posted by howardgo

It seems to be an issue with the latest (April) release of KOReader for Kobo. The same epub file works on my Android phone with the same version of KOReader installed. Anyone know how I report the issue?

Try the copy I've attached here of your scrambled copy.

pazos · 04-21-2020, 01:21 PM

JSWolf copy works as well as howardgo scrambled copy. Before raising an issue check that by copying both to your device using USB. The original could become corrupted, specially if transferred via calibre wireless device driver.

howardgo · 04-22-2020, 10:19 AM

How can I transfer the file with the USB cable? Where are the ebook files stored in KOReader?

pazos · 04-22-2020, 12:19 PM

Quote:

Originally Posted by howardgo

How can I transfer the file with the USB cable? Where are the ebook files stored in KOReader?

1. Exit KOReader
2. Open calibre on your computer
3. Connect your kobo to your computer via usb
4. Click "ok" or whatever on the popup asking you if you want to share with your computer
5. Wait a couple of seconds until calibre recognizes your device
6. Do the same you did to send your ebooks wirelessly, this time the device is hooked wired.

TL;DR: calibre send books to the top directory exported via USBMS: (/mnt/onboard for kobos). KOReader can store ebooks where the user wants to, but relies on platform defaults (aka: the same as calibre)

pazos · 04-22-2020, 12:21 PM

Once you check that you have no problem with that particular ebook you can try to remove it and send it wireless again. It should work fine. If not please report here or in https://github.com/koreader/koreader/issues

JSWolf · 04-22-2020, 01:02 PM

I've made some changes to the scrambled version I've attached. I removed all unused CSS and cleaned up some of the CSS. So hopefully it will work.

04-19-2020, 05:26 PM	#1
howardgo Member Posts: 11 Karma: 10 Join Date: Apr 2020 Device: Kobo Aura One	Troubleshooting epub files I buy my books in many different locations and use Calibre to remove the DRM for my own backup purposes and to read them on KOReader. Recently, I have two books that KOReader will not open. They both appear in the list of books. One looks normal but only has a blank page. Going to the next page brings up the end of book dialog. The other book just shows a message that the epub has an error instead of a book title. Both of these books open in Calibre and on the native Kobo side of my Kobo Aura One. Does anyone know how I can troubleshoot the issue with these two epubs so I can read them on KOReader?

Similar Threads
Thread	Thread Starter	Forum	Replies	Last Post
Question about metadata in epub files vs opf files	machstem	Calibre	3	06-19-2017 12:43 PM
epub files on kobo have all been changed into shortcut files?	emme278	Kobo Reader	6	11-01-2013 04:32 AM
Epub files diveded into little .xml files	automa	Sigil	15	07-02-2013 10:11 AM
Unwanted epub files once mobi files have been converted.	fletchdt	Conversion	5	03-22-2012 10:18 PM
Txt files - Convert to Epub - Multiple files into one book - noob help	Cernan	Calibre	6	05-18-2010 10:12 AM

04-19-2020, 05:36 PM	#2
Frenzie Wizard Posts: 1,617 Karma: 724945 Join Date: Oct 2014 Location: Antwerp Device: Kobo Aura H2O	There's a program called epubcheck, on Linux you can easily install it. You can also use it online through http://validator.idpf.org/ Besides that there's an EPUB scrambler you can use to share the documents with us. Unfortunately I can't quite recall the right term to find it atm, but I'm sure @NiLuJe will help me out.

04-19-2020, 06:36 PM	#3
NiLuJe BLAM! Posts: 13,477 Karma: 26012494 Join Date: Jun 2010 Location: Paris, France Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E	Yup: https://www.mobileread.com/forums/sh...d.php?t=267998 .

04-20-2020, 06:00 AM	#5
Frenzie Wizard Posts: 1,617 Karma: 724945 Join Date: Oct 2014 Location: Antwerp Device: Kobo Aura H2O	Did you test the scrambled document yourself? It seems to open just fine for me.

04-21-2020, 09:20 AM	#7
howardgo Member Posts: 11 Karma: 10 Join Date: Apr 2020 Device: Kobo Aura One	I installed the ebpub check plugin. It also shows no errors, but the epub can't be read in KOReader and shows an error reader it. Any ideas?

04-21-2020, 09:28 AM	#8
pazos cosiñeiro Posts: 1,271 Karma: 2200049 Join Date: Apr 2014 Device: BQ Cervantes 4	The file you attached works fine.

04-21-2020, 09:47 AM	#9
howardgo Member Posts: 11 Karma: 10 Join Date: Apr 2020 Device: Kobo Aura One	It seems to be an issue with the latest (April) release of KOReader for Kobo. The same epub file works on my Android phone with the same version of KOReader installed. Anyone know how I report the issue?

04-21-2020, 01:21 PM	#11
pazos cosiñeiro Posts: 1,271 Karma: 2200049 Join Date: Apr 2014 Device: BQ Cervantes 4	JSWolf copy works as well as howardgo scrambled copy. Before raising an issue check that by copying both to your device using USB. The original could become corrupted, specially if transferred via calibre wireless device driver.

04-22-2020, 10:19 AM	#12
howardgo Member Posts: 11 Karma: 10 Join Date: Apr 2020 Device: Kobo Aura One	How can I transfer the file with the USB cable? Where are the ebook files stored in KOReader?

04-22-2020, 12:21 PM	#14
pazos cosiñeiro Posts: 1,271 Karma: 2200049 Join Date: Apr 2014 Device: BQ Cervantes 4	Once you check that you have no problem with that particular ebook you can try to remove it and send it wireless again. It should work fine. If not please report here or in https://github.com/koreader/koreader/issues

04-22-2020, 01:02 PM	#15
JSWolf Resident Curmudgeon Posts: 73,970 Karma: 128903378 Join Date: Nov 2006 Location: Roslindale, Massachusetts Device: Kobo Libra 2, Kobo Aura H2O, PRS-650, PRS-T1, nook STR, PW3	I've made some changes to the scrambled version I've attached. I removed all unused CSS and cleaned up some of the CSS. So hopefully it will work.