MichaelMassie.com/projects

Project Journal

14 November 2026

Duet: A 3d Printed Ereader And Music Player

An open-source, Kindle-sized ESP32 build with a book on one side and an MP3 player on the other.

I wanted one device that does two things well: read books on e-ink for weeks between charges, and play my own music files over Bluetooth or a headphone jack, with no phone, subscription or app. I couldn’t find one, so I’m building it. It’s called Duet, and it’s open source under GPL-3.0.

Repo: github.com/mmassie/duet-media-player

What it is

Duet is a Kindle-sized, 3D-printed folio. It has a 6-inch e-ink screen, three physical buttons, a battery, and a microSD card for books and music. A switch on the side powers the music side on and off.

Why two boards?

The Inkplate has an ESP32, so it seems like it could play music too. It can’t do it comfortably:

  1. Bluetooth audio needs the original ESP32. A2DP isn’t available on the newer ESP32 variants. The HUZZAH32 is a classic ESP32, so it handles audio.
  2. Decoding MP3 and refreshing e-ink compete for time. A full-screen e-ink refresh takes the better part of a second. Audio buffers don’t wait for that.

Splitting the work means the music keeps playing while you turn pages, and each board runs a simple loop. They talk over I²C through a Qwiic cable, using a small checksummed protocol that’s identical in both sketches (duet_link.h).

The interface

I wanted both halves to feel like one product, so Books and Music share a single visual language.

Books come from EPUB files. The reader unzips them on the device, inflates the chapters, walks the OPF spine, and caches clean text, so page turns after the first open are fast.

What works, and what doesn’t yet

I want to be honest here, because this is a build log and not a product page.

Checked so far:

Not yet done:

Build it, break it, send fixes

Everything is in the repo: firmware for both boards, the OpenSCAD source with exported STLs, the Duet wiring diagram, the design mockups, and a README with the bill of materials and print notes. If you build one, the most useful things you can send me are:

I’ll post a follow-up once the first prototype is assembled and running.

Duet is GPL-3.0. Issues and pull requests are welcome.

tags: project