Getting around

A quick tour of the simulator. For the Python API and the full guides, head to badgewa.re/docs.

Getting Started

We recommend browsing the examples gallery and getting a feel for the building blocks of a Badgeware application. Find an example you like, hit Edit to bring it into the editor here, tweak the code and see what happens!

Alternatively, take badgeOS for a spin and get that Badgeware out of the box experience before you buy.

Running your code

  • F5 or Runrun whatever's in the editor
  • Stophalt the running program
  • badgeOSboot the badge's menu, just like the real thing

With nothing open, Run launches badgeOS too, so you're never stuck. The Run icon turns to a reload when you're about to re-run what's already going.

Editor shortcuts

  • F5run
  • Ctrl / Cmd + Ssave the current file

Your files autosave as you type, so a save is really just for peace of mind.

Pressing the badge's buttons

Click the 3D badge once to give it focus, then your keyboard becomes the badge:

  • ←A
  • SpaceB
  • →C
  • ↑ ↓Up / Down
  • EscHome

The 3D badge

  • Double-clickzoom the screen in to frame the display; double-click again to pull back out
  • ‹ ›the on-badge arrows spin it round to see the other side

Files

  • Click / Spacepeek at a file (its tab shows in italic)
  • Double-click / Enteropen it for keeps
  • Deleteremove the selected file

The System tree is read-only. Have a rummage to see how the built-in apps tick, then borrow whatever you fancy for your own.

Badgeware Tufty Weatherstation

Get weather data from the internet and/or from a multisensor stick with the Weatherstation app for the Badgeware Tufty!

Try it out in the demo on the right, or install it on real hardware!

Controls

Press the ↑ and ↓ buttons to switch screens, and press A on the badge to refetch weather. Alternatively, you can use keyboard shortcuts to interact with the badge:

  • ←A
  • SpaceB
  • →C
  • ↑ ↓Up / Down

How it works

It first reads options.json to find settings like what temperature unit to use, but also the coordinates of each location and an optional nickname for each. For all the coordinates without a nickname it fetches from OpenStreetMap Nominatim to get a location name, e.g. Merchant City, Glasgow. It then fetches for every location the weather from openmeteo, for things like weather code (which decides the icon), temperature, precipitation and wind direction.

Credit to pimoroni for the development of the badgeware web emulator which this website is powered by, check out the full version here!