https://github.com/ruedigerblock/koreader-vagrant

Creates a Fedora Box with a KOreader Installation
https://github.com/ruedigerblock/koreader-vagrant

koreader vagrant vagrant-box

Last synced: about 1 month ago
JSON representation

Creates a Fedora Box with a KOreader Installation

• Host: GitHub
• URL: https://github.com/ruedigerblock/koreader-vagrant
• Owner: ruedigerblock
• Created: 2024-11-05T15:53:27.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-11-05T16:39:46.000Z (3 months ago)
• Last Synced: 2024-11-13T18:38:10.218Z (3 months ago)
• Topics: koreader, vagrant, vagrant-box
• Homepage:
• Size: 3.01 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# koreader-vagrant

This `Vagrant` file creates a `qemu` Virtual Machine and installs [KOReader](https://github.com/koreader/koreader) in it.

The main purpose is to have a KOReader working on MacOS without the necessity to build the source code.

Vagrant is used to download a Fedora Cloud Image and to configure it to automatically install KOReader and a Systemd Service File to start KOReader when the machine is started.

This setup assumes that there is folder `Bibliothek` present in the Users Home Directory, which will be mounted in the Machine.

KOReader reads documents from it **and** stores its configuration there.

Has been tested on x86_64 MacOS 15.0.1 (Sequoia).

## Dependencies

- `qemu` (`brew install qemu`)

- `vagrant` (`brew install vagrant`)

- `vagrant-qemu` (`vagrant plugin install vagrant-qemu`)

- `tigervnc-viewer`(`brew install tigervnc-viewer`)

## Usage

Install Dependencies, clone Repository and execute:

`vagrant up`.

After Provisioning you should be able to connect to `/tmp/koreader-vnc` VNC socket via your favorite VNC viewer.

## Screenshots

- ![Connect via TigerVNC](screenshots/TigerVNC.png)

- ![Latest KOReader Installation](screenshots/KOReader.png)

- ![Little Brother](screenshots/little-brother.png)