Making your very own LightingPiggy is squealy easy. Here are the steps you need to follow:

  1. Source the parts.
  2. Create a wallet.
  3. Flash the firmware.
  4. Make a case and assemble the parts.
IMPORTANT: This is not a toy. It contains small parts which could be a choking and ingestion hazard. There are also sharp edges. It should not be handled by children under 4 years of age. Assembly and use of this product is at your own risk. We take no responsibility for any losses that may be incurred.

1. Source the parts

Single Board Computer (SBC): LILYGO T5 V2.3.1 (2.13 inch screen) e-paper device (DEPG0213BN). Available from LILYGo

Rechargeable battery: Voltage: 3.7V Connector: Jst 2pin 1.25mm. Available from Aliexpress

Case: One homemade case using materials of your choice.

IMPORTANT: Improper assembly and/or the use of improper/faulty batteries can present a fire hazard. We recommend using only high quality LiPo rechargeable batteries.

Before connecting the battery check the connector is correctly wired. The red wire needs to align with the positive "+" terminal, and the black wire needs to align with the negative "-" terminal. If the battery you have sourced has the polarity switched, it's possible to swop the wires by carefully lifting the plastic JST connecter retainers.

Before connecting the battery check the connector is correctly wired.

Note: The device can operate without a battery if powered via using the micro USB port.

Here's an image showing your piggy's controls:

LightningPiggy's Controls

2. Create a wallet in LNbits

IMPORTANT: LNbits is in Beta. We are not responsible for the LNbits software stack, extensions and any funds that may be lost.

Create a bitcoin lightning wallet that works with LNbits. We're using this instance for testing and small amounts.

A wallet list should be show on the lefthand side of the page (1), if not expand the page, or click the burger icon in the top lefthand corner of the screen (2).

Give your wallet a name using the "Rename wallet" button (3).

Under the "Wallets" header should be "Extensions" (4). Click this and find the "LNURLp" extension (5). Enable it by clicking "Enable".

Now the LNURLp extension will appear under your wallets' list (6). Click it and select "New Pay Link" (7).

Choose your wallet from the dropdown list, give it a description (8), adding a Lightning Address is optional. Deselect "Fixed amount" (9) and configure the "Min" and "Max" amounts of satoshis your wallet can receive.

We suggest using 1 Min and 10,000,000 Max (10). Click to expand the "Advanced options" area, and enter the maximum number of characters you wish to allow when someone leaves a message with a payment in the "Comment maximum characters box" (12). We recommend using 100. Click "Create Pay Link" to save the settings.

Your LNURLp payment link will now be attached to your wallet. Now click on your wallet name (13) and expand the API docs list on the righthand side of the page (14). Select and copy the "Invoice/read key" (15) associated with this wallet, you'll need it in step 3 below, "Flash the firmware".

3. Flash the firmware

Use our custom built web installer to configure and flash the firmware to the device.

You will need the following credentials:

Your wifi "ssid" and "password"

Your "server name" eg ""

Your "invoice/read key" eg "db400dfba...." (copied from your LNbits Wallet API toggle)

Works with Google Chrome or Microsoft Edge.

4. Make a case and assemble the parts

Time to get creative! Build your very own LightningPiggy case out of any material you wish to use, and assemble the parts.

IMPORTANT: When installed correctly, the battery and/or board components should not get hot when it is being charged, i.e. the USB is connected to power and the battery is installed.

Check out our new case options.

If you would like to share your design with others, please email your creation to for inclusion on this website.

Join our telegram chat for help or inspiration, or to share your work with other LightningPiggy builders.

Community group for the LightningPiggy FOSS project