quill/README.md

17 lines
1.6 KiB
Markdown
Raw Normal View History

2021-03-25 04:48:20 -07:00
# inkbox
2021-08-03 08:41:32 -07:00
## What is it?
InkBox is an open-source, Qt-based eBook reader for Kobo devices. It currently features, namely, ePUB/plain text support, X11 apps (KoBox) integration and [native open-source OS](https://github.com/Kobo-InkBox/rootfs) support for a number of devices.
2021-08-03 08:49:16 -07:00
## How do I install it?
2021-08-03 08:41:32 -07:00
You can download precompiled OS/binaries [here](http://pkgs.kobox.fermino.me/bundles/inkbox/native/) and standard Nickel add-ons are available [there](http://pkgs.kobox.fermino.me/bundles/inkbox/nickel/), although support for them has been stopped until further notice.
<br>
Flashing InkBox OS to your Kobo's SD card is as simple as doing, on most *nix machines, assuming that `inkbox.xz` is the file you downloaded and that `/dev/mmcblk0` is your SD card's device node:
```
xzcat inkbox.xz | dd of=/dev/mmcblk0
```
2021-08-03 08:49:16 -07:00
If you install the Nickel add-on, unpack the 'base' archive in the root of the onboard storage, not in any subfolder inside it.
2021-08-03 08:41:32 -07:00
## How can I contribute?
2021-08-03 08:49:16 -07:00
If you like this project and want to improve it in some way, feel free to fork this repository or [one of the subprojects this organization hosts](https://github.com/Kobo-InkBox), then make a [pull request](https://github.com/Kobo-InkBox/inkbox/pulls). I'll be happy to review it.
<br><br>
2021-08-03 08:41:32 -07:00
On the other hand, if you don't have the appropriate coding skills or just want to help in some way, feel free to [make a donation here](https://liberapay.com/tux-linux/). I'm a student and motivation has been the only thing that has helped me maintain this project for the last months. Developing an entire operating system on my own was not an easy task. I have time, but I like to spend it wisely.