quill/README.md

58 lines
4.3 KiB
Markdown
Raw Normal View History

2022-01-26 09:38:21 -08:00
# InkBox
2024-01-05 10:05:40 -08:00
<img src="https://github.com/Kobo-InkBox/inkbox/blob/master/screenshots/homepage.png?raw=true" width="30%"></img> <img src="https://github.com/Kobo-InkBox/inkbox/blob/master/screenshots/reading.png?raw=true" width="30%"></img> <img src="https://github.com/Kobo-InkBox/inkbox/blob/master/screenshots/library.png?raw=true" width="30%"></img>
2021-11-23 20:05:59 -08:00
## About InkBox
2021-11-27 11:11:15 -08:00
InkBox is an open-source, Qt-based eBook reader for Kobo devices. It also comes as an entire [native open-source OS](https://github.com/Kobo-InkBox/rootfs) and provides support for a number of devices.
2021-08-03 09:19:42 -07:00
<br>
2021-11-25 07:36:15 -08:00
InkBox features:
- Full integrated KoBox X11 subsystem
2022-01-26 09:38:21 -08:00
- ePUB, PDF, pictures and plain text display support
2021-08-03 09:19:42 -07:00
- Versatile configuration options for reading
2022-04-10 18:42:26 -07:00
- muPDF rendering engine for ePUBs and PDFs
- Wi-Fi support and web browser (NetSurf)
2021-11-20 21:17:01 -08:00
- Encrypted storage with EncFS
- Fast dictionary & local storage search
2021-08-03 09:19:42 -07:00
- Dark mode
2021-08-25 11:05:43 -07:00
- Strict security policy ensuring that only signed software can be run on the device (this, however, can be adapted to your needs by recompiling the [kernel](https://github.com/Kobo-InkBox/kernel))
2021-08-03 09:19:42 -07:00
- Full factory reset option if needed
- Seamless update process
- VNC viewer app
- Search function
2022-04-10 18:42:26 -07:00
- 10 built-in fonts
2023-02-28 12:02:45 -08:00
- Enhanced power management
2022-04-10 18:42:26 -07:00
- Lock screen/passcode option
2021-08-03 09:19:42 -07:00
- User-friendly experience
2021-11-23 20:18:46 -08:00
## How do I install InkBox?
2022-01-26 09:38:21 -08:00
You can download precompiled OS/binaries [here](http://23.163.0.39/bundles/inkbox/native/) and standard Nickel add-ons (outdated, unmaintained) are available [here](http://23.163.0.39/bundles/inkbox/nickel/), although support for them has been stopped until further notice. Huge thanks to [@fermino](https://github.com/fermino) for providing free hosting.
2021-08-03 08:41:32 -07:00
<br>
2021-11-28 14:21:42 -08:00
On Windows, use [balenaEtcher](https://www.balena.io/etcher/) to flash the InkBox image file to the Kobo's SD card.
2022-01-26 09:38:21 -08:00
On Linux and MacOS, [balenaEtcher](https://www.balena.io/etcher/) is the easiest option for command-line-reluctant users.
Alternatively, you can also open a terminal and check the device node of the Kobo's SD card with `fdisk -l`. Then `dd` the image to the SD card like this:
2021-11-23 20:05:59 -08:00
2021-08-03 08:41:32 -07:00
```
2022-01-26 09:38:21 -08:00
xzcat inkbox.xz | dd of=/dev/mmcblk0
2021-08-03 08:41:32 -07:00
```
2022-04-20 18:01:26 -07:00
<b>IMPORTANT:</b> InkBox OS does NOT provide ANY WARRANTY at all and we are not responsible if you brick your device with one of the factory images or update bundles available online. See [legal information](https://github.com/Kobo-InkBox/inkbox/blob/master/LEGAL.md) for more details.
2022-01-23 14:57:45 -08:00
## How do I upgrade InkBox?
2022-05-03 19:45:00 -07:00
To upgrade InkBox, go to http://23.163.0.39/bundles/inkbox/native/update/ and copy the files for your device onto the `.inkbox` folder in the USB storage partition.
2022-01-26 10:14:13 -08:00
**Note**: Prior to version 1.6, InkBox had to be upgraded one version at a time. If your device's factory image ships with version 1.5, you need to closely follow the upgrade instructions [here](http://23.163.0.39/bundles/inkbox/native/update/1.6/HOWTO-Update).
2022-01-23 14:57:45 -08:00
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.
2022-01-26 09:38:21 -08:00
## I want to learn more about this!
2024-01-28 09:29:45 -08:00
I suggest you visit the [wiki](https://github.com/Kobo-InkBox/inkbox/wiki). Feel free to contribute if you think you have something valuable to add.
2021-08-03 08:41:32 -07:00
## How can I contribute?
2024-04-02 13:46:18 -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 when I have time. You can also join the official [Matrix space](https://matrix.to/#/#inkbox-os-project:matrix.org), [Discord server](https://discord.com/invite/uSWtWbY23m) or [Linen](https://www.linen.dev/s/quill-os) if you'd like to chat a bit.
2021-08-03 08:49:16 -07:00
<br><br>
2024-01-09 07:27:29 -08: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 at my [PayPal account](https://paypal.me/inkboxos/), [LiberaPay](https://liberapay.com/tux-linux/), or via Bitcoin: 3MmXq5o78b4C7ub5sb7F5WVC86jzc6PzSN . I'm a student and motivation has been the only thing that has helped me maintain this project for the last few years. Developing an entire operating system on my own was not an easy task. I have time, but I like to spend it wisely.
## Building
Make sure you have the following requirements installed on your system:
* a c/cpp profiler
* `libsndfile-dev`
Next open the `inkbox.pro` file qith QTCreator