Clara BW KFMon updated after generator error help

[indeliblemistake]

Hey guys,

After hours spent trying to find the solution I resorted to posting here, which means it will probably be simple and straight forward, of course

I am a novice when it comes to programming, although I had successfully installed Koreader a few months ago using the OCP and nightly update build.

I'm having trouble launching Koreader through Nickel Menu after a firmware update having encountering the generator error and learning that KFMon needs to be updated/reinstalled.

I used the install script along with OCP-KFMon-1.4.6-89-g8daae26.zip and terminal (mac) confirmed it went smoothly but now Nickel Menu does not give me any options whatsoever when it is selected.

I then updated Koreader to 4.40.23081 released in August 2024 to no avail.

Any ideas? TIA, I spent hours trying to avoid having to post this question I refuse to claim defeat and reinstall everything as I'd rather not risk losing any accumulated reading statistics

Cheers!

[DNSB]

If you look at the exposed storage on your Kobo, do you see a directory named .adds? Inside the .adds directory, you should see a directory named nm. Inside the nm directory, you should see a file called doc (the original NickelMenu documentation file with everything commented out) and files whatever they might be called which would be the source for NickelMenu's menus. After installing the OCP package, you could see kfmon, koreader and/or plato and whatever you called the file you used for your NickelMenu configuration.

I unistalled KFMon and removed the kfmon, plato and koreader files since I preferred to launch from within NickelMenu. In my NickelMenu config file, I added the following lines:

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

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

The repeated lines are to have the items show when at the Home and My Books screens.

[indeliblemistake]

Originally Posted by DNSB

If you look at the exposed storage on your Kobo, do you see a directory named .adds? Inside the .adds directory, you should see a directory named nm. Inside the nm directory, you should see a file called doc (the original NickelMenu documentation file with everything commented out) and files whatever they might be called which would be the source for NickelMenu's menus. After installing the OCP package, you could see kfmon, koreader and/or plato and whatever you called the file you used for your NickelMenu configuration.

I unistalled KFMon and removed the kfmon, plato and koreader files since I preferred to launch from within NickelMenu. In my NickelMenu config file, I added the following lines:

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

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

The repeated lines are to have the items show when at the Home and My Books screens.

I can see the .adds directory and after running the OCP package I can see kfmon, koreader and that doc file you mentioned within the nm directory, should this not be the case?

I am nowhere near adept or have any experience with coding/programming so I haven't and don't plan on tinkering with NickelMenu to create custom menus to avoid messing things up and am content with the functionality Koreader offers. Is the doc file in the nm directory the config file for NickelMenu?

From what I gather in my case, am I right in saying KFMon's main purpose is to launch Koreader?

I have only been using NickelMenu to launch Koreader from the Kobo home page eg. after a reboot, can you advise me as to how can I restore this functionality?

Sorry if I am misunderstanding you, I am trying my best and thank you for your patience!

[indeliblemistake]

I also noticed after selecting NickelMenu, instead of giving me the option to launch Koreader or any error as it did previously, a small dot appears for some reason..

[DNSB]

Originally Posted by indeliblemistake

I can see the .adds directory and after running the OCP package I can see kfmon, koreader and that doc file you mentioned within the nm directory, should this not be the case?

The koreader file in the nm directory will have the line enabling launching from kfmon enabled and the line enabling launching from NickelMenu disabled.

# 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

You can delete the first four lines in that file and remove the # from the start of the #menu_item line. This will leave the file looking like this:

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

Originally Posted by indeliblemistake

I am nowhere near adept or have any experience with coding/programming so I haven't and don't plan on tinkering with NickelMenu to create custom menus to avoid messing things up and am content with the functionality Koreader offers. Is the doc file in the nm directory the config file for NickelMenu?

No. Basically all the commands are documented in that file with any sample commands commented out. You should not use this file to generate your NickelMenu setup since it will be overwritten when a new version of NM is installed. Use another file for your working config.

Originally Posted by indeliblemistake

From what I gather in my case, am I right in saying KFMon's main purpose is to launch Koreader?

For me, I uninstalled KFMON since I used NickelMenu directly to launch KOReader and Plato. It can used for quite a few other purposes but I find NickelMenu to be easier to use. Unless you want to hunt for the trigger png files, you end up setting them up in NickelMenu.

Originally Posted by indeliblemistake

I have only been using NickelMenu to launch Koreader from the Kobo home page eg. after a reboot, can you advise me as to how can I restore this functionality?

Sorry if I am misunderstanding you, I am trying my best and thank you for your patience!

I would suggest editing the koreader file in the nm directory as suggested in the second code box above. I've also attached a text file that can be placed in the nm directory which adds a few functions I find useful. You can use it as a sample to see what others are doing. If you use this one, you can remove the kfmon and koreader files.