Skip to content
shabuninPublic

About

A terminal, ssh client, reader, notebook, for my Kobo Elipsa. Go, e-ink, FBInk.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

hello bro

A terminal, a Linux, books, notebooks and a calendar on a Kobo e-reader. Bring a Bluetooth keyboard, or use your fingers and the pen.

vim, git log and htop in tmux on a PC, over SSH Wi-Fi, Sharing, Bluetooth and Settings, tiled

The launcher: terminals, books and notebooks, settings, the Kobo, as tiles for a finger

hellobro takes the screen over from Nickel, draws its own e-ink UI, and gives Nickel back when you leave. It's built for the Kobo Elipsa (N604) and written in Go.

What it does

  • Windows like i3: tiling, workspaces, i3's keys and IPC
  • Terminals: SSH to your computers, or Alpine Linux on the Kobo
  • Books: EPUBs and PDFs, with dictionaries
  • Notebooks: write with the pen; an AI that answers your handwriting, if you like
  • Calendar: events and tasks, synced over CalDAV or from Google; the agenda on the sleep screen
  • Music: Linux players in Alpine, to Bluetooth headphones
  • Settings: Wi-Fi, Bluetooth, the battery, file sharing, updates over Wi-Fi

Install

You need NickelMenu on the Kobo.

  1. Download hellobro-<version>.zip from the latest release.
  2. Connect the Kobo over USB and unzip the file into the top of its drive (it holds a hidden .adds folder).
  3. Eject it and open Hello Bro from NickelMenu.

To leave, swipe down the right edge and tap quit (or Mod+Shift+E).

Updates

Pair your computer once (Settings, Sharing, pair, then ssh -p 2022 kobo.local and type the code). After that:

scp -P 2022 hellobro kobo.local:/mnt/onboard/.adds/hellobro/hellobro.new
ssh -p 2022 kobo.local hellobro-update

From source (podman needed): make, then make push.

Getting around

  • Mod+Enter: a new window (Mod is the Win key)
  • Mod+D: go to anything
  • Swipe the left edge: the light; the right edge: the menu
  • Tap the top bar: all the workspaces

Everything else is in the docs.

Docs

License

GPL-3.0-or-later. It links in FBInk by NiLuJe (GPL-3.0-or-later, see third_party/fbink) and carries Gentium Book and STIX Two Math under the SIL Open Font License 1.1 (third_party/fonts).

About

A terminal, ssh client, reader, notebook, for my Kobo Elipsa. Go, e-ink, FBInk.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages