kindleto has been tested on the following devices:
It probably works on all Kindle 3 versions and possibly other Kindles too. The
installation procedure and the init script
kindleto-init are what might need
to be changed to support more devices.
kindleto setup will be easier if you setup SSH key authentication for the
Kindle. Then add an entry for your Kindle in
~/.ssh/config, something like
Host kindle User root HostName 192.168.1.115 IdentityFile ~/.ssh/kindle PasswordAuthentication no
If you want to use a name other than
kindle, make sure to set the environment
KINDLE_SSH_HOST to that name as shown in the following examples.
kindleto dependencies are a POSIX system, Go, GNU Make, an SSH client and
rsync for installation over SSH. After your Kindle is set-up and connected to
the same network as your computer run the following commands
# Build kindleto and copy/create any other required files make # Copy all required files on the Kindle using rsync make install # Install on a host named seal in ~/.ssh/config env KINDLE_SSH_HOST=seal make install
and then restart your Kindle. Visit 0.0.0.0:1965 with
the Kindle's browser and you should see the
kindleto configuration files are in the
kindleto directory accessible
over USB or in
/mnt/us/kindleto over SSH. You can customize the homepage by
web/index.gmi and override the CSS by creating
Gemini client certificates are stored in
certificates and private key files should be named after the host they apply
to and have a
.key suffix respectively. For example:
/mnt/us/kindleto/certificates/ ├── astrobotany.mozz.us.crt ├── astrobotany.mozz.us.key ├── example.com.crt └── example.com.key
Report bugs in the bug tracker, discuss development and ask for help in the kindleto-discuss mailing list and send patches in the kindleto-devel mailing list. Project announcements will be posted in the kindleto-announce mailing list.
Copyright 2020 Paul Gorman
Copyright 2021-2022 Sotiris Papatheodorou
This program is Free Software: You can use, study share and improve it at your will. Specifically you can redistribute and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.