Work in progress, I'll write this up properly when I'm done.
Almost all credit goes to @maxogden for putting me on to this and pointing me in the right direction for each of these items.
Prerequisites:
- Raspberry Pi
- Kindle Paperwhite freed from its locked down state (jailbroken) http://www.mobileread.com/forums/showthread.php?t=198446
- Kindle Unified Application Launcher (KUAL) http://www.mobileread.com/forums/showthread.php?t=203326
- Extend - additional command line tools, including a proper openssh client http://wiki.mobileread.com/wiki/Kindle_Touch_Hacking#Additional_command-line_tools:_.22Extend.22 - this was a pain to get right, the install instructions aren't great but you need to end up with a mount.sh and unmount.sh that mount and unmount the extra stuff in /opt/.
- KTerm https://github.com/bfabiszewski/kterm - grab the custom build @maxogden requested for landscape mode here: bfabiszewski/kterm#2 (comment) - you need to set this up in KUAL in the /mnt/us/extensions/ directory so you can launch "kterm" from the launcher.
- Automatic console login on the Raspberry Pi, put this in your /etc/inittab in place of the existing
1:entry:1:2345:respawn:/bin/login -f <YOURUSERNAME> tty1 /dev/tty1 - Automatic
screensession start on login on your Pi, put this in your ~/.bash_profile:
if [ -z "$STY" ]; then
exec screen -xR
fiOptional:
- SSH over wifi http://wiki.mobileread.com/wiki/Kindle_Touch_Hacking#SSH_access_over_Wifi I disabled USBNet because I want to use my Kindle as normal via USB but SSH via Wifi is enabled full-time so I can log in to it whenever I like. I also have my pubkey in authorized_keys.
- Type
~dsinto the search bar on the Kindle to disable screensaver while you're working. A reboot will undo this.
Note that there is a kterm commandline option to toggle the keyboard (-k0) but for the current build of landscape kterm it doesn't quite work properly so I prefer to leave the keyboard showing on startup and then tap with 2 fingers and select "Toggle keyboard" to get rid of it. The 2 finger tap will also let you kill the kterm and toggle a few other things.
Remember that you're only using screen for the shared session so doing Ctrl-A stuff to switch windows is going to cause problems because your Pi console might switch but your Kindle terminal won't so you'll be out of sync. Just use it as a single console. Use Ctrl-Z and fg %X to switch between programs and you'll be fine.
Because the terminal size is kind of awkward, especially when you change the font size, you'll probably want to set your terminal width settings with the stty command, mainly for the "columns". For the font size I like I've found that a column width of 72 does the trick so things fit on properly and I get proper wrapping: stty columns 72. You may want to tinker with this a little to make it just right for you. You may also need to restart your kterm session and/or restart programs you have running to make them adjust properly.
The following files need to be placed in this structure:
/mnt/us/extensions/kindleberrypi/config.xml
/mnt/us/extensions/kindleberrypi/menu.json
/mnt/us/extensions/kindleberrypi/etc/id
/mnt/us/extensions/kindleberrypi/bin/kindleberrypi.sh