Skip to the content
2 layers60 × 45.5 mmMiniMacroKeyboard, the printed circuit board in 3D

Eine kleine USB-Makro-Tastatur auf Basis eines Raspberry Pi Pico, programmiert in CircuitPython. Der Pico meldet sich am PC als Composite-HID-Gerät (Tastatur + Maus gleichzeitig) und macht auf einer selbstgebauten…

Size
60 × 45.5 mm
Copper layers
2
Thickness
1.6 mm
Parts
17
Nets
46
Pads
144
Tracks, vias
89, 3
Pours
2
Routed
Yes
KiCad
KiCad 10.0 (file 20260206)
Created
23 Sep 2026
Updated
30 Sep 2026

Overview

MiniMacroKeyboard is an open-source printed circuit board by 100prznt, from the 100prznt/MiniMacroKeyboard repository on GitHub, published under the MIT licence. It is a 2-layer board of 60 × 45.5 mm with 17 parts on 46 nets, routed with 89 tracks and 3 vias.

It is built around the BSS138. Its parts include 3 capacitors, 3 resistors and 1 transistor. It belongs with the RP2040 boards of this library.

Main components

1

README

README.md

Mini Macro Keyboard (Raspberry Pi Pico)

Build status Release Downloads License

Eine kleine USB-Makro-Tastatur auf Basis eines Raspberry Pi Pico, programmiert in CircuitPython. Der Pico meldet sich am PC als Composite-HID-Gerät (Tastatur + Maus gleichzeitig) und macht auf einer selbstgebauten 3-Taster-Platine ein paar wiederkehrende Eingaben und eine kleine Anwesenheitssimulation überflüssig.

Ein Windows-Companion-Programm in C# (MacroKeyboardSync/) läuft im Hintergrund und meldet dem Pico über einen zweiten USB-CDC-Kanal Uhrzeit, die aktuell aktive Anwendung und den Sperrstatus des PCs.

MMK1 Rendering

Funktionen

Die Platine hat drei Taster (M1–M3), alle gegen GND schaltend:

TasteAktion
M1Beim Loslassen: zweizeiliger TODO-Kommentar mit Name/Kürzel und aktuellem Zeitstempel, z. B. // Mustermann, Max (MM/Abt1) 23.09.2026 10:23:34 gefolgt von einer leeren Kommentarzeile // (Zeilenumbruch per Shift+Enter)
M2Beim Loslassen: Text M2 (Platzhalter, frei anpassbar)
M3Kurzer Druck: gibt beim Loslassen die aktuell aktive Anwendung aus (siehe unten). Langer Druck (≥ 0,5 s): schaltet den Mausjiggler sofort um, ohne auf das Loslassen zu warten
M1 + M3 (gleichzeitig)Löscht per Backspace das letzte Zeichen im aktiven Feld, wartet kurz und gibt dann einen hinterlegten Text (TEXT_M4) + Enter aus – nur wenn entweder eine bestimmte Anwendung (in code.py festgelegt) im Vordergrund ist oder der PC gerade gesperrt ist. M2 bleibt davon unbeteiligt

Mausjiggler: Solange aktiv (Standard: direkt nach dem Einschalten), bewegt sich der Mauszeiger alle 25 Sekunden minimal, um Bildschirmschoner/Abwesend-Status (z. B. in Teams) zu verhindern. Die Onboard-LED pulsiert währenddessen in einem Herzschlag-Muster (zwei Auf-/Abdimm-Pulse, kurze Pause, dann eine längere Pause).

Status-LEDs: Drei adressierbare RGB-LEDs (LTST-E683CEGBW) unter den Tastern, in Reihe an GPIO18 über einen BSS138-Levelshifter angeschlossen, zeigen den aktuellen Zustand an:

  • Aktive Anwendung: alle drei LEDs leuchten in einer festen Farbe je nach WIN:-Tag – z. B. Lila für Visual Studio, Orange für KiCad, Grün für den KiCad-PCB-Editor, Rot für Opera, Weiß für den Explorer, Blau für Outlook/Teams, Lila für GitHub Desktop. Unbekannte Anwendungen zeigen ein gedimmtes Grau (DEFAULT).
  • VPN-Client aktiv: die LEDs blinken abwechselnd Rot/Blau, wie ein US-Polizeiauto.
  • PC gesperrt: rotes Lauflicht über die drei LEDs (Knight-Rider-/KITT-Effekt), zusätzlich gedimmt gegenüber den übrigen Zuständen. Hat Vorrang vor allen anderen Anzeigen.

Die Helligkeit aller Status-LEDs ist über die Konstante MAX_BRIGHTNESS in code.py gedeckelt (Standard: 75 %).

Sync mit dem PC: Die Companion-App erkennt über die USB-Vendor-ID automatisch den passenden COM-Port und sendet dem Pico:

  • TIME: alle 5 Minuten (stellt die Software-RTC des Pico)
  • WIN: bei jedem Wechsel der aktiven Anwendung (VS, VS Code, KiCad, KiCad-PCB-Editor, Opera, Explorer, Outlook, GitHub Desktop, Teams, VPN-Client – alles andere als DEFAULT)
  • LOCK: bei Sperren/Entsperren sowie als Heartbeat alle 15 Sekunden, damit der Pico eine tote Verbindung erkennt

Ohne aktuelle Nachricht vom PC (z. B. direkt nach einem Neustart, bevor die Companion-App läuft) geht der Pico sicherheitshalber von "gesperrt" aus.

Hardware

  • Raspberry Pi Pico
  • Eigene Taster-Platine mit 3 Tastern gegen GND:
    • M1 → GPIO17
    • M2 → GPIO26
    • M3 → GPIO28
  • 3x adressierbare RGB-LED LTST-E683CEGBW (in Reihe), Datenleitung an GPIO18 über einen BSS138-Levelshifter

CAD-Ansichten

Von obenVon rechts
CAD-Ansicht von obenCAD-Ansicht von rechts

Rechts: Auf der Unterseite des 3D-gedruckten Rahmens sorgen 4 Gummipuffer für einen sicheren Stand.

Erster Hardwareaufbau

Erster Hardwareaufbau

Repo-Struktur

text
src/boot.py       Aktiviert den zweiten USB-CDC-Datenkanal (usb_cdc.data)
src/code.py       Hauptprogramm: Taster-Logik, HID-Ausgabe, Mausjiggler, Status-LEDs, Sync
src/macros.py.template  Vorlage fuer macros.py (TEXT_M2, TEXT_M4, TODO_SIGNATURE)
src/lib/          Benötigte CircuitPython-Bibliotheken (adafruit_hid, neopixel, dt. Tastaturlayout)
install/          CircuitPython-UF2 für den Pico (de_DE)
MacroKeyboardSync/ Windows-Companion-App (C#, .NET 8)

Einrichtung (Pico)

  1. CircuitPython auf den Pico flashen (die passende UF2-Datei liegt auch in install/).

  2. Den Ordner src/lib/ in den Ordner lib/ auf dem CIRCUITPY-Laufwerk kopieren. Er enthält bereits alle benötigten Bibliotheken, sie müssen nicht separat heruntergeladen werden:

    Die zugehörigen Lizenzen liegen als LICENSE-* daneben (beide MIT). Wer lieber aktuelle Versionen nutzt, kann sie stattdessen selbst aus dem Adafruit CircuitPython Bundle bzw. dem Neradoc-Repo holen.

  3. boot.py und code.py aus src/ auf das CIRCUITPY-Laufwerk kopieren.

  4. src/macros.py.template nach macros.py kopieren (muss neben code.py liegen) und an die eigenen Texte anpassen (Name/Kürzel für M1, Text für die M1+M3-Combo). macros.py ist bewusst per .gitignore ausgeschlossen, damit persönliche Texte nicht versehentlich committet werden.

Einrichtung (Companion-App)

  1. MacroKeyboardSync/ mit .NET 8 SDK bauen (dotnet build bzw. Visual Studio).
  2. Die App beim Windows-Systemstart starten lassen (z. B. Autostart-Ordner oder Aufgabenplanung) – sie läuft ohne Konsolenfenster im Hintergrund.
  3. Erkannte Anwendungen sind in der KnownApps-Dictionary in Program.cs hinterlegt und lassen sich dort um weitere Prozessnamen ergänzen. Läuft eine Anwendung (wie z. B. KiCad) bei dir komplett unter einem einzigen Prozess, wird in GetActiveAppTag() zusätzlich der Fenstertitel ausgewertet, um z. B. den PCB-Editor separat zu erkennen – Titeltext ggf. an die eigene Sprachversion anpassen.

Hinweis zur M1+M3-Combo

Der bei TEXT_M4 hinterlegte Text ist bei mir persönlich durch ein Passwort ersetzt, das nur bei passender Anwendung bzw. gesperrtem PC getippt wird. Wer das Repo als Vorlage nutzt: Der Wert liegt aktuell als Klartext in macros.py auf dem Flash-Speicher des Pico – bei physischem Zugriff auf das Gerät ist er auslesbar. Für den privaten Gebrauch an einem einzelnen, vertrauenswürdigen Rechner ist das ein bewusst akzeptiertes Risiko, kein Ersatz für einen echten Passwortmanager.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz.

Parts

17
QtyValueFootprintReferences
3CCapacitor_SMD:C_0603_1608MetricC1, C2, C3
3CherryMX_LTST-A683CEGBWCherryMX_PCB_LTST-A683CEGBW:CherryMX_1.00u_PCB_LTST-A683CEGBWM1, M2, M3
3TestPointTestPoint:TestPoint_Keystone_5019_MiniatureTP1, TP2, TP3
210KResistor_SMD:R_0603_1608MetricR2, R3
1330RResistor_SMD:R_0603_1608MetricR1
1BSS138Package_TO_SOT_SMD:SOT-23Q1
1RaspberryPi_PicoModule:RaspberryPi_Pico_SMDA1

The 14 most common of 17 parts.

Similar boards

  • 4 layers36 × 50.2 mmRacer, the printed circuit board in 3D

    Racer

    StuckAtPrototype/Racer

    These are structured into their own files. I could have used submodules, but decided against it.

    83 parts3.8kApache-2.0
  • 4 layers95 × 95 mmCube motherboard, the printed circuit board in 3D

    Cube motherboard

    willem-pennings/balancing-cube

    A cube that balances itself in a corner or edge using reaction wheels

    52 parts1.1kGPL-3.0
  • 2 layers54.6 × 70.9 mmBeagleLogic Cape, the printed circuit board in 3D

    BeagleLogic Cape

    abhishek-kakkar/BeagleLogic

    A Software Suite that implements a logic analyzer with the PRU on the BeagleBone / BeagleBone Black.

    22 parts479GPL-3.0
  • 2 layers44.2 × 29.3 mmI2c tiny usb, the printed circuit board in 3D

    I2c tiny usb

    harbaum/I2C-Tiny-USB

    Cheap and simple I²C to USB interface

    27 parts454
  • 2 layers21.6 × 52.3 mmPs2 pico hat, the printed circuit board in 3D

    Ps2 pico hat

    No0ne/ps2x2pico

    USB keyboard/mouse to PS/2 interface converter using a Raspberry Pi Pico

    17 parts399MIT
  • 2 layers45 × 45 mmAirCube, the printed circuit board in 3D

    AirCube

    StuckAtPrototype/AirCube

    Works standalone out of the box. Pairs with Home Assistant in minutes. Other platforms are supported through community-contributed extensions.

    61 parts379Apache-2.0
  • 4 layers74 × 104 mmBeepy, the printed circuit board in 3D

    Beepy

    sqfmi/beepy-hardware

    Beepy Hardware

    160 parts348MIT

Questions

How big is the MiniMacroKeyboard PCB?

It measures 60 × 45.5 mm and has 2 copper layers, 1.6 mm thick.

What parts does the MiniMacroKeyboard use?

17 parts, built around the BSS138. The full list of its parts is on this page, with links to each part's symbol and footprint where PCBKit's library has them.

Where can I download the MiniMacroKeyboard KiCad files?

From the 100prznt/MiniMacroKeyboard repository on GitHub, at the commit this page was made from: the board is hardware/MiniMacroKeyboard/MiniMacroKeyboard.kicad_pcb and its schematic hardware/MiniMacroKeyboard/MiniMacroKeyboard.kicad_sch. PCBKit opens the board in the browser, with nothing to install.

Can I use the MiniMacroKeyboard design in my own project?

Its repository publishes it under the MIT licence: you may reuse it on that licence's terms (keep the author's notice, and for a copyleft licence share your changes alike).