01-09-2019, 05:06 PM | #1 |
BLAM!
Posts: 13,499
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
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 & NickelMenu. 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, and can be automated by the script found in post #2:
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, which is why there's a package dedicated to that listed at the bottom of this post. NOTE: Another thing that bears repeating is that on FW >= 4.17, you'll probably also want to prevent Nickel from scanning *nix hidden folders. And you'll want to tweak your config before unplugging your device (i.e., before installing this; or, if you've just upgraded your FW, during the first USB connection after the update). In order to alleviate potential interaction from USBMS gremlins, I would *also* recommend that you do all this right after a clean, full reboot of your device. NOTE: Please see the next post for an automated installation script, which I heartily recommend using instead of doing all this manually! 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 Tue, 26 Nov 2024 21:07:43 +0100
Last edited by NiLuJe; 11-26-2024 at 04:08 PM. |
01-09-2019, 05:06 PM | #2 |
BLAM!
Posts: 13,499
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
Alternatively, I've also come up with small scripts to automate the process somewhat, with a few caveats:
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. This will also automatically prevent Nickel from scanning *nix hidden folders on FW 4.17+. NOTE: Pertaining to that particular bit of trickery, I would *strongly* recommend that you do all this right after a clean, full reboot of your device; and to connect the device *straight from the Home screen*, without touching any documents first! 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:
macOS:
Linux:
And that's it! For reference, here's how the script's output could look like: Last edited by NiLuJe; 09-27-2023 at 01:55 PM. Reason: Recommend rebooting the device first, should hopefully help avoid mysterious USBMS issues |
Advert | |
|
01-09-2019, 06:19 PM | #3 |
BLAM!
Posts: 13,499
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
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 11:38 PM. |
01-10-2019, 03:18 PM | #4 |
Junior Member
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!
|
01-10-2019, 03:56 PM | #5 |
Wizard
Posts: 1,693
Karma: 730679
Join Date: Oct 2014
Location: Antwerp
Device: Kobo Aura H2O
|
PowerShell looks more elegant than I thought.
|
Advert | |
|
01-10-2019, 04:19 PM | #6 |
Guru
Posts: 871
Karma: 2676800
Join Date: Sep 2008
Location: Taranaki - NZ
Device: Kobo Aura H2O, Kobo Forma
|
Ah Powershell. All of the obtuseness of *nix shell scripts, without the brevity.
That's my opinion anyway |
01-10-2019, 04:23 PM | #7 |
Wizard
Posts: 1,693
Karma: 730679
Join Date: Oct 2014
Location: Antwerp
Device: Kobo Aura H2O
|
Hehe, I'll agree to that.
|
01-10-2019, 04:29 PM | #8 |
BLAM!
Posts: 13,499
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
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 04:35 PM. |
01-10-2019, 05:18 PM | #9 |
Wizard
Posts: 1,693
Karma: 730679
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 05:21 PM. |
01-10-2019, 05:47 PM | #10 | |
Guru
Posts: 871
Karma: 2676800
Join Date: Sep 2008
Location: Taranaki - NZ
Device: Kobo Aura H2O, Kobo Forma
|
Quote:
Since you're already using Python for this project, I would have thought you might have used that instead of PowerShell. |
|
01-10-2019, 06:27 PM | #11 |
Guru
Posts: 741
Karma: 7025494
Join Date: Aug 2017
Location: Italy
Device: Kindle Paperwhite, Kobo Elipsa, Pocketbook Inkpad 4, Inkpad Color
|
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. |
01-10-2019, 06:50 PM | #12 |
BLAM!
Posts: 13,499
Karma: 26047188
Join Date: Jun 2010
Location: Paris, France
Device: Kindle 2i, 3g, 4, 5w, PW, PW2, PW5; Kobo H2O, Forma, Elipsa, Sage, C2E
|
@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' . |
01-10-2019, 07:09 PM | #13 | |
Guru
Posts: 741
Karma: 7025494
Join Date: Aug 2017
Location: Italy
Device: Kindle Paperwhite, Kobo Elipsa, Pocketbook Inkpad 4, Inkpad Color
|
Quote:
|
|
01-10-2019, 11:43 PM | #14 |
Junior Member
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 11:47 PM. |
01-11-2019, 12:16 AM | #15 |
Enthusiast
Posts: 33
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? |
Tags |
kfmon, kobo, koreader, plato |
|
Similar Threads | ||||
Thread | Thread Starter | Forum | Replies | Last Post |
Aura How to install ksm and koreader | mhss | Kobo Reader | 0 | 01-17-2018 08:45 PM |
Koreader could not be opened by click an epub file on the books list | johnleo | KOReader | 4 | 12-11-2017 08:57 AM |
Cannot install custom update packages via MRPI | anunay | Kindle Developer's Corner | 9 | 02-09-2017 08:46 AM |
Kobo-how to install koreader | sahbi | KOReader | 22 | 01-02-2016 04:49 PM |
Koreader install help | mrmojorizing | Kobo Developer's Corner | 3 | 09-29-2014 02:24 PM |