# PyLeap CLUE Custom Conference Badge

## Overview

https://youtube.com/shorts/zp2lwVL9igA

In this project, you'll load the CLUE Custom Conference Badge project onto your CLUE using PyLeap. The badge has spots for your online handle, name, job title and pronouns. You can also display a QR code to link to your website on the fly.&nbsp;

However, a custom badge needs to be customized. To do that, you'll use the File Glider app to edit the text objects in the code with your details.

![](https://cdn-learn.adafruit.com/assets/assets/000/115/729/medium800thumb/projects_badgeQR_1.jpg?1665002140)

## Original Project

This&nbsp;[project was originally created by Kattni Rambor](https://learn.adafruit.com/clue-custom-circuit-python-badge/overview) to showcase the PyBadger CircuitPython library with the CLUE and the PyBadger. The code has been adapted to flip the display so that the CLUE can be hung upside down with the lanyard. You can check out the original Learn Guide for more information on how the code works.

[CLUE Custom CircuitPython Badge Learn Guide](https://learn.adafruit.com/clue-custom-circuit-python-badge/overview)
## Parts
### Adafruit CLUE - nRF52840 Express with Bluetooth® LE

[Adafruit CLUE - nRF52840 Express with Bluetooth® LE](https://www.adafruit.com/product/4500)
Do you feel like you just don't have a CLUE? Well, we can help with that - get a CLUE here at Adafruit by picking up this sensor-packed development board. We wanted to build some projects that have a small screen and a lot of sensors. To make it compatible with existing projects, we made...

In Stock
[Buy Now](https://www.adafruit.com/product/4500)
[Related Guides to the Product](https://learn.adafruit.com/products/4500/guides)
![Animated GIF showing CLUE board  displaying data from the many on-board sensors.](https://cdn-shop.adafruit.com/product-videos/640x480/4500-04.jpg)

### Adafruit Circuit Playground Lanyard

[Adafruit Circuit Playground Lanyard](https://www.adafruit.com/product/3987)
We've got our Circuit Playground friends on&nbsp;[lunchboxes](https://www.adafruit.com/product/3437),&nbsp;[posters](https://www.adafruit.com/?q=posters),&nbsp;[puzzle](https://www.adafruit.com/product/3817),&nbsp;<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/3987)
[Related Guides to the Product](https://learn.adafruit.com/products/3987/guides)
![Pink lanyard with Adafruit characters and metal hooks at ends](https://cdn-shop.adafruit.com/640x480/3987-00.jpg)

### Clear Acrylic Enclosure + Hardware Kit for Adafruit CLUE

[Clear Acrylic Enclosure + Hardware Kit for Adafruit CLUE](https://www.adafruit.com/product/4675)
Here is a chic&nbsp;minimalist enclosure for your **CLUE** board! This case&nbsp;has been laser-cut specifically to accommodate the TFT display, tactile buttons, and capacitive pads.

And of course, we include&nbsp;mounting hardware so you can assemble it right onto your CLUE...

In Stock
[Buy Now](https://www.adafruit.com/product/4675)
[Related Guides to the Product](https://learn.adafruit.com/products/4675/guides)
![Angled shot of a Clear Acrylic Enclosure + Hardware Kit for Adafruit CLUE.](https://cdn-shop.adafruit.com/640x480/4675-04.jpg)

### USB cable - USB A to Micro-B

[USB cable - USB A to Micro-B](https://www.adafruit.com/product/592)
This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller

Approximately 3 feet / 1 meter long

In Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
![USB cable - USB A to Micro-B - 3 foot long](https://cdn-shop.adafruit.com/640x480/592-01.jpg)

### 3 x AA Battery Holder with On/Off Switch, JST, and Belt Clip

[3 x AA Battery Holder with On/Off Switch, JST, and Belt Clip](https://www.adafruit.com/product/3287)
This battery holder connects 3 AA batteries together in series for powering all kinds of projects. We spec'd these out because the box is compact, and 3 AA's add up to about 3.3-4.5V, a very similar range to Lithium Ion/polymer (Li-Ion) batteries, plus it has&nbsp;a nifty&nbsp;on-off...

Out of Stock
[Buy Now](https://www.adafruit.com/product/3287)
[Related Guides to the Product](https://learn.adafruit.com/products/3287/guides)
![Angled shot of 3 x AA battery holder with on/off switch, JST, and belt clip.](https://cdn-shop.adafruit.com/640x480/3287-00.jpg)

### Alkaline AA batteries (LR6) - 3 pack

[Alkaline AA batteries (LR6) - 3 pack](https://www.adafruit.com/product/3521)
Battery power for your portable project! These batteries are good quality at a good price, and work fantastic with any of the kits or projects in the shop that use AAs. This is a pack of **3 AA batteries**.  
  
These batteries are Alkaline (MnO2) chemistry, with a voltage...

In Stock
[Buy Now](https://www.adafruit.com/product/3521)
[Related Guides to the Product](https://learn.adafruit.com/products/3521/guides)
![Angled shot of 3 AA batteries.](https://cdn-shop.adafruit.com/640x480/3521-00.jpg)

# PyLeap CLUE Custom Conference Badge

## CircuitPython on CLUE

[CircuitPython](https://github.com/adafruit/circuitpython) is a derivative of [MicroPython](https://micropython.org) designed to simplify experimentation and education on low-cost microcontrollers. It makes it easier than ever to get prototyping by requiring no upfront desktop software downloads. Simply copy and edit files on the **CIRCUITPY** &nbsp;flash drive to iterate.

The following instructions will show you how to install CircuitPython. If you've already installed CircuitPython but are looking to update it or reinstall it, the same steps work for that as well!

## Set up CircuitPython Quick Start!

Follow this quick step-by-step for super-fast Python power :)

[Download the latest version of CircuitPython for CLUE from circuitpython.org](https://circuitpython.org/board/clue_nrf52840_express/)
 **Click the link above to download the latest version of CircuitPython for the CLUE.**

Download and save it to your desktop (or wherever is handy).

![adafruit_products_CLUE_UF2_Downloaded.png](https://cdn-learn.adafruit.com/assets/assets/000/088/037/medium640/adafruit_products_CLUE_UF2_Downloaded.png?1580840077)

Plug your CLUE into your computer using a known-good USB cable.

**A lot of people end up using charge-only USB cables and it is very frustrating! So make sure you have a USB cable you know is good for data sync.**

Double-click the **Reset** button on the top (magenta arrow) on your board, and you will see the NeoPixel RGB LED (green arrow) turn green. If it turns red, check the USB cable, try another USB port, etc. **Note:** The little red LED next to the USB connector will pulse red. That's ok!

If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!

![adafruit_products_Clue_Reset_NeoPixel_bootloader.png](https://cdn-learn.adafruit.com/assets/assets/000/087/919/medium640/adafruit_products_Clue_Reset_NeoPixel_bootloader.png?1580496467)

You will see a new disk drive appear called **CLUEBOOT**.

Drag the **adafruit-circuitpython-clue-etc.uf2** file to **CLUE**** BOOT.**

![adafruit_products_CLUE_CLUEBOOT.png](https://cdn-learn.adafruit.com/assets/assets/000/088/042/medium640/adafruit_products_CLUE_CLUEBOOT.png?1580841287)

![adafruit_products_CLUE_drag_UF2.png](https://cdn-learn.adafruit.com/assets/assets/000/088/043/medium640/adafruit_products_CLUE_drag_UF2.png?1580841295)

The LED will flash. Then, the **CLUEBOOT** drive will disappear and a new disk drive called **CIRCUITPY** will appear.

If this is the first time you're installing CircuitPython or you're doing a completely fresh install after erasing the filesystem, you will have two files - **boot\_out.txt** , and **code.py** , and one folder - **lib** on your **CIRCUITPY** drive.

If CircuitPython was already installed, the files present before reloading CircuitPython should still be present on your **CIRCUITPY** drive. Loading CircuitPython will not create new files if there was already a CircuitPython filesystem present.

That's it, you're done! :)

![adafruit_products_CLUE_CIRCUITPY.png](https://cdn-learn.adafruit.com/assets/assets/000/088/044/medium640/adafruit_products_CLUE_CIRCUITPY.png?1580841453)

# PyLeap CLUE Custom Conference Badge

## Pairing

Now that you're done uploading the correct firmware, **disconnect** your device from your computer and power it via [LiPoly](https://www.adafruit.com/category/574)&nbsp;or [AAA battery pack](https://www.adafruit.com/product/727).

## Pairing device to PyLeap

Once powered, press the small&nbsp; **Reset** button in the center of the board (Circuit Playground Bluefruit) or on the top right of the board (CLUE). When the blue light flashes, press the Reset button again.

![Circuit Playground Bluefruit with reset button in center of board](https://cdn-learn.adafruit.com/assets/assets/000/107/090/medium800thumb/circuit_playground_ezgif22.jpg?1664908526 Circuit Playground Bluefruit with a small Reset button in the center of the board)

![Adafruit](https://cdn-learn.adafruit.com/assets/assets/000/087/865/original/adafruit_products_Clue_pinouts_Reset.png?1580413920 Adafruit CLUE Reset Button (Highlighted on the upper right))

When done correctly, the LEDs will flash yellow followed by solid blue. Once this occurs, the board will **continuously** be in discovery mode.

## Scan & Connect

When your Circuit Playground Bluefruit or Adafruit CLUE is in discovery mode, hold it very closely to your iPhone or iPadOS to pair.&nbsp;

![](https://cdn-learn.adafruit.com/assets/assets/000/112/226/medium800thumb/circuitpython_ezgif.com-gif-maker-3.jpg?1654190148)

Below the spinning Blinka, you'll notice a status&nbsp;indicator that will let you&nbsp;know your current **pairing status.**

Once you've found&nbsp;your&nbsp;device and received the **Bluetooth Pairing Request** message, press Pair to pair your board to your iPhone or iPadOS.

![](https://cdn-learn.adafruit.com/assets/assets/000/112/232/medium800/circuitpython_IMG_6159.png?1654209813)

## If your Circuit Playground Bluefruit doesn't appear:

1. Check to see if your Circuit Playground Bluefruit is powered on. Verify that the green **On** light is lit.
2. Make sure your Circuit Playground Bluefruit is running the correct **firmware**. See the [CircuitPython page](https://learn.adafruit.com/pyleap-app/circuitpython)&nbsp;in this guide.
3. Try resetting the Circuit Playground Bluefruit by pressing the small **Reset** button near the center of the board.

# PyLeap CLUE Custom Conference Badge

## CLUE Custom Conference Badge Code

![](https://cdn-learn.adafruit.com/assets/assets/000/115/725/medium800/projects_edited_P1380953.jpg?1665000933)

https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/PyLeap/PyLeap_CLUE_Conference_Badge/code.py

# PyLeap CLUE Custom Conference Badge

## Attach Your CLUE To The Lanyard

![](https://cdn-learn.adafruit.com/assets/assets/000/115/717/medium800/projects_edited_P1380944.jpg?1665000549)

Lay the lanyard so that the flat face of the metal rivets are facing up. This will make it so that the lanyard won't be twisted when you wear it.

![projects_edited_P1380947.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/718/medium640/projects_edited_P1380947.jpg?1665000562)

Clip one side of the lanyard into the CLUE's **GND** pad.

![projects_edited_P1380948.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/719/medium640/projects_edited_P1380948.jpg?1665000612)

Clip the other side of the lanyard into the CLUE's **pin 0** pad.

![projects_edited_P1380949.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/721/medium640/projects_edited_P1380949.jpg?1665000712)

You can clip the battery pack to the lanyard to secure it for walking around.

![projects_edited_P1380951.jpg](https://cdn-learn.adafruit.com/assets/assets/000/115/723/medium640/projects_edited_P1380951.jpg?1665000737)

# PyLeap CLUE Custom Conference Badge

## File Glider App Set Up

![](https://cdn-learn.adafruit.com/assets/assets/000/108/578/medium800/led_pixels_Screen_Shot_2022-02-02_at_3.21.41_PM.png?1643833326)

## What is File Glider?
From the description in the App store, File Glider allows you to:

> Wirelessly transfer files to and from file transfer-ready Bluetooth Low Energy (BLE) firmware. You can browse and edit files from within File Glider or use the Files app integration to access the files from other apps. Multiple devices can be managed at once and access can be shared amongst multiple apps.

Basically, this app allows you to transfer files from your iOS device to your CPB wirelessly with a couple of taps. It also lets you add and edit code on the CPB directly from the App, how neat!

## Step 1: [Download the File Glider App](https://apps.apple.com/us/app/file-glider/id1583976527) from the App Store.

Using your iOS device, download the File Glider App.

Info: 

## Step 2: Connect your BLE board to your iOS device through the app.

Open the File Glider App after it finishes downloading and make sure your board is connected to your computer.

![](https://cdn-learn.adafruit.com/assets/assets/000/108/579/medium800thumb/led_pixels_click_gif.jpg?1643834101)

- Click the reset button on the board.
- You will see the board NeoPixels flash through a series of colors, first red, then yellow then blue.
- When the blue appears, click the reset button again.
- The NeoPixels will then flash through another series of colors then turn blue momentarily before turning off again.

![](https://cdn-learn.adafruit.com/assets/assets/000/108/722/medium800/led_pixels_Untitled4.png?1644240906)

- The app should then state "Status: connected..."&nbsp;
- Then a Bluetooth Pairing Request will pop up, select "Pair".
- The board is now connected to the File Glider App!

![led_pixels_IMG_1231.jpg](https://cdn-learn.adafruit.com/assets/assets/000/108/601/medium640/led_pixels_IMG_1231.jpg?1643998855)

![led_pixels_IMG_1232.jpg](https://cdn-learn.adafruit.com/assets/assets/000/108/602/medium640/led_pixels_IMG_1232.jpg?1643998879)

![](https://cdn-learn.adafruit.com/assets/assets/000/108/723/medium800/led_pixels_Untitled4.png?1644240952)

## Troubleshooting

**Problem:** You try to connect your board but then you see the following error on the app "Disconnected: Peer removed pairing information"

 **Solution:&nbsp;** Go to your Bluetooth device settings on your iOS device (Settings \> Bluetooth). Scroll down to the one labeled "CIRCUITPYxxxx". Then click on the info icon (a letter i with a circle). Now select "forget this device". Try to connect the board again from step 2 above and you should be set.

![led_pixels_IMG_1235.jpg](https://cdn-learn.adafruit.com/assets/assets/000/108/606/medium640/led_pixels_IMG_1235.jpg?1643999680)

![led_pixels_IMG_1236.jpg](https://cdn-learn.adafruit.com/assets/assets/000/108/607/medium640/led_pixels_IMG_1236.jpg?1643999706)

# PyLeap CLUE Custom Conference Badge

## Usage

After loading the project onto your CLUE with PyLeap, close out of the PyLeap app. This disconnects the CLUE from PyLeap to allow it to connect to File Glider.

Warning: 

## Edit With File Glider
After connecting your CLUE to File Glider, select **Explorer** to view the file directory of your CLUE. Then, select **code.py** to edit the code file.&nbsp;

![projects_openFileGlider.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/730/medium640thumb/projects_openFileGlider.jpg?1665006061)

You can edit the `text=" "` properties in the `badge_line()` objects. The text items are found in the code in the order that they appear on the screen:

1. Social media handle
2. Name
3. Job Title
4. Pronouns

![projects_changeText.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/731/medium640thumb/projects_changeText.jpg?1665006194)

At the bottom of the code, you'll see a line that says `show_qr_code()`, followed by a website. You can edit the website text with your URL of choice. When you run the code and press the A button on the CLUE, a QR code will be displayed that will link to the URL.

![projects_website.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/732/medium640thumb/projects_website.jpg?1665006415)

When you're ready to load your updated badge, select **Save** in the app. You'll see the CLUE reset and display your updated code.

![projects_saveCode.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/733/medium640thumb/projects_saveCode.jpg?1665006885)

## Badge Life
When you're wearing your badge out and about or at your desk for a virtual conference, you can press the A button to display your QR code. You can press the B button to go back to displaying your badge.

![projects_badgeQR_1.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/735/medium640thumb/projects_badgeQR_1.jpg?1665060366)

You can scan the QR code with your mobile device and you'll be directed to the URL that is in the code.

![projects_qrDemo.gif](https://cdn-learn.adafruit.com/assets/assets/000/115/736/medium640thumb/projects_qrDemo.jpg?1665060657)


## Featured Products

### Adafruit CLUE - nRF52840 Express with Bluetooth® LE

[Adafruit CLUE - nRF52840 Express with Bluetooth® LE](https://www.adafruit.com/product/4500)
Do you feel like you just don't have a CLUE? Well, we can help with that - get a CLUE here at Adafruit by picking up this sensor-packed development board. We wanted to build some projects that have a small screen and a lot of sensors. To make it compatible with existing projects, we made...

In Stock
[Buy Now](https://www.adafruit.com/product/4500)
[Related Guides to the Product](https://learn.adafruit.com/products/4500/guides)
### Adafruit Circuit Playground Lanyard

[Adafruit Circuit Playground Lanyard](https://www.adafruit.com/product/3987)
We've got our Circuit Playground friends on&nbsp;[lunchboxes](https://www.adafruit.com/product/3437),&nbsp;[posters](https://www.adafruit.com/?q=posters),&nbsp;[puzzle](https://www.adafruit.com/product/3817),&nbsp;<a...></a...>

In Stock
[Buy Now](https://www.adafruit.com/product/3987)
[Related Guides to the Product](https://learn.adafruit.com/products/3987/guides)
### Clear Acrylic Enclosure + Hardware Kit for Adafruit CLUE

[Clear Acrylic Enclosure + Hardware Kit for Adafruit CLUE](https://www.adafruit.com/product/4675)
Here is a chic&nbsp;minimalist enclosure for your **CLUE** board! This case&nbsp;has been laser-cut specifically to accommodate the TFT display, tactile buttons, and capacitive pads.

And of course, we include&nbsp;mounting hardware so you can assemble it right onto your CLUE...

In Stock
[Buy Now](https://www.adafruit.com/product/4675)
[Related Guides to the Product](https://learn.adafruit.com/products/4675/guides)
### USB cable - USB A to Micro-B

[USB cable - USB A to Micro-B](https://www.adafruit.com/product/592)
This here is your standard A to micro-B USB cable, for USB 1.1 or 2.0. Perfect for connecting a PC to your Metro, Feather, Raspberry Pi or other dev-board or microcontroller

Approximately 3 feet / 1 meter long

In Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
### 3 x AA Battery Holder with On/Off Switch, JST, and Belt Clip

[3 x AA Battery Holder with On/Off Switch, JST, and Belt Clip](https://www.adafruit.com/product/3287)
This battery holder connects 3 AA batteries together in series for powering all kinds of projects. We spec'd these out because the box is compact, and 3 AA's add up to about 3.3-4.5V, a very similar range to Lithium Ion/polymer (Li-Ion) batteries, plus it has&nbsp;a nifty&nbsp;on-off...

Out of Stock
[Buy Now](https://www.adafruit.com/product/3287)
[Related Guides to the Product](https://learn.adafruit.com/products/3287/guides)
### Alkaline AA batteries (LR6) - 3 pack

[Alkaline AA batteries (LR6) - 3 pack](https://www.adafruit.com/product/3521)
Battery power for your portable project! These batteries are good quality at a good price, and work fantastic with any of the kits or projects in the shop that use AAs. This is a pack of **3 AA batteries**.  
  
These batteries are Alkaline (MnO2) chemistry, with a voltage...

In Stock
[Buy Now](https://www.adafruit.com/product/3521)
[Related Guides to the Product](https://learn.adafruit.com/products/3521/guides)

## Related Guides

- [Introducing Adafruit CLUE](https://learn.adafruit.com/adafruit-clue.md)
- [¡Bienvenido a CircuitPython!](https://learn.adafruit.com/bienvenido-a-circuitpython-2.md)
- [No-Touch Hand Wash Timer for Circuit Playground Express and CLUE](https://learn.adafruit.com/no-touch-hand-wash-timer-for-cpx-and-clue.md)
- [CLUE Altimeter](https://learn.adafruit.com/clue-altimeter.md)
- [CircuitPython BLE Morse Code Chat](https://learn.adafruit.com/circuitpython-ble-wireless-morse-code-chat.md)
- [CLUE Vertical Garden Weather Visualizer](https://learn.adafruit.com/clue-vertical-garden-weather-visualizer.md)
- [CLUE case](https://learn.adafruit.com/clue-case.md)
- [Adafruit LSM6DS33 6-DoF IMU Breakout](https://learn.adafruit.com/lsm6ds33-6-dof-imu-accelerometer-gyro.md)
- [LIS3MDL Triple-axis Magnetometer](https://learn.adafruit.com/lis3mdl-triple-axis-magnetometer.md)
- [CLUE Step Counter](https://learn.adafruit.com/clue-step-counter-st-lsm6ds33.md)
- [Creative Inspiration Activity Generator](https://learn.adafruit.com/creative-inspiration-activity-generator.md)
- [Bluetooth Cycling Speed & Cadence Sensor Display with Clue](https://learn.adafruit.com/bluetooth-bicycle-speed-cadence-sensor-display-with-clue.md)
- [CLUE Sensor Plotter in CircuitPython](https://learn.adafruit.com/clue-sensor-plotter-circuitpython.md)
- [Bluetooth LE Sensor Nodes to Raspberry Pi WiFi Bridge](https://learn.adafruit.com/bluetooth-le-broadcastnet-sensor-node-raspberry-pi-wifi-bridge.md)
- [PyBadger Event Badge](https://learn.adafruit.com/pybadger-event-badge.md)
- [PyLeap CLUE Barometer](https://learn.adafruit.com/pyleap-clue-barometer.md)
