# CircuitPython Turtle Graphics ## Overview ![](https://cdn-learn.adafruit.com/assets/assets/000/077/556/medium800thumb/circuitpython_Turtle-animation.jpg?1561735130 Wikipedia user Cormullion CC BY-SA 4.0) You may have heard of, or even played around with, [_turtle graphics_](https://en.wikipedia.org/wiki/Turtle_graphics). Simply put, this is a metaphor for drawing vector images where you control a _turtle _that can drag a pen along with it. Commands to the turtle include things like move forward some distance, turn left or right by some angle, lift the pen off the paper (so that moving won't make a mark), or put it on the paper (so that moving will make a mark). There have been many on-screen implementations of turtle graphics, most notably the [LOGO](https://en.wikipedia.org/wiki/Logo_(programming_language)) programming language. Versions have also been made that control a robot that has a pen so as to create on-paper copies of turtle drawings. This guide introduces a turtle graphics library for CircuitPython that is built on top of `displayio` for use on display based boards such as the PyPortal, PyBadge, and PyGamer. ### Adafruit PyPortal - CircuitPython Powered Internet Display [Adafruit PyPortal - CircuitPython Powered Internet Display](https://www.adafruit.com/product/4116) **PyPortal** , our easy-to-use IoT device that allows you to create all the things for the “Internet of Things” in minutes. Make custom touch screen interface GUIs, all open-source, and Python-powered using tinyJSON / APIs to get news, stock, weather, cat photos,... Out of Stock [Buy Now](https://www.adafruit.com/product/4116) [Related Guides to the Product](https://learn.adafruit.com/products/4116/guides) ![Front view of a Adafruit PyPortal - CircuitPython Powered Internet Display with a pyportal logo image on the display. ](https://cdn-shop.adafruit.com/640x480/4116-00.jpeg) ### Adafruit PyBadge for MakeCode Arcade, CircuitPython, or Arduino [Adafruit PyBadge for MakeCode Arcade, CircuitPython, or Arduino](https://www.adafruit.com/product/4200) What's the size of a credit card and can run CircuitPython, MakeCode Arcade or Arduino? That's right, its the **Adafruit PyBadge!** We wanted to see how much we could cram into a ​3 3⁄8 × ​2 1⁄8 inch rounded rectangle, to make an all-in-one dev board with... Out of Stock [Buy Now](https://www.adafruit.com/product/4200) [Related Guides to the Product](https://learn.adafruit.com/products/4200/guides) ![Angled shot of a Adafruit PyBadge for MakeCode Arcade, CircuitPython, or Arduino. ](https://cdn-shop.adafruit.com/640x480/4200-01.jpg) ### Adafruit PyGamer Starter Kit [Adafruit PyGamer Starter Kit](https://www.adafruit.com/product/4277) **Please note: you may get a royal blue _or_ purple case with your starter kit (they're both lovely colors)** What fits in your pocket, is fully Open Source, and can run CircuitPython, MakeCode Arcade or Arduino games you write yourself? That's right,... Out of Stock [Buy Now](https://www.adafruit.com/product/4277) [Related Guides to the Product](https://learn.adafruit.com/products/4277/guides) ![Adafruit PyGamer Starter Kit with PCB, enclosure, buttons, and storage bag](https://cdn-shop.adafruit.com/640x480/4277-08.jpg) ### Adafruit PyGamer for MakeCode Arcade, CircuitPython or Arduino [Adafruit PyGamer for MakeCode Arcade, CircuitPython or Arduino](https://www.adafruit.com/product/4242) What fits in your pocket, is fully Open Source, and can run CircuitPython, MakeCode Arcade or Arduino games you write yourself? That's right, it's the **Adafruit PyGamer!** We wanted to make an entry-level gaming handheld for DIY gaming, and maybe a little... Out of Stock [Buy Now](https://www.adafruit.com/product/4242) [Related Guides to the Product](https://learn.adafruit.com/products/4242/guides) ![Angled shot of Adafruit PyGamer for MakeCode Arcade, CircuitPython or Arduino.](https://cdn-shop.adafruit.com/640x480/4242-00.jpg) - [Next Page](https://learn.adafruit.com/circuitpython-turtle-graphics/setting-up-your-device.md) ## Featured Products ### Adafruit PyPortal - CircuitPython Powered Internet Display [Adafruit PyPortal - CircuitPython Powered Internet Display](https://www.adafruit.com/product/4116) **PyPortal** , our easy-to-use IoT device that allows you to create all the things for the “Internet of Things” in minutes. Make custom touch screen interface GUIs, all open-source, and Python-powered using tinyJSON / APIs to get news, stock, weather, cat photos,... Out of Stock [Buy Now](https://www.adafruit.com/product/4116) [Related Guides to the Product](https://learn.adafruit.com/products/4116/guides) ### Adafruit PyBadge for MakeCode Arcade, CircuitPython, or Arduino [Adafruit PyBadge for MakeCode Arcade, CircuitPython, or Arduino](https://www.adafruit.com/product/4200) What's the size of a credit card and can run CircuitPython, MakeCode Arcade or Arduino? That's right, its the **Adafruit PyBadge!** We wanted to see how much we could cram into a ​3 3⁄8 × ​2 1⁄8 inch rounded rectangle, to make an all-in-one dev board with... Out of Stock [Buy Now](https://www.adafruit.com/product/4200) [Related Guides to the Product](https://learn.adafruit.com/products/4200/guides) ### Adafruit PyBadge LC - MakeCode Arcade, CircuitPython, or Arduino [Adafruit PyBadge LC - MakeCode Arcade, CircuitPython, or Arduino](https://www.adafruit.com/product/3939) What's the size of a credit card and can run CircuitPython, MakeCode Arcade or Arduino even when you're on a budget? That's right, it's the  **Adafruit PyBadge LC!**  We wanted to see how much we could cram into a ​3 3⁄8 × ​2 1⁄8 inch... In Stock [Buy Now](https://www.adafruit.com/product/3939) [Related Guides to the Product](https://learn.adafruit.com/products/3939/guides) ### Adafruit PyGamer for MakeCode Arcade, CircuitPython or Arduino [Adafruit PyGamer for MakeCode Arcade, CircuitPython or Arduino](https://www.adafruit.com/product/4242) What fits in your pocket, is fully Open Source, and can run CircuitPython, MakeCode Arcade or Arduino games you write yourself? That's right, it's the **Adafruit PyGamer!** We wanted to make an entry-level gaming handheld for DIY gaming, and maybe a little... Out of Stock [Buy Now](https://www.adafruit.com/product/4242) [Related Guides to the Product](https://learn.adafruit.com/products/4242/guides) ### Adafruit PyGamer Starter Kit [Adafruit PyGamer Starter Kit](https://www.adafruit.com/product/4277) **Please note: you may get a royal blue _or_ purple case with your starter kit (they're both lovely colors)** What fits in your pocket, is fully Open Source, and can run CircuitPython, MakeCode Arcade or Arduino games you write yourself? That's right,... Out of Stock [Buy Now](https://www.adafruit.com/product/4277) [Related Guides to the Product](https://learn.adafruit.com/products/4277/guides) ### Pink and Purple Braided USB A to Micro B Cable - 2 meter long [Pink and Purple Braided USB A to Micro B Cable - 2 meter long](https://www.adafruit.com/product/4148) This cable is super-fashionable with a woven pink and purple Blinka-like pattern! First let's talk about the cover and over-molding. We got these in custom colors, and if you _have_ to have visible cables, then you might as well have the nicest fabric-bound... No Longer Stocked [Buy Now](https://www.adafruit.com/product/4148) [Related Guides to the Product](https://learn.adafruit.com/products/4148/guides) ## Related Guides - [Adafruit PyPortal - IoT for CircuitPython](https://learn.adafruit.com/adafruit-pyportal.md) - [Adafruit PyBadge and PyBadge LC](https://learn.adafruit.com/adafruit-pybadge.md) - [Introducing Adafruit PyGamer](https://learn.adafruit.com/adafruit-pygamer.md) - [PyPortal YouTube Views and Subscribers Display](https://learn.adafruit.com/pyportal-youtube-views-and-subscribers-display.md) - [PyGamer Thermal Camera with AMG8833](https://learn.adafruit.com/pygamer-thermal-camera-amg8833.md) - [PyPortal Philips Hue Lighting Controller](https://learn.adafruit.com/pyportal-philips-hue-lighting-controller.md) - [Program in Logo on an Apple II](https://learn.adafruit.com/program-logo-on-an-apple-ii.md) - [Adafruit IO Basics: AirLift](https://learn.adafruit.com/adafruit-io-basics-airlift.md) - [Re-MakeCode the Classics: Arkanoid](https://learn.adafruit.com/re-makecode-the-classics-arkanoid.md) - [Making a Name Tag in MakeCode Arcade](https://learn.adafruit.com/making-a-name-tag-in-makecode-arcade.md) - [MakeCode Arcade: Sparky Invaders](https://learn.adafruit.com/makecode-arcade-sparky-invaders.md) - [PyBadge Case](https://learn.adafruit.com/pybadge-case.md) - [Next Level MakeCode Arcade Games](https://learn.adafruit.com/next-level-makecode-arcade-games.md) - [Adafruit IO Basics: Schedule Actions](https://learn.adafruit.com/adafruit-io-basics-scheduled-triggers.md) - [Trash Panda 2: Garbage Day](https://learn.adafruit.com/trash-panda-2-dumpster-dive.md) - [Wakanda Forever Game](https://learn.adafruit.com/wakanda-forever-game.md) - [FunHouse Motion Detecting Lights with LIFX Bulbs](https://learn.adafruit.com/funhouse-motion-detecting-lighting-for-lifx-bulbs.md)