~sotirisp/kindleto

A Gemini proxy for Kindle e-readers

c8c5622 Add support for the Gopher protocol

23 days ago

ef7d631 Increment version to v0.6.2

23 days ago

#kindleto

kindleto is a Gemini and Finger protocol proxy for older Amazon Kindles. It allows accessing Gemini and Finger through the Kindle's web browser. Local files can be opened using the file:// URL scheme. It is based on the Gneto proxy.

#Supported devices

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.

#Kindle setup

You will need a jailbroken Kindle with the USBNet hack installed. For more information on how to do this see here and here.

The 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 variable KINDLE_SSH_HOST to that name as shown in the following examples.

#kindleto setup

The 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 homepage. Follow the Help link at the bottom of any page to see help about configuring kindleto.

#Contact

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.

#License

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.