PiE-Ink Name Badge




About: It's dark. You are likely to be eaten by a grue.

Want to decorate your chest with something amazingly dorky? Want to stand out in a crowd? How about earn some serious geek cred, and the wonderment of your peers?


Introducing the PiE-Ink Name Badge - a Raspberry Pi Zero Python Powered E-Ink Linux Name Badge (what a mouthful!). A full wearable linux computer system on your chest!

This guide will take you through procuring the necessary components, putting them together, and coding the device - from beginning to end.

Beginners may want to take on an easier project - as this requires soldering, some linux-knowledge, coding, and is generally a little more complex. But hey - who am I to stop you? Do what you want!


Step 1: Parts List

The Basics

1. Soldering Iron - Order here

2. Solder - Order here

3. 30 AWG Wire - Order here

4. Helping Hands - Order here

5. USB or Bluetooth Keyboard - Order here

6. USB Wi-Fi Dongle (ignore if buying Pi kit with one included) - Order here

Specific Components

1. Raspberry Pi W Kit - Order here
OR Raspberry Pi Zero 1.3 Kit - Order here or here

2. Adafruit Powerboost 1000c - Order here

3. PaPirus 2" e-ink Hat - Order here

4. Mini Slide Switch - Order here

5. Micro USB Hub - Order here

6. Lipoly Rechargable Battery - Order here or here

7. USB LiPoly Charger - Order here

8. Adhesive Putty - Order here

9. Magnets - Order here

Optional Upgrades

1. Clear nail polish for weatherproofing - Order here

2. 3-D Print an enclosure - Find or make one here

3. Use a Pi RTC module to display time - Order here

4. Resistors for optional safe shutdown procedure - Order here

5. Super nice helping hands upgrade - Order here

6. PCB Vise - Oder here

7. Wire Stripper - Order here

Step 2: Solder GPIO Header Pins to Pi Zero

  1. Get your soldering iron nice and hot!
  2. Put on some tunes, and solder all 40 pins of those pins to your raspberry pi zero. It helps to hold things in place with your vise, helping hands, tape, or any combination of the those.

Step 3: Solder and Mount Powerboost 1000c to Pi

  1. Strip some 30 AWG wire on both sides
  2. Solder the contacts just to the left/bottom of the + on the 1000c to the PP1 contact on the Pi Zero. Then, solder the contact just to the top/right of the - on the 1000c to the PP6 contact on the Pi Zero. Reference the screenshot if you need help.
  3. Mount the powerboost 1000c onto the pi zero board with some putty adhesive, electrical tape, or Sugru if you want something a little more permanent.

NOTE: We will remove the wire contacts from the board in an upcoming step once we install the switch. Easy peasy! Don't worry about it for now.

You are now able to power your raspberry pi with a lipoly battery, and use a MicroUSB charging cable to both power the board and charge the battery at the same time. WOW! Those Adafruit Powerboost boards are pretty handy, aren't they?

For more information on pinouts, assembly and schematics regarding the Adafruit 1000c, you can visit their official product page here.

For information on wiring for safe shut down (not part of this tutorial), you can visit this page here.

Step 4: Connect and Mount PaPirus E-ink Hat to Pi

  1. Connect the PaPirus hat to the GPIO header pins you soldered earlier.
  2. Snap the screen of the Papirus into the hat (flip up the brown cover, push into place, snap back). Use some putty adhesive or the included sticky tape to get the screen to stay in place.
  3. Use the plastic screws and mounts that came with the PaPirus hat to screw together the boards and hold them in place. You may not be able to get them all in, due to the Powerboost 1000c. This is fine.

Step 5: Solder and Mount Mini Switch to Pi Zero

  1. Remove the ends of the wire we connected to the Pi Zero contacts earlier. Connect the positive lead to the rightmost contact of the switch, and the ground to the middle contact of the switch.
  2. Strip some more 30 AWG wire on both ends, and solder them from the contacts you just connected to the appropriate contacts on the pi zero.
  3. Use adhesive putty, electrical tape or sugru to put fasten the miniswitch against the board securely.

Step 6: Connect to Your Pi - Install & Update Software

  1. This is not a 'how to install a raspberry pi operation system' guide. For information on how to get started, goolge some quickstart guides. I recommend you use win32 disk imager and the new Raspbian Pixel OS.
  2. Be sure to use raspi-config to expand your file system, turn on SPI, I2C, and optimally VNC so you don't have to keep using a monitor and USB keyboard.
  3. Make sure to change your default password, hostname (if you want), and localization/timezone options.
  4. Connect to your wireless network, and update your raspbian OS using these commands:
    sudo apt-get update -y && sudo apt-get upgrade -y
  5. This will take quite some time. Reboot once finished.
  6. Follow the set-up instructions here to get everything ready and working for your Papirus Hat E-Ink module. If you did everything right, you should only need the following commands:

    curl -sSL https://pisupp.ly/papiruscode

    | sudo bash
    sudo papirus-set 2.0
  7. If you are using a size other than the 2" E-Ink screen, be sure to specify something else of course.
  8. Reboot the Pi after successful installation (sudo reboot).

Step 7: Edit Script + Images to Your Liking

  1. Download the files I've hosted for you on my github.
  2. You'll notice all the image files are 2 bit, 200x96, and greyscale. You can use my images to test. If you'd like to make your own, you'll need to edit them into that format to be used by the PaPirus.
  3. An easy way to make your own photos is to use the free application Photo Filtre 7. Once you have it installed and the images you want sized correctly, simply go to Filter -> Color -> Gray Scale -> Click 'Ok'.
  4. Edit the badge.py script to point to the directory you'd like to use. Here is the one I use:
    projectPath = '/home'pi/Desktop/badge/'
  5. Edit the image names under the while loop starting on line 77 to match the images you've created in your folder. You can edit the sleep timers to change how long the image remains on the screen, or the other functions documents on the PaPirus github. Get creative!

    BONUS: If you'd like to make the buttons on the PaPirus hat function, use something like this:

    while True:
    if GPIO.input(SW1) == False:
    draw(papirus, 'Photo-Name.bmp', "Name: Francesco\r\n" + "Surname: Vannini")
    else if GPIO.input(SW2) == False:
    draw(papirus, 'DireStraits.bmp', "Favourite band:\r\nDire Straits")

Step 8: Set Script to Auto Launch

  1. Follow the instructions here to create a cron task to auto-launch our script on reboot.
  2. Do not skip any steps, as it is crucial you follow to a T.
  3. Once you've created the cron task, be sure to test the script by rebooting.
  4. If you somehow get stuck, pressing CTRL-C can exit the script.

Step 9: Attach Magnets - YOU'RE DONE!

  1. Attack magnet(s) to the back of the battery, then connect them to the inside of your shirt. I'm using two smaller ones because they're what I had on hand - you can choose to use one single bigger one if you'd like.
  2. You should now have a fully functional PiE-Ink Name Badge!
  3. The battery will last 4 - 5 hours on a single charge. Be sure to charge it regularly and safely by disconnecting the lipoly battery from the PowerBoost 1000c, and charging it from the USB lipoly battery charger I recommended you purchase at the start of the guide.
  4. The Adafruit Powerboost 1000c you soldered onto the board will charge the battery as well while plugged into a power source, but I find the board can get hot and cause damage to the components connected to your new device. It's best to follow step 3 whenever possible. Of course, you can disregard if you feel the heat is not that great, or take additional steps to dissipate the heat from the board (heatsink, etc).

Step 10: Extra Credit - Optional Upgrades + Ideas + Links

  1. Use a board with built-in wifi, or solder on a wifi adapter. This way, you can connect to the internet and display information like weather, stocks, time/date etc.
  2. Solder on an RTC module and make a permanent time display as part of your cycle or one of the button pushes.
  3. Use a solar powerbank to go completely green!
  4. Safely shut down your Pi instead of switching it off and on completely.

Microcontroller Contest 2017

Participated in the
Microcontroller Contest 2017

Make it Glow Contest 2016

Participated in the
Make it Glow Contest 2016



    • Sensors Contest

      Sensors Contest
    • 1 Hour Challenge

      1 Hour Challenge
    • Fandom Contest

      Fandom Contest

    20 Discussions


    11 months ago

    works for me. Tried push F4 for bigger screen because my eyes are sour. Altough happy enough with this.


    1 year ago

    I have purchased the product from here https://core-electronics.com.au/pi-supply-papirus-zero-epaper-eink-phat-v1-2.html

    and am unable to make it work

    Pi Supply PaPiRus Zero ePaper/eInk pHAT v1.2 problem

    after installing software from here https://github.com/PiSupply/PaPiRus1 and executing papirus-test I have

    root@raspberrypi:~# papirus-test
    Assuming this is a PaPiRus Zero board

    ---- Detect temperature sensor and RTC (RTC for HAT only) ----
    NXP LM75BD detected at: 0x48

    ---- Screen Information ----
    Temperature from sensor: 29 degrees Celsius
    Panel info: EPD 2.0 200 x 96 version=4 COG=2 FILM=231

    The screen might be broken, cannot continue further
    I have ordered another display https://core-electronics.com.au/pi-supply-papirus-zero-epaper-eink-phat-v1-2.html2

    If you have any hints, can you kindly advice?


    1 year ago

    Step 8.1 is no longer functioning.

    Why does the screen/Pi get stuck on the "booting" screen portion of the badge.py script?

    2 replies

    Reply 1 year ago

    Hi there - I've verified that this still works. Have you double-checked all your code, and made sure nothing was mistyped or commented out by accident?


    Reply 1 year ago

    8.1 is working on my end now, thanks.

    Not sure what happened, but it started to work with your .bmp's. Now I'll replace them with ones I created.


    Reply 1 year ago

    Nope! But there are several stl files you can find out there for raspberry pi zero cases, with some extra room. Try thingverse!


    2 years ago

    Step 6.6 is no longer functioning. It's using a goo.gl shortened URL which is supposed to bring up the commands needed to install all the papirus code. However the url re-directs to some really odd site... which in turn comes back to some dns purchasing site (perhaps the domain registration expired?)... please use the curl statement provided by the papirus web site on their github page.
    e.g. curl -sSL https://pisupp.ly/papiruscode | sudo bash

    3 replies

    Reply 2 years ago

    Hi there - thanks for the reply. Instructables sometimes automatically shortens URLs for some reason. I caught that, and have changed it. Appreciate the heads up.


    Reply 2 years ago

    Dude - you totally just made my week :) Thank you, and I hope you don't mind that I shared this with some friends! :)


    Kartik Bholla

    2 years ago


    Can you explain the use of PowerBoost 1000 LiPo charger here, if we are using a usb LiPo charger.


    2 replies
    esper2142Kartik Bholla

    Reply 2 years ago

    Hi there As explained in step 9:

    The Adafruit Powerboost 1000c you soldered onto the board will charge the battery as well while plugged into a power source, but I find the board can get hot and cause damage to the components connected to your new device. It's best to follow step 3 whenever possible. Of course, you can disregard if you feel the heat is not that great, or take additional steps to dissipate the heat from the board (heatsink, etc).

    Kartik Bhollaesper2142

    Reply 2 years ago

    Thank you appreciate for the reply. I've ordered the e-ink display, excited for the built :)


    2 years ago

    Now that the Pi Zero comes with Wifi it will make number one on your list easier. This instructable has given me more e-paper or e-ink ideas. Thank you.

    1 reply

    Reply 2 years ago

    Hey! Yes you're right :) I've edited the list to make it easier to find a place to order a kit. Thanks!


    2 years ago