Koreader running on Kobos (all of them, hopefully!)

[giorgio130]

A historical thread, the older posts maybe out of date and improved methods available, in more recent threads.

This is the reference thread for running KOReader on Kobo models. The support now is quite good and included in official nightly builds.

Source is available at https://github.com/koreader/koreader, you can also report bugs there.

For those who don't know KOReader, here are some screenshots:
http://imgur.com/a/1NR7I/all

Installing instructions:
- install "Files Monitor" (https://www.mobileread.com/forums/sh...d.php?t=218283)
- Put the image included in the zip (called "koreader.png") in the main folder of your kobo and disconnect it from your computer. Open the image on the reader, go back to the home and then, just to be extra-safe, reboot it.
- Extract the remaining content of the zip in the ".kobo" directory (both KoboRoot.tgz and the koreader folder)

Selecting the KOReader icon in your home, you will be able to launch KOReader. Simple enough, isn't it? Just be sure to process the image properly (follow those steps carefully) if it's the first time you install koreader, if you made a factory reset or if you deleted it in some way, otherwise you could end up launching koreader automatically at every boot, being unable to exit it without a factory reset.

When you install an update, it should be sufficient to extract the koreader folder, without KoboRoot.tgz - that one is needed to add the launcher.

Things that are still missing:
- usb mass storage mode

Use koreader_old.zip for 2.5.x or older firmware (not really supported); for 2.6.1 use the nightly builds.

I've added a small pdf guide for installation; the steps outlined work on every model, not only AuraHD. Thanks @xping!

[chrox]

For detailed and updated manual on the functionality of Koreader,
please refer to the Koreader Wiki page.

[JonnyXDA]

The latest nightly builds are available from here >>> https://code.google.com/p/koreader-p...downloads/list

Please note, nightly builds may not always be stable but they include all the latest code changes, fixes etc

[cgm999]

Any ideea why is not working on kobo aura?

strace on ./reader.lua(grep -v ENOENT to exclude lib searching) :

execve("./reader.lua", ["./reader.lua"], [/* 21 vars */]) = 0
brk(0) = 0x2c6000
uname({sys="Linux", node="(none)", ...}) = 0
mmap2(NULL, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x2aac2000
open("/lib/libm.so.6", O_RDONLY|O_CLOEXEC) = 3
read(3, "\177ELF\1\1\1\0\0\0\0\0\0\0\0\0\3\0(\0\1\0\0\0\23 0;\0\0004\0\0\0"..., 512) = 512
lseek(3, 397768, SEEK_SET) = 397768
read(3, "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\ 0\0\0\0\0\0\0\0"..., 1160) = 1160
lseek(3, 397432, SEEK_SET) = 397432
read(3, "A6\0\0\0aeabi\0\1,\0\0\0\0057-A\0\6\n\7A\10\1\t\2\n\4\22"..., 55) = 55
fstat64(3, {st_mode=S_IFREG|0755, st_size=398928, ...}) = 0
mmap2(NULL, 4096, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_ANONYMOUS, -1, 0) = 0x2aac4000
mmap2(NULL, 430208, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x2aacb000
mprotect(0x2ab2c000, 28672, PROT_NONE) = 0
mmap2(0x2ab33000, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0x60) = 0x2ab33000
close(3) = 0
open("/lib/libpthread.so.0", O_RDONLY|O_CLOEXEC) = 3
read(3, "\177ELF\1\1\1\0\0\0\0\0\0\0\0\0\3\0(\0\1\0\0\0\5P \0\0004\0\0\0"..., 512) = 512
lseek(3, 66332, SEEK_SET) = 66332
read(3, "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\ 0\0\0\0\0\0\0\0"..., 1400) = 1400
lseek(3, 65924, SEEK_SET) = 65924
read(3, "A6\0\0\0aeabi\0\1,\0\0\0\0057-A\0\6\n\7A\10\1\t\2\n\4\22"..., 55) = 55
fstat64(3, {st_mode=S_IFREG|0755, st_size=100802, ...}) = 0
mmap2(NULL, 107024, PROT_READ|PROT_EXEC, MAP_PRIVATE|MAP_DENYWRITE, 3, 0) = 0x2ab35000
mprotect(0x2ab45000, 28672, PROT_NONE) = 0
mmap2(0x2ab4c000, 8192, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_DENYWRITE, 3, 0xf) = 0x2ab4c000
mmap2(0x2ab4e000, 4624, PROT_READ|PROT_WRITE, MAP_PRIVATE|MAP_FIXED|MAP_ANONYMOUS, -1, 0) = 0x2ab4e000
close(3) = 0
open("libs/libk2pdfopt.so.1", O_RDONLY|O_CLOEXEC) = 3
read(3, "\177ELF\1\1\1\0\0\0\0\0\0\0\0\0\3\0(\0\1\0\0\0\30 \250\0\0004\0\0\0"..., 512) = 512
lseek(3, 544908, SEEK_SET) = 544908
read(3, "\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\ 0\0\0\0\0\0\0\0"..., 1040) = 1040
lseek(3, 544596, SEEK_SET) = 544596
read(3, "A/\0\0\0aeabi\0\1%\0\0\0\0056J\0\6\6\10\1\t\1\n\2\22 \4\24\1"..., 48) = 48
exit_group(1) = ?
+++ exited with 1 +++


so it seems to exit w/o any error
[root@(none) koreader]# uname -a
Linux (none) 2.6.35.3-850-gbc67621+ #1038 PREEMPT Thu Apr 25 15:48:22 CST 2013 armv7l GNU/Linux

fw is 2.6.1 model N204B

[giorgio130]

@chrox, nice, I didn't notice that! I'll try to add the functionality as soon as I can...
@JonnyXDA, currently kobo support is to be chosen at compile time, and no "kobo nightly" is currently being built. However it could be asked...
@cgm999, that could be an issue coming from the firmware 2.6.1. I still didn't test the build under that. I'll do it later and report. In the mean time, if someone is still running 2.5.x on his Aura, I'd like to hear some testing results

[WS64]

How do I get this to start?
I have installed Kobo Launcher and edit its ini file to start a script file containing the line "/mnt/onboard/.kobo/koreader/koreader-kobo.sh /mnt/onboard"
It does nothing at all when I start this from .

Kobo mini running 2.6.1 here.
What other ways are there to start it? As I understood it "tweaks" does not work with 2.6.1.

[voyage2005]

Hi giorgio130,

Thanks for the work on koreader! But I have problems to start it. I am using glo at 2.5.2 with kobo tweaks.

1. In your attachment the start shell script file is "koreader_kobo.sh" but the above code you mentioned is "koreader-kobo.sh".

2. I added one line in kobotweaks.ini as below. It does nothing when I click koreader button on tweaks Tools menu. Is there something wrong here?

koreader=tweaks.executeSystemCmd(\"/mnt/onboard/.kobo/koreader/koreader_kobo.sh /mnt/onboard\")

[giorgio130]

Originally Posted by voyage2005

Hi giorgio130,

Thanks for the work on koreader! But I have problems to start it. I am using glo at 2.5.2 with kobo tweaks.

1. In your attachment the start shell script file is "koreader_kobo.sh" but the above code you mentioned is "koreader-kobo.sh".

2. I added one line in kobotweaks.ini as below. It does nothing when I click koreader button on tweaks Tools menu. Is there something wrong here?

koreader=tweaks.executeSystemCmd(\"/mnt/onboard/.kobo/koreader/koreader_kobo.sh /mnt/onboard\")

Thanks for noticing the typo. Your line in kobotweaks.ini is identical to mine, so it should work. Are you able to run other commands? If the software is actually started and it crashes somewhere, a file called crash.log should be present hinting at the cause, could you post the contents if it is there?

[paola]

Originally Posted by WS64

How do I get this to start?
I have installed Kobo Launcher and edit its ini file to start a script file containing the line "/mnt/onboard/.kobo/koreader/koreader-kobo.sh /mnt/onboard"
It does nothing at all when I start this from .

Kobo mini running 2.6.1 here.
What other ways are there to start it? As I understood it "tweaks" does not work with 2.6.1.

you have to modify the .ini file (it is a textfile) of the launcher and add the line:

"koreader = /mnt/onboard/.kobo/koreader/koreader-kobo.sh /mnt/onboard"

When you launch Kobolauncher, you will see in the menu Koreader, just touch that.

[paola]

Originally Posted by giorgio130

Installing instructions:
just place the folder "koreader" inside the zip to your .kobo folder;
use your favourite mean (tweaks, launcher, whatever) to execute the command

/mnt/onboard/.kobo/koreader/koreader_kobo.sh /mnt/onboard

thanks Giorgio: unfortunately it does not work for me: I launch the command form kobolauncher, but nothing happens. I have a mini. Any ideas?

[voyage2005]

Originally Posted by giorgio130

Thanks for noticing the typo. Your line in kobotweaks.ini is identical to mine, so it should work. Are you able to run other commands? If the software is actually started and it crashes somewhere, a file called crash.log should be present hinting at the cause, could you post the contents if it is there?

Yes. I can run other commands (for example: KoboLauncher.sh).

The crash.log file only has one line: "Segmentation fault"

[WS64]

Originally Posted by paola

you have to modify the .ini file (it is a textfile) of the launcher and add the line:

"koreader = /mnt/onboard/.kobo/koreader/koreader-kobo.sh /mnt/onboard"

When you launch Kobolauncher, you will see in the menu Koreader, just touch that.

This is what I tried first.
Does not work.
Koreader shows up (of course), but clicking on it does not have any affect.

[Ken Maltby]

Originally Posted by WS64

This is what I tried first.
Does not work.
Koreader shows up (of course), but clicking on it does not have any affect.

Are you running under the 2.6.1 firmware? I think that may be what is preventing us from having it work. I would go back to an earlier firmware, and try, but I can wait.

Luck;
Ken

[WS64]

Yes, I'm on 2.6.1 (like I wrote in my first post).
And I can see in the log file of Kobo Launcher that KL did execute the command, but that's all I can see.

[pbra]

Hello,

I tested koreader (koreader-v2013.03-207-gd7df349.zip) on my glo with 2.5.2 fw. It doesn't start and I get a "Segmentation fault" in crash.log.
I use the "Kobo Tweaks" by ah- to start it.
My configuration line is : Koreader=tweaks.executeSystemCmd(\"/mnt/onboard/.kobo/koreader/koreader_kobo.sh /mnt/onboard\")

it seem to be the same problem as the one of voyage2005

Regards