MacroPad Summer Olympics Hotkeys

published July 27, 2021, last edited January 19, 2025

posted in CircuitPython AdaBox Breakout Boards LCDs & Displays/ OLED Programming/ MicroPython / CircuitPython

Beginner

Project guide

Overview

The sheer number of Olympic events is staggering (46!). How do you keep track of them all? The MacroPad is the perfect organizer for checking in on each sport and scrolling through the different Olympics channels.

source: https://en.wikipedia.org/wiki/Olympic_Games

In this project you'll be able to (from a browser):

View live and past Olympic events from 6 different channels/sources
Check the schedules and results of all 46 Olympic events (individually and at a glance)
View the medal count by country in real time
Switch between tabs of all the channels, results, schedules etc.
Navigate up and down pages
Close tabs

All with a couple of clickity clackity keyboard clicks on an Adafruit MacroPad!

What's a MacroPad?

It's a speedy little microcontroller with lots of GPIO pins and a 64 times more RAM than the Apollo Guidance Computer. The MacroPad can be powered by either CircuitPython or Arduino - complete with 12 buttons, an OLED display, a speaker, and a rotary encoder. Read about it here if you'd like more details.

For the scope of this guide, we're going to focus on the application of the MacroPad as a hotkeys shortcut to make your Olympic viewing experience a 10 out of 10. This project is based on a tutorial called MACROPAD Hotkeys which shows you how to turn your MacroPad into a keyboard shortcut device for your computer. Please read through that guide before continuing here.

Prerequisite guide: MACROPAD Hotkeys

circuitpython_Screen_Shot_2021-07-27_at_10.19.50_AM.png

Parts

You can buy a kit with all the parts with Kailh Red keys and clear keycaps or build your own custom configuration:

Video of a hand playing with a rainbow-glowing keypad.

Adafruit MacroPad RP2040 Starter Kit - 3x4 Keys + Encoder + OLED

Strap yourself in, we're launching in T-minus 10 seconds...Destination? A new Class M planet called MACROPAD! M here stands for Microcontroller because this 3x4 keyboard controller...

guides with product

Out of Stock

- or -

Adafruit MACROPAD RP2040 Bare Bones - 3x4 Keys + Encoder + OLED

Strap yourself in, we're launching in T-minus 10 seconds...Destination? A new Class M planet called MACROPAD! M here, stands for Microcontroller because this 3x4 keyboard...

guides with product

$34.95

In Stock

Add to Cart

Adafruit MacroPad RP2040 Enclosure + Hardware Add-on Pack

Dress up your Adafruit Macropad with PaintYourDragon's fabulous decorative silkscreen enclosure and hardware kit. You get the two custom PCBs that are cut to act as a protective...

Out of Stock

Top down view of four piles of Kailh key switches in Red, Black, Brown, and Black variations.

Kailh Mechanical Key Switches - 10 packs - Cherry MX Compatible

For crafting your very own custom keyboard, these Kailh mechanical key switches are deeee-luxe!Come in a pack of 10 switches, plenty to make a...

Out of Stock

Add from Store

Group shot of Clear DSA Keycaps for MX Compatible Switches - 12 pack

Clear Keycaps for MX Compatible Switches - 12-pack

Here is a 12 pack of Clear DSA keycaps for your next mechanical keyboard or

$6.95

In Stock

Add to Cart

Translucent Keycaps for MX Compatible Switches - 10 pack

Get ready to clacky to your heart's content. Here is a 10 pack of translucent keycaps for your next mechanical keyboard or

$4.95

In Stock

Add to Cart

Page last edited March 08, 2024

Text editor powered by tinymce.

Project Code

As stated earlier, this project is based off the MACROPAD Hotkeys guide. Once you have read through that guide you are ready to add the files from this guide.

Download Project Bundle

Copy Code

# SPDX-FileCopyrightText: 2021 Isaac Wellish for Adafruit Industries
#
# SPDX-License-Identifier: MIT

# MACROPAD Olympic Hotkeys main page
# pylint: disable=line-too-long

from adafruit_hid.keycode import Keycode # REQUIRED if using Keycode.* values

app = {                # REQUIRED dict, must be named 'app'
    'name' : 'Olympics Home', # Application name
    'macros' : [       # List of button macros...
        # COLOR    LABEL    KEY SEQUENCE
        # 1st row ----------
        (0x004000, '< Tab', [Keycode.CONTROL, Keycode.SHIFT, Keycode.TAB]),
        (0x004000, 'Tab >', [Keycode.CONTROL, Keycode.TAB]),
        (0x400000, 'Up', [Keycode.SHIFT, ' ']),      # Scroll up
        # 2nd row ----------
        # Full schedule in new tab
        (0x3F3F3F, 'Sched', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                             'https://olympics.com/tokyo-2020/olympic-games/en/results/all-sports/olympic-schedule.htm\n']),
        # Medal standings in new tab
        (0x404000 , 'Medals', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                               'https://olympics.com/tokyo-2020/olympic-games/en/results/all-sports/medal-standings.htm\n']),
        (0x400000, 'Down', ' '),     # Scroll down
        # 3rd row ----------
        # Peacock streaming service Olympics home in new tab
        (0x000040, 'PC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                          'https://www.peacocktv.com/watch/2020-tokyo-olympics\n']),
        # NBC channel in new tab
        (0x000040, 'NBC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.usanetwork.com/live?brand=cnbc&callsign=nbc\n']),
        # Olympics youtube channel in new tab
        (0x000040 , 'YT', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.youtube.com/channel/UCTl3QQTvqHFjurroKxexy2Q\n']),
        # 4th row ----------
        # CNBC in new tab
        (0x000040, 'CNBC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                            'https://www.usanetwork.com/live?brand=nbc&callsign=cnbc\n']),
        # USA in new tab
        (0x000040, 'USA', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.usanetwork.com/live?brand=usa&callsign=usa_east\n']),
        # NBCSN in new tab
        (0x000040, 'NBCSN', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                             'https://www.usanetwork.com/live?brand=nbc-sports&callsign=nbcsn\n']),
        # Encoder button ---
        (0x000000, '', [Keycode.COMMAND, 'w']) # Close window/tab
    ]
}

# SPDX-FileCopyrightText: 2021 Isaac Wellish for Adafruit Industries
#
# SPDX-License-Identifier: MIT

# MACROPAD Olympic Hotkeys main page
# pylint: disable=line-too-long

from adafruit_hid.keycode import Keycode # REQUIRED if using Keycode.* values

app = {                # REQUIRED dict, must be named 'app'
    'name' : 'Olympics Home', # Application name
    'macros' : [       # List of button macros...
        # COLOR    LABEL    KEY SEQUENCE
        # 1st row ----------
        (0x004000, '< Tab', [Keycode.CONTROL, Keycode.SHIFT, Keycode.TAB]),
        (0x004000, 'Tab >', [Keycode.CONTROL, Keycode.TAB]),
        (0x400000, 'Up', [Keycode.SHIFT, ' ']),      # Scroll up
        # 2nd row ----------
        # Full schedule in new tab
        (0x3F3F3F, 'Sched', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                             'https://olympics.com/tokyo-2020/olympic-games/en/results/all-sports/olympic-schedule.htm\n']),
        # Medal standings in new tab
        (0x404000 , 'Medals', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                               'https://olympics.com/tokyo-2020/olympic-games/en/results/all-sports/medal-standings.htm\n']),
        (0x400000, 'Down', ' '),     # Scroll down
        # 3rd row ----------
        # Peacock streaming service Olympics home in new tab
        (0x000040, 'PC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                          'https://www.peacocktv.com/watch/2020-tokyo-olympics\n']),
        # NBC channel in new tab
        (0x000040, 'NBC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.usanetwork.com/live?brand=cnbc&callsign=nbc\n']),
        # Olympics youtube channel in new tab
        (0x000040 , 'YT', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.youtube.com/channel/UCTl3QQTvqHFjurroKxexy2Q\n']),
        # 4th row ----------
        # CNBC in new tab
        (0x000040, 'CNBC', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                            'https://www.usanetwork.com/live?brand=nbc&callsign=cnbc\n']),
        # USA in new tab
        (0x000040, 'USA', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                           'https://www.usanetwork.com/live?brand=usa&callsign=usa_east\n']),
        # NBCSN in new tab
        (0x000040, 'NBCSN', [Keycode.COMMAND, 't', -Keycode.COMMAND,
                             'https://www.usanetwork.com/live?brand=nbc-sports&callsign=nbcsn\n']),
        # Encoder button ---
        (0x000000, '', [Keycode.COMMAND, 'w']) # Close window/tab
    ]
}

Download the entire project code from above and save the specified files in your macros folder on your CIRCUITPY drive.

circuitpython_Screen_Shot_2021-07-27_at_10.31.23_AM.png

Make sure to delete any other unwanted files in this folder. The macros folder on your CIRCUITPY drive should look like this.

Mac or Windows?

There are two folders of macros code in this project. One for Mac users and one for Windows users.

circuitpython_Screen_Shot_2021-07-28_at_11.32.45_AM.png

When you download the project bundle drag only the files for your operating system into macros folder on your CIRCUITPY drive.

Page last edited March 08, 2024

Text editor powered by tinymce.

Using the Olympic Hotkeys

Once you have the code running, it's time to take it on the field and put it into action!

Browsers

You are welcome to use any browser you would like with the project. Make sure you have one open before pressing keys.

Commands

Tap on any key that's associated with a website (Sched, Medals, NBC, etc.), and that site will open up in a new tab on your browser
Close any tab by pressing down on the rotary encoder
Navigate between tabs by tapping the Tab keys
Navigate up and down web pages by tapping the up and down keys.
Scroll through the different macros pages to view all different sports and go back home by turning the rotary encoder

Accessing the various channels

There are 6 websites/channels with various live and past Olympic events in this project:

You will have to sign into each service before being able to view that channel's content. For all the live only channels (NBC, CNBC, NBCSN, and USA) you will only have to sign in once to the USA website as all these channels can be accessed through USA.

circuitpython_Screen_Shot_2021-07-22_at_3.08.13_PM.png

Going Further

Now is your chance to edit, adapt and change the macros code to however you'd like! Find another channel? Or just wanna have a Netflix button for good measure? You can add it! If you got this far, you earned a gold medal no matter what :)

Page last edited March 08, 2024