Cocoa (![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png)
momijizukamori) wrote2021-06-21 08:21 pm
momijizukamori) wrote2021-06-21 08:21 pm
Entry tags:
Ao3 Reader - Alpha 1
Because this is actually in a state where it's possible to share with other people for feedback! To install:
1) Download the kfmon/reader zip here.
2) Connect your Kobo via USB
3) Extract the zip directly into the base folder of the device (if, like me, you have an external SD card, you want the KOBOeReader device, that's the internal storage)
4) Add the following two lines to .kobo/Kobo/Kobo eReader.conf:
5) Eject device - it will appear to process imports and then run a short update (which is patching in the hooks for kfmon, which is the launcher util) and reboot.
Then to access, go into your Books and look for the 'book' (actually just an image file) named Plato and select it - that triggers the launcher script. To exit, use the menu in the top right corner -> quit
Caveats, etc
- You need to have the wifi on and be connected to a network before you try to launch the app - it'll crash immediately otherwise (I haven't put in error handling yet for when it can't fetch web pages)
- The physical frontlight button will not actually toggle the frontlight - instead it'll take a screenshot. You can toggle the frontlight from the menu bar though.
- You can only view one 'work index' (which is what I've been calling the listings you get from either searching or for looking at all works in a tag). It's set by default to the Sha Po Lang tag, but if you open .adds/plato/Settings.toml and go to the last line (base-path) you can set that to your URL of choice, either with the full domain name or relative to archiveofourown.org
This should be pretty safe - I've tested it a bunch, it's based on existing well-tested code, and it doesn't muck around much with system files. But I'm not responsible if something does go horribly wrong (though I will try to help fix), and you should back up your files regularly anyway, etc.
Midnight Edit: I FORGOT A STEP also the zip file was missing one of the necessary bits. If you got this before the edit and added like forty icons to your books list I am so so sorry, if you delete the folder and then add the config lines it'll resync properly
1) Download the kfmon/reader zip here.
2) Connect your Kobo via USB
3) Extract the zip directly into the base folder of the device (if, like me, you have an external SD card, you want the KOBOeReader device, that's the internal storage)
4) Add the following two lines to .kobo/Kobo/Kobo eReader.conf:
5) Eject device - it will appear to process imports and then run a short update (which is patching in the hooks for kfmon, which is the launcher util) and reboot.
Then to access, go into your Books and look for the 'book' (actually just an image file) named Plato and select it - that triggers the launcher script. To exit, use the menu in the top right corner -> quit
Caveats, etc
- You need to have the wifi on and be connected to a network before you try to launch the app - it'll crash immediately otherwise (I haven't put in error handling yet for when it can't fetch web pages)
- The physical frontlight button will not actually toggle the frontlight - instead it'll take a screenshot. You can toggle the frontlight from the menu bar though.
- You can only view one 'work index' (which is what I've been calling the listings you get from either searching or for looking at all works in a tag). It's set by default to the Sha Po Lang tag, but if you open .adds/plato/Settings.toml and go to the last line (base-path) you can set that to your URL of choice, either with the full domain name or relative to archiveofourown.org
This should be pretty safe - I've tested it a bunch, it's based on existing well-tested code, and it doesn't muck around much with system files. But I'm not responsible if something does go horribly wrong (though I will try to help fix), and you should back up your files regularly anyway, etc.
Midnight Edit: I FORGOT A STEP also the zip file was missing one of the necessary bits. If you got this before the edit and added like forty icons to your books list I am so so sorry, if you delete the folder and then add the config lines it'll resync properly
no subject
no subject
Thank you! It's exciting to have things at a point where I can shove it at other people for feedback.
no subject
i'll have a try over the weekend!
no subject
Whoo \o/ I may actually have a new build by then - I got live-loading of the tags partially working (pages after the first, uh, do not go in the correct spot. But the paginate works?), so once I get navigating by them working and a better landing spot, I think that is ready for alpha v2
no subject
I will try this tomorrow!
no subject
Ooh, this looks super powerful; I, too, will do this tomorrow! Thank you for putting this all together!
no subject
Lemme know what you think! Forewarning, I think it may need some updates to work on the newest round of devices (Libra 2, Sage, Ellipsa) - I am in the process of working out updates rn but I'm not sure when I'll have a new build ready.