The server component of the project to transforms your jailbroken Kindle into a customizable dashboard display. It works by periodically fetching images from a server at regular intervals.
Turn your jailbroken Kindle into a low powered dashboard. The system works by executing a script (dash.sh
) that periodically fetches PNG images from a Cloudflare worker and displays it on the Kindle's e-ink screen. I use this to show today's weather, arrival data for the bus stop next door and the day's timetable for my daughter's school. You can use it to display any other information you want to display in a low-power, always-on format.
This is the backend component of the project. For the client that runs on the Kindle please see this repo: kindle-dash-client.
- A free Cloudflare account
- Basic knowledge of JavaScript
- A spirit for adventure 🏴☠️
This project uses Cloudflare developer platform which has a very generous free tier perfectly suited for this use case. Get started with a free account at Cloudflare Dash.
I used Bun as the main development framework, but you can also choose use Node or Deno if that's your preference.
Wrangler is the workhorse of Cloudflare developer platform. It's open source and can be installed from Wrangler docs.
Cloudflare devs is a very active community and is very helpful. For advanced topics, refer to Cloudflare developers or the Cloudflare Discord Server.
-
Clone this git repo and cd into it.
-
Install Bun and npm, preferably using a Node version manager like Volta or nvm.
-
Install the dependencies:
bun install
-
Install Wrangler
npm install wrangler@latest
-
Create the KV Namespaces for live and preview. Replace these values with the values in the
wrangler.jsonc
file.npx wrangler kv namespace create SCHOOL_DASH_KV npx wrangler kv namespace create SCHOOL_DASH_KV --preview
-
Create a secret in the Cloudflare dashboard for the API key.
-
Start the local development:
npx wrangler dev --remote
-
The changes will be live on
localhost:8787
-
Deploy the changes to your Cloudflare dash:
bash npx wrangler login bun run deploy
This project is licensed under the MIT License - see the LICENSE file for details.
- The Kindle jailbreak community for making projects like this possible
- Hemant @ Terminal bytes
- Pascalw and his Kindle Dash project