Register Guidelines E-Books Search Today's Posts Mark Forums Read

Go Back   MobileRead Forums > E-Book Readers > Kobo Reader > Kobo Developer's Corner

Notices

Reply
 
Thread Tools Search this Thread
Old 01-09-2019, 04:06 PM   #1
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 8,328
Karma: 10930821
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, (PW) & PW2; Kobo H2O & Forma
Lightbulb One-Click Install Packages for KOReader & Plato

You'll find here links to so called "one-click" install packages for both KOReader & Plato.
This is primarily aimed at brand new users, with the goal of getting things to work in the most fool-proof manner possible, by simply unpacking a single ZIP archive in the root of your Kobo eReader over USB.
To make this possible, these packages bundle KFMon.

For existing users, if you're happy with your current setup, by all means, carry on! . Launchers are, by design, mutually exclusive: between fmon & KFMon, only the one installed last will be active, but where KSM is concerned, KSM will always take precedence, so this is NOT designed for KSM users.
If you're curious as to what this actually does to original KOreader/Plato packages, the gory details are all here!

Now that this is out of the way, on to the good stuff!

As mentioned earlier, the installation instructions are dead simple:
  1. Choose what you want to install: KOReader, Plato, or both, and download the appropriate ZIP from the listing below.
  2. Plug your Kobo eReader to your computer over USB.
  3. Directly extract the ZIP archive you've just downloaded to the root directory of your device (i.e., not under any subdirectory). (That's the "one click" bit ;p)
    NOTE: Prefer the "Extract To" approach (and allow replacing existing content if it's asked of you) vs. manually copy/pasting or drag'n dropping bits of the ZIP content yourself, as preserving the integrity of the directory structure and its contents is of paramount importance!
  4. Eject & unplug your device. The Kobo software should then appear to be processing a book, before restarting to process an update.
    NOTE: If it doesn't attempt to reboot, that's a sure thing something went wrong in the previous step (hint: see the NOTE).
  5. Once your device has finished rebooting, you should simply be able to tap on the KOReader or Plato icon in your Home or your Library to launch it!

NOTE: Something that bears repeating from KFMon's FAQ: a FW update will disable it, so you'll have to reinstall it after a FW update in order to be able to launch stuff again. You can either use these packages or the standalone KFMon package.

The listing follows this format:
Description | D/L Link | Last Modified | Size | MD5 Checksum | MR Thread

(A barebones version of this listing is also available here).

One-Click Kobo Packages:
Last updated on Mon, 18 Mar 2019 19:54:39 +0100

Last edited by NiLuJe; 03-18-2019 at 02:59 PM.
NiLuJe is offline   Reply With Quote
Old 01-09-2019, 04:06 PM   #2
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 8,328
Karma: 10930821
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, (PW) & PW2; Kobo H2O & Forma
Alternatively, I've also come up with small scripts to automate the process somewhat, with a few caveats:
  • They rely on decently recent features, on every platform (i.e., Windows 10, a not terribly outdated macOS version, and a decently recent Linux distribution).
  • They'll only behave properly with a *single* Kobo plugged to the computer. Running 'em with *no* Kobo plugged in is safe, running 'em with multiple Kobos may lead to unexpected behavior: it may be handled sanely, but it might not.
  • On macOS, this doesn't protect you from some of its stupid "Quality of Life" features. Of particular interest here, Safari and its tendency to do stupid things with ZIP archives. If you don't want to change your Safari settings, you'll have to fish out the original ZIP archive from your Trash.
  • Most browsers will treat the Windows script as a text file, so you'll have to Right Click > Save Link As (or Download Linked File in Safari) on the link to download it.

With that out of the way, here's what this is supposed to automate: figuring out where the Kobo is mounted, asking you to confirm what you want to install, and properly unpacking the right archive.

Note that, in addition to the packages in the first post, the scripts also handle KFMon's standalone install package, to quickly restore functionality after a FW update, for instance .

Onwards!

Windows:
  1. Check the previous message, and download the ZIP package that you're interested in.
  2. Download the Windows install script, in the same folder.
  3. Run the install.ps1 script with PowerShell (Right Click > Run with PowerShell).
    That should look like this:
  4. Follow the on-screen instructions.
  5. Eject & unplug your Kobo, watch it process & reboot .

macOS:
  1. Check the previous message, and download the ZIP package that you're interested in, remembering the macOS/Safari quirks I mentioned above.
  2. Download the macOS install script archive, and unzip it in the same folder.
  3. Run the install.command script (Right Click > Open > Then click Open in the GateKeeper popup).
    That should look like this:

  4. Follow the on-screen instructions. Close the window when it's done.
  5. Eject & unplug your Kobo, watch it process & reboot .

Linux:
  1. Check the previous message, and download the ZIP package that you're interested in.
  2. Download the Linux install script archive, and unzip it in the same folder.
  3. Run the install.sh script with your favorite terminal emulator.
    Here's how it looks like on KDE:
  4. Follow the on-screen instructions. Close the window when it's done.
  5. Eject & unplug your Kobo, watch it process & reboot .

And that's it! For reference, here's how the script's output could look like:
Attached Thumbnails
Click image for larger version

Name:	RunWith_PS1.png
Views:	490
Size:	11.7 KB
ID:	168964   Click image for larger version

Name:	RunWith_macOS_1_of_3.png
Views:	196
Size:	250.7 KB
ID:	168965   Click image for larger version

Name:	RunWith_macOS_2_of_3.png
Views:	166
Size:	111.8 KB
ID:	168966   Click image for larger version

Name:	RunWith_macOS_3_of_3.png
Views:	147
Size:	138.0 KB
ID:	168967   Click image for larger version

Name:	RunWith_KDE.png
Views:	296
Size:	28.7 KB
ID:	168968   Click image for larger version

Name:	OCP_Example.png
Views:	221
Size:	29.7 KB
ID:	168969   Click image for larger version

Name:	RunCmd_macOS.png
Views:	226
Size:	63.7 KB
ID:	168975   Click image for larger version

Name:	RunCmd_macOS_GateKeeper.png
Views:	197
Size:	26.2 KB
ID:	168977  

Last edited by NiLuJe; 01-14-2019 at 12:53 PM.
NiLuJe is offline   Reply With Quote
Advert
Old 01-09-2019, 05:19 PM   #3
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 8,328
Karma: 10930821
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, (PW) & PW2; Kobo H2O & Forma
I'm almost ashamed to admit that dipping my toes in PowerShell for the first time was *almost* fun! *shudders* .

Anyway, KOReader 2019.01 is out, KFMon 1.2.11 is out, this is now ready to go, enjoy .

Ah, and to expand a bit on the "Windows 10" requirement: it's actually PowerShell 5+, which *can* find its way to older Windows versions, but *may* require manual intervention to do so (I honestly have no idea, Windows Update is hell). You can always try: the script will safely abort if PowerShell is too old.

EDIT: Reworded macOS/Linux instructions because of exec bit trickery. -_-".

Last edited by NiLuJe; 01-09-2019 at 10:38 PM.
NiLuJe is offline   Reply With Quote
Old 01-10-2019, 02:18 PM   #4
TheCheshireMan
Junior Member
TheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and TimeTheCheshireMan possesses cleverness exceeding the boundaries of Space and Time
 
Posts: 1
Karma: 49046
Join Date: Nov 2018
Device: Kobo Clara HD
Thank you so much for this! Just tested the Windows script for Plato+KOReader on a Clara HD running the latest stock firmware (4.12.12111 with no mods or add-ons at all), it worked like a charm!
TheCheshireMan is offline   Reply With Quote
Old 01-10-2019, 02:56 PM   #5
Frenzie
Fanatic
Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.
 
Posts: 568
Karma: 115024
Join Date: Oct 2014
Location: Antwerp
Device: Kobo Aura H2O
PowerShell looks more elegant than I thought.
Frenzie is offline   Reply With Quote
Advert
Old 01-10-2019, 03:19 PM   #6
sherman
Fanatic
sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.
 
Posts: 519
Karma: 1167141
Join Date: Aug 2008
Location: Auckland - NZ
Device: Sony PRS-505/SC, B&N Nook, Sony PRS-650/BC, Kobo Glo, Kobo Aura H2O
Ah Powershell. All of the obtuseness of *nix shell scripts, without the brevity.

That's my opinion anyway
sherman is offline   Reply With Quote
Old 01-10-2019, 03:23 PM   #7
Frenzie
Fanatic
Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.
 
Posts: 568
Karma: 115024
Join Date: Oct 2014
Location: Antwerp
Device: Kobo Aura H2O
Hehe, I'll agree to that.
Frenzie is offline   Reply With Quote
Old 01-10-2019, 03:29 PM   #8
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 8,328
Karma: 10930821
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, (PW) & PW2; Kobo H2O & Forma
Heh ;p.

I was pleasantly surprised by how easy it was to pretty much do a 1:1 port of simple logic like that, though .

I was prepared for much much worse, and then, it just... kind of flowed, and it worked? .

When I started thinking about my options, my first though went to Go, but I've never actually worked in Go, so then I went with: I'll try to PoC it in shell first, and then go (ha!) from there. And once that was done, I went: wait, I can probably do that with PowerShell, right? And voilà ;p.

Last edited by NiLuJe; 01-10-2019 at 03:35 PM.
NiLuJe is offline   Reply With Quote
Old 01-10-2019, 04:18 PM   #9
Frenzie
Fanatic
Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.Frenzie can see what is invisible to the naked eye.
 
Posts: 568
Karma: 115024
Join Date: Oct 2014
Location: Antwerp
Device: Kobo Aura H2O
I'd instinctively have written a much less elegant traditional batch file, JScript or VBScript. I realize PowerShell has been around for close to a decade now, but I distinctly recall purposefully installing it and fleeing to Cygwin Bash, which I'd been using for some basic "batch" (shell) scripts to great satisfaction.

Windows 7 may have integrated PowerShell, but I upgraded from XP to Debian because 7 broke all my stuff anyway.

Edit: For the sake of fairness I should probably add that PowerShell isn't half as useful on XP as it is on 7.

Last edited by Frenzie; 01-10-2019 at 04:21 PM.
Frenzie is offline   Reply With Quote
Old 01-10-2019, 04:47 PM   #10
sherman
Fanatic
sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.sherman ought to be getting tired of karma fortunes by now.
 
Posts: 519
Karma: 1167141
Join Date: Aug 2008
Location: Auckland - NZ
Device: Sony PRS-505/SC, B&N Nook, Sony PRS-650/BC, Kobo Glo, Kobo Aura H2O
Quote:
Originally Posted by NiLuJe View Post
Heh ;p.

I was pleasantly surprised by how easy it was to pretty much do a 1:1 port of simple logic like that, though .

I was prepared for much much worse, and then, it just... kind of flowed, and it worked? .

When I started thinking about my options, my first though went to Go, but I've never actually worked in Go, so then I went with: I'll try to PoC it in shell first, and then go (ha!) from there. And once that was done, I went: wait, I can probably do that with PowerShell, right? And voilà ;p.
Go is nice, but the main problem with it in this sort of context is the size of the binaries.

Since you're already using Python for this project, I would have thought you might have used that instead of PowerShell.
sherman is offline   Reply With Quote
Old 01-10-2019, 05:27 PM   #11
ps67
Connoisseur
ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.
 
Posts: 99
Karma: 457648
Join Date: Aug 2017
Location: Italy
Device: Kindle Paperwhite, Kobo Aura One
A curiosity: I have the latest firmware and I applied the patches, if I wanted to install Koreader and Plato I would keep them or lose them? Actually I mistreated my Kobo already enough, so maybe I do not but I wanted to know it anyway.
Thanks to you and to all those who share their Kobo programs.
ps67 is offline   Reply With Quote
Old 01-10-2019, 05:50 PM   #12
NiLuJe
BLAM!
NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.NiLuJe ought to be getting tired of karma fortunes by now.
 
NiLuJe's Avatar
 
Posts: 8,328
Karma: 10930821
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, (PW) & PW2; Kobo H2O & Forma
@sherman: My main issue with Python in this context is that Windows doesn't ship with a Python interpreter .

And the solutions that exist (I think?) to build self-sufficient Windows executables out of a Python script would share the same "binary bloat" issues as Go (probably much worse, in fact) .

@ps67: Nope, KOReader/Plato/KFMon won't affect your FW version or its 'patchiness' .
NiLuJe is offline   Reply With Quote
Old 01-10-2019, 06:09 PM   #13
ps67
Connoisseur
ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.ps67 ought to be getting tired of karma fortunes by now.
 
Posts: 99
Karma: 457648
Join Date: Aug 2017
Location: Italy
Device: Kindle Paperwhite, Kobo Aura One
Quote:
Originally Posted by NiLuJe View Post
@sherman: My main issue with Python in this context is that Windows doesn't ship with a Python interpreter .

And the solutions that exist (I think?) to build self-sufficient Windows executables out of a Python script would share the same "binary bloat" issues as Go (probably much worse, in fact) .

@ps67: Nope, KOReader/Plato/KFMon won't affect your FW version or its 'patchiness' .
Thank'You for quick replay
ps67 is offline   Reply With Quote
Old 01-10-2019, 10:43 PM   #14
Aung Kyaw Kyaw
Junior Member
Aung Kyaw Kyaw began at the beginning.
 
Posts: 2
Karma: 10
Join Date: Jan 2019
Device: Kobo Forma
Is it compatible with kobo forma? And also can't download Window install script.

Last edited by Aung Kyaw Kyaw; 01-10-2019 at 10:47 PM.
Aung Kyaw Kyaw is offline   Reply With Quote
Old 01-10-2019, 11:16 PM   #15
favero_
Member
favero_ began at the beginning.
 
Posts: 12
Karma: 10
Join Date: Jul 2017
Device: Kindle Paperwhite 3
Thanks for the amazing work. Just one question, I don't need to install anything before, not even KFMon? I've just got my kobo forma and of course their software is impossible to read pdfs. By the way, what are your impressions about Plato? Is it better/worse than koreader?
And later if I want to uninstall it, what should I do?

Thanks a lot and sorry for all the noobie questions!

Also, how could I back up before installing in case anything goes wrong, do I just copy everything that is on kobo drive?
favero_ is offline   Reply With Quote
Reply

Tags
kfmon, kobo, koreader, plato

Thread Tools Search this Thread
Search this Thread:

Advanced Search

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
Aura How to install ksm and koreader mhss Kobo Reader 0 01-17-2018 07:45 PM
Koreader could not be opened by click an epub file on the books list johnleo KOReader 4 12-11-2017 07:57 AM
Cannot install custom update packages via MRPI anunay Kindle Developer's Corner 9 02-09-2017 07:46 AM
Kobo-how to install koreader sahbi KOReader 22 01-02-2016 03:49 PM
Koreader install help mrmojorizing Kobo Developer's Corner 3 09-29-2014 01:24 PM


All times are GMT -4. The time now is 08:47 AM.


MobileRead.com is a privately owned, operated and funded community.