One-Click Install Packages for KOReader & Plato

[Frenzie]

Probably just a temporary fluke? For me it downloads in a couple of seconds.

[shuvashish76]

Yes, now the download speed is fine.

[Ben64]

Hi, I am new here. I greet everyone.

I use Windows 11 and I am (was?) a happy owner of a Kobo Clara BW. I just bought it second hand but sealed (the former owner had never opened it as it was a gift and wasn't interested).
I used it to load an epub for my daughter she owns in paperback too, and everything was fine.

But I had the very bad idea to try to try to install KOreader and Plato and messed with my new Kobo.
I downloaded the files in post 1 and the script in 2. Allowed the script to be run, unzipped and put the OCP-Plato-0.9.44_KOReader-v2024.11 folder I got and the install file in the kobo default folder (the one you get when you connect it to Windows). I ran the file with Powershell and a black window opened and close quickly. I thought I had done something wrong and read the post again to understood that I had to copy not the OCP-Plato-0.9.44_KOReader-v2024.11 folder but the content of it (with the folders .add .kobo .icons kfmon png and koreader png) in the Kobo folder. I copied the script and the folders again, ran the script again. Same quick black window and then nothing. I unmounted and restarted the Kobo. It "updated" or refreshed or something.
Now, there is a Nickelmenu at the bottom right corner, and the Home menu icons are messed up, as well as the content of my book and unread books.
What can I do to go back to how my Kobo was please.
It looks like this:
https://ibb.co/HxxqChn
https://ibb.co/F026qQB

Help please.

[DNSB]

Do not copy the files to your Kobo. Place the install.ps1 script and the .zip file in the same directory on your computer. Run the script from there. What you are currently seeing is every file that your Kobo scanned and added to the database since you did not add the exclusions to the Kobo eReader.conf file.

To quote the first 2 steps in the instructions in message #2 in this thread:

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.

Once you have done the install, safely eject your Kobo. At this point, the files that were previously imported will be removed and deleted.

So connect your Kobo and run the install script again to copy the missing files back.

[Ben64]

Thank you for answering DNSB.
I tried what you said and it didn't work. I restarted my kobo and plugged it and connected to Windows.
I downloaded OCP-Plato-0.9.44_KOReader-v2024.11.zip on my Windows 11 PC and put it in an empty new folder on my desktop. Then, I downloaded the script install.ps1 on my pc and put in the same folder as OCP-Plato-0.9.44_KOReader-v2024.11.zip.
After that, I right-clicked on install.ps1 and allowed it to run (like in the screenshot).
next, I ran the script with PowerShell: quick black window and nothing else.
I dismounted Kobo and restarted it.
Nothing.
After 3 tries, I decided to make a factory reset and the Kobo recovered from the buggy menu. That's great.
Now I want to understand what mistake I keep on making because it's not the first tutorial I am following.

In the install file, there are these lines:
# Ask the user what they want to install...
# NOTE: Case is a joy on Windows (https://github.com/PowerShell/PowerShell/issues/7578),
# so we simply prefix our package names to avoid accepting stock packages here...
$VALID_GLOBS=@("OCP-KOReader-v*.zip", "OCP-Plato-*.zip", "OCP-KFMon-*.zip", "KFMon-Uninstaller*.zip")
$AVAILABLE_PKGS=@()
foreach ($pat in $VALID_GLOBS) {
foreach ($file in Get-ChildItem -File -Name $pat) {
if (Test-Path $file) {
$AVAILABLE_PKGS+=$file

Is the package name incompatible and have to change it?
-->$VALID_GLOBS=@("OCP-KOReader-v*.zip", "OCP-Plato-*.zip", "OCP-KFMon-*.zip", "KFMon-Uninstaller*.zip") and add "OCP-Plato-0.9.44_KOReader-v2024.11.zip"?

It doesn't ask me what to install or anything, just a black window.
So frustrating...

[DNSB]

I would suggest opening a PowerShell windows and then running the script from there so you can see what happens. Please note that you will have to prefix the script name with .\ or ./ since Powershell by default does not run anything from the local directory.

I did a quick test and created a directory called Test on my desktop (Windows 11 24H2), copied install.ps1 and tried running it which obviously failed, unblocked it and tried running it again which told me no packages available. I then copied the OCP-Plato-0.9.44_KOReader-v2024.11.zip file to the Test directory without connecting a Kobo ereader which gave the can't find error message. Finally I connect my KLC and ran ./install.ps1 for 4th time. It came up with the install screen, I typed 0 to say use the Plato/KOReader package and the install went happily. So I would have to say the script is working as designed.

PS C:\Users\user\desktop\test> pwsh --version
PowerShell 7.4.6

PS C:\Users\user\desktop\test> dir
    Directory: C:\Users\user\desktop\test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        2025-01-10   8:48 PM           4525 install.ps1

PS C:\Users\user\desktop\test> ./install.ps1
./install.ps1 : File C:\Users\user\desktop\test\install.ps1 cannot be loaded. The file C:\Users\user\desktop\test\install.ps1 is not digitally signed. You cannot run this script on the current system. For more information about running scripts and setting execution policy, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.

At line:1 char:1
+ ./install.ps1
+ ~~~~~~~~~~~~~
    + CategoryInfo          : SecurityError: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

<right clicked install.ps1, clicked on unblock and then OK>

PS C:\Users\user\desktop\test> ./install.ps1
No supported packages found in the current directory (C:\Users\user\desktop\test)!
* Nothing to do! Press Enter to exit:

<copied OCP-Plato-0.9.44_KOReader-v2024.11.zip to the Test directory>
PS C:\Users\user\desktop\test> dir
    Directory: C:\Users\user\desktop\test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a----        2025-01-10   8:48 PM           4525 install.ps1
-a----        2025-01-10   8:50 PM       67394613 OCP-Plato-0.9.44_KOReader-v2024.11.zip

PS C:\Users\user\desktop\test> ./install.ps1
Couldn't find a Kobo eReader volume! Is one actually mounted?
* Nothing to do! Press Enter to exit:

<connected Kobo ereader and tried again>

PS C:\Users\user\desktop\test> ./install.ps1

* Here are the available packages:
0: OCP-Plato-0.9.44_KOReader-v2024.11.zip

* Enter the number corresponding to the one you want to install: 0
* Preventing Nickel from scanning hidden directories . . .
* Installing OCP-Plato-0.9.44_KOReader-v2024.11.zip . . .
* Installation successful!
* Please make sure to unplug your device safely!
Press Enter to exit:

[Ben64]

Hi DNSB, Thanks for your help.

It didn't go as smoothly as I expected because the code you wrote didn't work for me. However, I managed to install it using some of it.

First, I changed the name of the directory on my desktop to "test" as I was trying to follow your steps but kept having errors like this one:

PS C:\Users\ben_s> C:\Users\ben_s\desktop\test> ./install.ps1
C:\Users\ben_s\desktop\test>: The term 'C:\Users\ben_s\desktop\test>' is not recognized as a name of a cmdlet, function, script file, or executable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

I wasn't using PowerShell correctly so I googled about paths in PowerShell and read instructions on this page:
https://www.koenig-solutions.com/blo...owershell-path

"Using the Path in PowerShell Commands
Once you understand the concept of the path in PowerShell, you can start using it in your commands to navigate and manipulate files and folders. Here are a few examples of how to use the path in PowerShell commands"

In the part that says:

1. Changing the Working Directory
To change the current working directory to a specific path, use the Set-Location (or its alias, cd) command followed by the path:

Set-Location C:\Users\Username\Documents

Where "Username" is one's user name and "Documents" the directory where the files are, for me "Desktop\test"

So, using your tip about the "./", I wrote in PowerShell:

PS C:\Users\ben_s\Desktop> Set-Location C:\Users\ben_s\Desktop\test
PS C:\Users\user\desktop\test> ./install.ps1
Couldn't find a Kobo eReader volume! Is one actually mounted?
* Nothing to do! Press Enter to exit:

The same message you received! I was getting close!
Then, I restarted my Kobo Clara BW, connected to my PC and clicked on connect on the Kobo, and in the Powershell window I tried again using the up key to automatically write the same line.

PS C:\Users\user\desktop\test> ./install.ps1

* Here are the available packages:
0: OCP-Plato-0.9.44_KOReader-v2024.11.zip

It was working!

* Enter the number corresponding to the one you want to install:

OK, so I guessed it was "0", as you said in your post and the available package message above.

Then I got:
* Preventing Nickel from scanning hidden directories . . .
Which, I guess it prevented some errors related to the 4th point in the first message of the thread "NOTE: On FW >= 4.17, you'll need to prevent Nickel from scanning *nix hidden folders." But I can't be sure if it's the case...

* Installing OCP-Plato-0.9.44_KOReader-v2024.11.zip . . .
* Installation successful!
Amazing! Crossing my fingers...

* Please make sure to unplug your device safely!
Press Enter to exit:
I pressed "enter" ejected the Kobo in the Windows taskbar and restarted my Kobo.

Now I have this:
https://ibb.co/LrfW3Fn
https://ibb.co/ys2VHwP

It worked didn't it?




So,

For people who have the same problem as me, here is what I did:

* On Windows 11 24H2 with a Kobo Clara BW:
* IMPORTANT: all credits go to NiLuJe (OP) and DNSB, who helped me. I just explain what worked for me in case it can help other people.

0. With your Kobo unplugged from your PC, do as follow:
1. Create a folder on the destop and call it "test" (to make it simple)
2. Download the .zip package you want in post 1. For me it was: "KOReader AND Plato | OCP-Plato-0.9.44_KOReader-v2024.11.zip | 2024-Nov-26 21:05:27 | 64.2M | c236feca94024f21d0726318b5a18bdc | KFMon"
3. Right-click on the windows script link in the point 2 of post 2 and "save as" it is on your PC. Don't change the name.
4. Move both the .zip package and install files you just downloaded into the "test" folder you created on your desktop.
5. right-click on the install file, properties, "unblock" the script to allow it to run, in the bottom-right corner, as in the picture in post 2.
6. In the finder of Windows type PowerShell and run it.
(you can download the version 7.4 there: https://learn.microsoft.com/en-us/po...thmaure#winget)
7. Type after the line : PS C:\Users\username\Desktop>
Set-Location C:\Users\username\Desktop\test (where you should change the word username to your windows user name) and press enter
8. type:./install.ps1 after C:\Users\username\Desktop\test>
it should look like: PS C:\Users\username\Desktop\test>./install.ps1
You will get the following message:
Couldn't find a Kobo eReader volume! Is one actually mounted?
* Nothing to do! Press Enter to exit:
Press enter. Do not close the PowerShell window.
9. Reboot your Kobo, plug it and connect it to your pc pressing connect on the Kobo.
10. Go back to the PowerShell window, press the UP arrow on your PC keyboard. You should get:
PS C:\Users\username\Desktop\test> ./install.ps1
(as it was the last command you entered)
11. Press enter.
You will then get the following messages:
* Here are the available packages:
0: OCP-Plato-0.9.44_KOReader-v2024.11.zip
* Enter the number corresponding to the one you want to install:
12. Press the number 0 key (not the letter O)
13. You will get the following:
* Preventing Nickel from scanning hidden directories . . .
* Installing OCP-Plato-0.9.44_KOReader-v2024.11.zip . . . (wait while the bar is filling)
* Installation successful!
* Please make sure to unplug your device safely!
Press Enter to exit:
14. Press enter
15. Go to the right of your taskbar ^ and eject the Kobo from the ^ USB options
16. Restart your Kobo
17. Once restarted, you should have kfmon, koreader and plato in the my book dir like in these pictures:
https://ibb.co/LrfW3Fn
https://ibb.co/ys2VHwP

That's all folks! Hopefully it works for you as it did for me.

[DNSB]

Personally, I removed the icons to start KOReader/etc. and went with NM direct startup entries instead of the KFMon tap on icons.

I edited the koreader file in the .adds/nm directory to read:

# Launch KOReader directly via NM (>= KOReader 2020.05)
menu_item : main : KOReader : cmd_spawn : quiet : exec /mnt/onboard/.adds/koreader/koreader.sh

and the plato file in the .adds/nm directory to read:

# Launch Plato directly via NM
menu_item : main : Plato : cmd_spawn : quiet : exec /mnt/onboard/.adds/plato/plato.sh

Basically, the icons disappeared from view as I read books and if I was going to launch from NickelMenu, I decided the direct launch was preferrable. Personal choices.

[Ben64]

I'd like that too, the .png are not my type (Kfmon in particular), IMO they break the nice-looking interface of book covers on Kobo. I would prefer just to click on NM in the bottom right corner if I need to open Koreader or Plato.

The code koreader file in the .adds/nm directory is like that:

# Launch KOReader via KFMon
# NOTE: .adds/nm/kfmon will generate this automatically
#menu_item : main : KOReader : kfmon : koreader.png

# Launch KOReader directly via NM (>= KOReader 2020.05)
#menu_item : main : KOReader : cmd_spawn : quiet : exec /mnt/onboard/.adds/koreader/koreader.sh

Did you just remove the first 3 lines and saved the file?
Just to keep:
# Launch KOReader directly via NM (>= KOReader 2020.05)
#menu_item : main : KOReader : cmd_spawn : quiet : exec /mnt/onboard/.adds/koreader/koreader.sh

[Frenzie]

The # character makes the line a comment. You have to remove it to activate the line.

menu_item : main : KOReader : cmd_spawn : quiet : exec /mnt/onboard/.adds/koreader/koreader.sh