# PyLeap App
## Overview
**PyLeap** is an iOS, iPadOS and Android app that allows users to easily download code files and assets and transfer them to Adafruit devices using **Bluetooth Low Energy (BLE)** or **WiFi**.
With PyLeap, users can quickly and conveniently transfer code files and assets from our Adafruit Learn Systems to their Adafruit devices, allowing them to take their projects to the next level.
This app is designed from the ground up for Adafruit devices that use an **nRF52840 for** **Bluetooth Low Energy (BLE)** or an **ESP32-S2 TFT feather for Wi-Fi**. You can pick one up from the Adafruit Shop along with other accessories:
Download the PyLeap app from the Apple App Store or the Google Play Store per your device type.
## Parts
### Adafruit ESP32-S2 TFT Feather - 4MB Flash, 2MB PSRAM, STEMMA QT
[Adafruit ESP32-S2 TFT Feather - 4MB Flash, 2MB PSRAM, STEMMA QT](https://www.adafruit.com/product/5300)
We've got a new machine here at Adafruit, it can uncover your deepest desires. Don't believe me? I'll turn it on right now to prove it to you! What, you want unlimited mozzarella sticks? OK well, that's not something we can provide. But we can provide your...
Out of Stock
[Buy Now](https://www.adafruit.com/product/5300)
[Related Guides to the Product](https://learn.adafruit.com/products/5300/guides)
### Circuit Playground Bluefruit - Bluetooth® Low Energy
[Circuit Playground Bluefruit - Bluetooth® Low Energy](https://www.adafruit.com/product/4333)
**Circuit Playground Bluefruit** is our third board in the Circuit Playground series, another step towards a perfect introduction to electronics and programming. We've taken the popular Circuit Playground Express and made it even better! Now the main chip is an nRF52840...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4333)
[Related Guides to the Product](https://learn.adafruit.com/products/4333/guides)
### 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)
### Lithium Ion Polymer Battery - 3.7v 1200mAh
[Lithium Ion Polymer Battery - 3.7v 1200mAh](https://www.adafruit.com/product/258)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 1200mAh for a total of about 4.5 Wh. If you need a larger battery,
In Stock
[Buy Now](https://www.adafruit.com/product/258)
[Related Guides to the Product](https://learn.adafruit.com/products/258/guides)
### Adafruit LED Glasses Front Panel - 116 RGB LEDs with I2C Driver
[Adafruit LED Glasses Front Panel - 116 RGB LEDs with I2C Driver](https://www.adafruit.com/product/5210)
Have you always wanted to upgrade your ensemble with a creepy-cool creature PCB silkscreen and an eye-blistering arrangement of LEDs? [We love to put NeoPixels on our face, as evidenced by our many glowy LED glasses...](https://learn.adafruit.com/search?q=neopixel%2520glasses)
In Stock
[Buy Now](https://www.adafruit.com/product/5210)
[Related Guides to the Product](https://learn.adafruit.com/products/5210/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
Out of Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
# PyLeap App
## Setting Up CircuitPython
# Install CircuitPython
Currently, PyLeap **requires** Adafruit Boards to run Circuit Python on its board. If you haven't already, you'll need to download the **latest** version of CircuitPython from the link below.
[Download CircuitPython for Circuit Playground Bluefruit from CircuitPython.org](https://circuitpython.org/board/circuitplayground_bluefruit/)
Plug your Adafruit device into your computer using a good data-capable USB cable.
**Many people use charge-only USB cables, which is very frustrating, I'm sure! So make sure you have a USB cable suitable for data sync.**
Double-click the small **Reset** button on the Adafruit device (indicated by the red arrow in the image).
A LED will turn red, and then it will turn green. If they turn red and stay red, check the USB cable, try another USB port, etc. The tiny red LED next to the USB connector will pulse red - this is ok!
If double-clicking doesn't work the first time, try again. Sometimes it can take a few tries to get the rhythm right!
(If double-clicking doesn't do it, try a single click!)
You will see a new disk drive appear like " **CPLAYBTBOOT."**
Drag the . **uf2 ** file to **CPLAYBTBOOT.**
The LEDs will turn red. Then, the **CPLAYBTBOOT** drive will disappear, and a new disk drive called **CIRCUITPY** will appear.
That's it. You're done! :)
# PyLeap App
## Bluetooth Pairing
After uploading the correct firmware, **disconnect** your device from your computer and power it via [LiPoly](https://www.adafruit.com/category/574) or [AAA battery pack](https://www.adafruit.com/product/727).
## Pairing device to PyLeap
Once powered, press the small **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.
)
When done correctly, the LEDs flash yellow, followed by solid blue. Once this occurs, the board will **continuously** be in discovery mode.
## Scan & Connect
When your Adafruit device is in discovery mode, hold it very close to your iPhone or iPad to pair.
Below the spinning Blinka, you'll notice a status indicator that will let you know your current **pairing status.**
Once you've found your device and received the **Bluetooth Pairing Request** message, press **Pair** to pair your board to your iPhone or iPad.
## If your Circuit Playground Bluefruit doesn't appear:
1. Verify that the green **On** light is lit.
2. Make sure your Adafruit device is running the correct **firmware**. See the [CircuitPython page](https://learn.adafruit.com/pyleap-app/circuitpython) in this guide.
3. Try resetting the Adafruit device by pressing the small **Reset** button near the center of the board.
# PyLeap App
## WiFi Pairing
## Setup WiFi Credentials
PyLeap depends on adding WiFi credentials to detect Adafruit devices over WiFi.
Create a file with the name **settings.toml** in the root directory of the **CIRCUITPY** drive.
Add the following below:
The file contains the keys `CIRCUITPY_WIFI_SSID` and `CIRCUITPY_WIFI_PASSWORD`. Once these are defined, CircuitPython will automatically connect to the network and start the webserver used for the workflow.
The web server is on port 80 unless overridden by `CIRCUITPY_WEB_API_PORT`. It also enables MDNS.
Here is an example **settings.toml** :
```auto
# To auto-connect to Wi-Fi
CIRCUITPY_WIFI_SSID="YOUR-WIFI-NETWORK-NAME"
CIRCUITPY_WIFI_PASSWORD="YOUR-WIFI-NETWORK-PASSWORD"
# To enable modifying files from the web. Change this too!
# Leave the User field blank in the browser.
CIRCUITPY_WEB_API_PASSWORD="passw0rd"
CIRCUITPY_WEB_API_PORT=80
```
Drag the **settings.toml** file to the **CIRCUITPY** drive.
Warning:
Open the PyLeap app. Select WiFi and scan for Adafruit devices.
After seeing the spinning Blinka animation, you should see a screen with WiFi devices found. Once you've found your device in the peripheral device list, press the Connect button to continue.
If WiFi devices were not found, either rescan for WiFi devices or double check your WiFi credentials.
# PyLeap App
## Troubleshooting
If you happen to witness this message "Disconnected: Peer removed pairing information " while pairing to a **Bluetooth** device, there is a way to remedy that.
Go to your **Settings app,** go to the Bluetooth setting, and delete your Adafruit device from the list.
Once you've removed the Circuit Playground Bluefruit device from your device list, for good measure, reset the PyLeap app as well.
# PyLeap App
## Modules
Once connected, the app will display a list of projects for you to choose from.
Choose one of the projects in the list and go to its related page in this guide to learn more.
- [Glide on over to some Rainbows](/pyleap-device-enabled-in-rainbows)
- [MP3 Playback ](/pyleap-mp3-playback-for-cpb)
- [NeoPixel Sound Meter](/pyleap-neopixel-sound-meter)
- [NeoPixel Light Meter](/pyleap-neopixel-light-meter)
- [Touch NeoPixel Rainbow](/pyleap-touch-neopixel-rainbow)
- [Button Controlled NeoPixels](/pyleap-buttons-neopixels)
- [WAV Playback](/pyleap-wav-playback-for-cpb)
- [Tone Piano](/pyleap-tone-piano-for-cpb)
And more!
Press the "Run it" button to download and transfer complete projects to your device.
# PyLeap App
## 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) or [AAA battery pack](https://www.adafruit.com/product/727).
## Pairing device to PyLeap
Once powered, press the small **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.
)
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.
Below the spinning Blinka, you'll notice a status indicator that will let you know your current **pairing status.**
Once you've found your device and received the **Bluetooth Pairing Request** message, press Pair to pair your board to your iPhone or iPadOS.
## 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) in this guide.
3. Try resetting the Circuit Playground Bluefruit by pressing the small **Reset** button near the center of the board.
## Featured Products
### Circuit Playground Bluefruit - Bluetooth® Low Energy
[Circuit Playground Bluefruit - Bluetooth® Low Energy](https://www.adafruit.com/product/4333)
**Circuit Playground Bluefruit** is our third board in the Circuit Playground series, another step towards a perfect introduction to electronics and programming. We've taken the popular Circuit Playground Express and made it even better! Now the main chip is an nRF52840...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4333)
[Related Guides to the Product](https://learn.adafruit.com/products/4333/guides)
### Lithium Ion Polymer Battery - 3.7v 1200mAh
[Lithium Ion Polymer Battery - 3.7v 1200mAh](https://www.adafruit.com/product/258)
Lithium-ion polymer (also known as 'lipo' or 'lipoly') batteries are thin, light, and powerful. The output ranges from 4.2V when completely charged to 3.7V. This battery has a capacity of 1200mAh for a total of about 4.5 Wh. If you need a larger battery,
In Stock
[Buy Now](https://www.adafruit.com/product/258)
[Related Guides to the Product](https://learn.adafruit.com/products/258/guides)
### JST SH 4-pin Cable with Alligator Clips - STEMMA QT / Qwiic
[JST SH 4-pin Cable with Alligator Clips - STEMMA QT / Qwiic](https://www.adafruit.com/product/4398)
This cable will make it super easy to use our plug-and-play STEMMA QT boards with boards like Circuit Playground. On one end you get a Qwiic / STEMMA QT connector (technically known as a JST SH 4-pin plug) into 4 individual wires with grippy alligator clips. We're carrying these to...
Out of Stock
[Buy Now](https://www.adafruit.com/product/4398)
[Related Guides to the Product](https://learn.adafruit.com/products/4398/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
Out of Stock
[Buy Now](https://www.adafruit.com/product/592)
[Related Guides to the Product](https://learn.adafruit.com/products/592/guides)
### Adafruit LED Glasses Front Panel - 116 RGB LEDs with I2C Driver
[Adafruit LED Glasses Front Panel - 116 RGB LEDs with I2C Driver](https://www.adafruit.com/product/5210)
Have you always wanted to upgrade your ensemble with a creepy-cool creature PCB silkscreen and an eye-blistering arrangement of LEDs? [We love to put NeoPixels on our face, as evidenced by our many glowy LED glasses...](https://learn.adafruit.com/search?q=neopixel%2520glasses)
In Stock
[Buy Now](https://www.adafruit.com/product/5210)
[Related Guides to the Product](https://learn.adafruit.com/products/5210/guides)
## Related Guides
- [Adafruit Circuit Playground Bluefruit](https://learn.adafruit.com/adafruit-circuit-playground-bluefruit.md)
- [Adafruit EyeLights LED Glasses and Driver](https://learn.adafruit.com/adafruit-eyelights-led-glasses-and-driver.md)
- [CircuitPython Sin Complicaciones para la Circuit Playground Express y la Bluefruit](https://learn.adafruit.com/circuitpython-sin-complicaciones-para-la-circuit-playground-express.md)
- [Adafruit Circuit Playground Tri-Color E-Ink Gizmo](https://learn.adafruit.com/adafruit-circuit-playground-tri-color-e-ink-gizmo.md)
- [Bluefruit Luminary Lanterns with Capacitive Touch](https://learn.adafruit.com/bluefruit-luminary-lanterns-with-capacitive-touch.md)
- [TFT Gizmo Animated Eye](https://learn.adafruit.com/tft-gizmo-animated-eye.md)
- [Sound Reactive Sunflower Baby Crib Mobile with Bluetooth Control](https://learn.adafruit.com/sound-reactive-sunflower-baby-crib-mobile-with-bluetooth-control.md)
- [Frozen-Inspired Animated Pendant with Temperature Sensing](https://learn.adafruit.com/frozen-gizmo-pendant-with-temperature-sensing.md)
- [Wireless Image Transfer with Circuit Playground Bluefruit and E-Ink Gizmo](https://learn.adafruit.com/wireless-image-transfer-with-circuit-playground-bluetooth-and-eink-gizmo.md)
- [Snow Globe with Circuit Playground Bluefruit](https://learn.adafruit.com/snow-globe-bluefruit-cpb.md)
- [Bluefruit LE Connect for iOS and Android](https://learn.adafruit.com/bluefruit-le-connect.md)
- [PyLeap device enabled - In Rainbows](https://learn.adafruit.com/pyleap-device-enabled-in-rainbows.md)
- [Circuit Playground Bluefruit Quick Draw Duo](https://learn.adafruit.com/circuit-playground-bluefruit-quick-draw-duo.md)
- [LED Emerald with Circuit Playground Bluefruit](https://learn.adafruit.com/led-emerald-with-circuit-playground.md)
- [Circuit Playground Bluefruit Automatic Bike Brake Light](https://learn.adafruit.com/circuit-playground-bluefruit-brake-light.md)
- [Which CircuitPython Board is Right for You?](https://learn.adafruit.com/choose-your-circuitpython-board.md)
- [PyLeap EyeLights LED Glasses Rainbows for Circuit Playground Bluefruit](https://learn.adafruit.com/pyleap-eyelights-led-glasses-for-circuit-playground-bluefruit.md)