Homey.ink, an e-ink Homey dashboard

Yesterday Athom showed their Hacky Friday Project “Homey.ink, an e-ink Homey dashboard”

Read about it in their Blog and here

To centralize, please keep info about your DIY project expansions on this in this thread and show us the results!

As the Kobo H2O presentation didn’t show nice om my Kobo Aura HD that was lying around it needed an own theme. Today I forked it, cloned it local on my Windows and learned myself some CSS code to fix it for my Kobo Aura HD that was lying around.

Here the report and instructions how to do that:

[WIP - have to write it…]

Current themes:

  • Kobo Aura H2O ( ?theme=kobo-h2o )
  • Kobo Aura HD ( ?theme=kobo-aura-hd )
  • Web browser ( ?theme=web )

so copy the URL from the developer inspect console and just change that part of the URL


[FAQ] about Homey.ink, an e-ink Homey dashboard

  • I found an small error in the original instructions, Start your local Server with serving the app folder:
    serve -p 5000 <Pathe-to-your-local-copy\homey.ink\app (or references don’t work…)

  • Then your local URL reference will look more like the online one, Remove the app/index.html from it, it will now be: (These two are reported to Athom, probably fixed :soon: Now:
    http://localhost:5000/?token=YOUR_TOKEN&theme=YOUR_THEME .

  • Both Kobo’s need a rotation, developing local in Chrome doesn’t, remove in the 11th line the 9 from the rotate(90deg) and you are done for local testing! replace it back before going to production :wink:
    -webkit-transform: rotate( *9* 0deg) translateX(180px) translateY(180px);

  • Trying the page from your device it needs the IP of your developing computer! Where localhost always point back to the computer you work on, I replaced it with the IP Address in the URL to test it from the Kobo. http://****:5000/?token=YOUR_TOKEN&theme=YOUR_THEME .

  • Then probably it will not work as your good protected Computer blocks it in the firewall and/or Windows Defender. Open an Powershell as Administrator and past, New-NetFirewallRule -DisplayName "Enable Serve Inbound Port 5000" -Direction Inbound -LocalPort 5000 -Protocol TCP -Action Allow -Program "C:\program files\nodejs\node.exe" -Profile Any Now it should work (and saver than disabling the complete Firewall!)

  • Kobo themes use a rotation to support landscape presentation on the browser that by itself does not support rotation. See the line with -webkit-transform: rotate(90deg) in the /app/css/themes/[themename].css file.

1 Like

The results on my Kobo Aura HD

I immediately have to addmit I am not an CSS guru!
I just do something until it looks nice for me. and Probably al lot of CSS code can be optimized.

Anyway, I want to share the result and I created a Pull Request to share if from Emiles official repository!
Use it, learn form it, help me to learn CSS and optimize or re-use it and show us your results!

My code is now here:

The “Screenshot” is made on Windows as I don’t know how to do that on the Kobo.
Below the Pictures also some device specific Tips!

And on the device with Backlight on!

(btw: The temperature above was a joke, there is no decimal in the Athom dashboard possible :wink: )


1 Like

How do you run it on your pc? I can’t get it to work properly on my pc so i can play around with css

1 Like

Instructions from Github,
See tips now available above … Serve the right folder (bug/incorrect doc.) and Enable traffic thru Firewall.

Good luck!

Sorry wasn’t clear. I meant running the homey.ink directly. how to get the token etc I don’t have a kobo but wanted to see what it looks like on pc

I guess this is a Windows issue, on macOS it works just like the README suggests.

To get the token:

  • visit https://homey.ink and open your browser’s developer tools (I use Chrome)
  • scroll down to “Setup instructions” and log in with your Athom account
  • after logging in, look at the developer tools console, which should contain a log entry that looks something like this:image
  • right-click on that URL to copy the link address to the clipboard
  • paste into a new text file (or something) to see the full URL, and change https://app.homey.ink to http://localhost:5000; the result is the URL that you can use to access the server running on your local PC

Emile created today a Web theme for Ink and accepted my theme for the Kobo Aura HD.

Current themes:

  • Kobo Aura H2O ( ?theme=kobo-h2o )
  • Kobo Aura HD ( ?theme=kobo-aura-hd )
  • Web browser ( ?theme=web )

so copy the URL from the developer inspect console and just change that part of the URL

an example of the web theme from Emile is here:

(made with Coherence on a Mac.)

EDIT: Just to inform,
Tested the Web theme on other ahum… browsers: IE, Edge and also FireFox don’t work correct at the Moment. Not sure if/when this will be fixed!

For me it works good on Chome!

1 Like

Maybe a stupid question,

But is this not just a web page wich can also be used using a tablet??

Correct, but the token does’t expire and you have only limited access so safe for a dashboard based on an eReader or a tablet.

Easy installation!

I think this looks quite interesting. But it would be nice if you could have different favourite flows and devices on the tablet/dashboard compared to your phone app.
Maybe you’d like to have several tablets around the house or just have different devices than your phone.

From what I understand this is not possible today, or am I wrong?

Make 17 extra users on ur Homey. All can have different favorite devices. Log in with another user on another tablet and u can make 18 different tablets


anyone an idea why favorite devices can only be real devices? (like lights or switches)
I added the the Thermostat, couple of thermometers an doorcontacts to my favorite devices but that don’t show up in the dashboard

anyone an idea?

Just on/off devices for now

1 Like

It was a hacky Friday project, so 1 day only.
Adding all views to control all other types of devices will take several more weeks.

1 Like

How I would love to have more programming skills and pick it up where you left it… :wink:

Great work!!

Love it!!


A post was merged into an existing topic: Homey.ink on an Ipad

That Homey.ink works perfectly on my Raspberry Pi. Now I can finally use my Pi again as a dashboard