{"data":{"model":{"id":"238307","slug":"programable-button-box-with-encoder-and-screen","name":"Programable Button Box with encoder and screen","authorship":"author","club":false,"excludeCommercialUsage":false,"price":null,"eduProject":null,"ratingAvg":"0E-10","myRating":null,"ratingCount":0,"description":"

This is a Button Box with 17 programable buttons as well as a rotary encoder and an OLED screen. This box is very customizable using some simple python code. You can program it to send individual key commands or program macros to send with the push of a button.

I used Thonny to put it all together but you can really use anything including a text editor like Notepad++.

Attn: You will also need the file font5x8.bin. Printables will not let me upload a bin file so I am including a link to the Git page. https://github.com/adafruit/Adafruit_CircuitPython_framebuf/blob/main/examples/font5x8.bin

The font5x8.bin file should be placed in the same spot as your code.py file. See font5x8_file_placement.pdf for a screenshot.

Printing:

Since I didn't need a lot of detail, I printed at .3 layer height in PETG for the case and .2 for the knob.

Hardware:

1 - Raspberry Pi Pico

1 - KY-040 Rotary Encoder

1 - .96in. SSD1306 compatible display. I used this one: https://a.co/d/by2PZQ6

16 - keyboard switches. I used these: https://a.co/d/dBdjb3q

16 - keycaps. I used some that I had laying around but any will work as long as they're compatible with the switches you choose.

Code:

I've added all of the Python code that I used except the font5x8.bin file which you will need to get from Adafruit's Github since Printables won't let me upload it here.

You can modify any of the keys by replacing the command with any (single or combination) of commands from the attached Keycode.py file.

The current setup has the rotary encoder setup to control Volume up/down and the encoder button is setup for Mute/Unmute.

I also setup the keys to link to numbers and symbols but they can be easily changed to any combination of the keycodes found in keycode.py

*** Important note ***

You will need to make sure you have included all of the module files in a folder named \\lib

within that folder you will also need to have a folder named adafruit_hid. The files should follow the structure in file_structure_for_modules.pdf.

in the \\lib file you should have the following:

(folder named) adafruit_hid

adafruit_framebuf.py

adafruit_ssd1306.py

in the \\lib\\adafruit_hid folder you should have the following:

__init__.py (When you download all of the files from Printables.com it will change the filename of this file. You will need to add two underscores to both sides of init.py to make it __init__.py.

consumer_control.py

consumer_control_code.py

keyboard.py

keyboard_layout_base.py

keyboard_layout_us.py

keycode.py

mouse.py

Wiring diagram:

I've included a wiring diagram based on how mine is setup for reference.

","category":{"id":"27","path":[{"id":"21","name":"Gadgets","nameEn":"Gadgets","description":"Everyone loves smart gadgets. Use 3D printing to make amazing items for audio, photo & video, computers, and phones. Top models are ready to download for free.","__typename":"CategoryType"},{"id":"27","name":"Computers","nameEn":"Computers","description":"Tons of laptop and PC gaming 3D printable accessories and components of all kinds will amaze you. Make great projects with Raspberry Pi and other tech gadgets.","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-07-18T19:09:02.898509+00:00","firstPublish":"2022-07-08T17:40:45.755310+00:00","datePublished":"2022-07-08T17:40:45.755310+00:00","dateCreatedThingiverse":null,"nsfw":false,"summary":"This is a 17 key button box with an encoder and an OLED screen. It utilized a $4 Raspberry Pi Pico as the brains.","likesCount":35,"makesCount":0,"liked":null,"printDuration":null,"numPieces":0,"weight":null,"nozzleDiameters":null,"usedMaterial":null,"layerHeights":null,"mmu":false,"materials":[],"dateFeatured":null,"downloadCount":81,"displayCount":1318,"filesCount":18,"privateCollectionsCount":33,"publicCollectionsCount":29,"pdfFilePath":"media/prints/238307/pdfs/238307-programable-button-box-with-encoder-and-screen-26ee0cc2-b728-40a9-92dd-effe13d33284.pdf","commentCount":0,"userGcodeCount":0,"remixCount":0,"canBeRated":false,"printer":null,"image":{"id":"1056643","filePath":"media/prints/238307/images/2156669_600433ff-83a2-4478-906e-a31c262627e3/right-view.jpg","rotation":0,"imageHash":"FQgGBIAIW8o411R1mZp3sBcdjw==","imageWidth":4032,"imageHeight":2268,"__typename":"PrintImageType"},"images":[{"id":"1056643","filePath":"media/prints/238307/images/2156669_600433ff-83a2-4478-906e-a31c262627e3/right-view.jpg","rotation":0,"imageHash":"FQgGBIAIW8o411R1mZp3sBcdjw==","imageWidth":4032,"imageHeight":2268,"__typename":"PrintImageType"},{"id":"1056641","filePath":"media/prints/238307/images/2156672_414719a4-1fa2-4ae1-b955-da119a0e822f/left-view.jpg","rotation":0,"imageHash":"EwgGDIIMJMZzWpZlp3n1mGKvWQ==","imageWidth":4032,"imageHeight":2268,"__typename":"PrintImageType"},{"id":"1056642","filePath":"media/prints/238307/images/2156670_156edc32-6f80-4b01-b1ad-617fae6eb761/front-view.jpg","rotation":0,"imageHash":"FAgKDABqh3ZWhnkIZ6efaeP8Jg==","imageWidth":2268,"imageHeight":4032,"__typename":"PrintImageType"},{"id":"1056644","filePath":"media/prints/238307/images/2156671_f346324d-a813-4357-9cd9-d9c1740e99e3/wiring-view.jpg","rotation":0,"imageHash":"GQgODAJamncIl4lXZ4efqtZfiQ==","imageWidth":2268,"imageHeight":4032,"__typename":"PrintImageType"},{"id":"1077502","filePath":"media/prints/238307/images/2200703_b2f44ed5-054f-4aa7-ac77-77b0c7375f30/font5x8bin-placement.jpg","rotation":0,"imageHash":"yPcBBIB674t4eId0aIj6vXn/mw==","imageWidth":781,"imageHeight":387,"__typename":"PrintImageType"}],"tags":[{"name":"led","id":"242","__typename":"TagType"},{"name":"usb","id":"2514","__typename":"TagType"},{"name":"screen","id":"2700","__typename":"TagType"},{"name":"buttonbox","id":"3930","__typename":"TagType"},{"name":"keypad","id":"5003","__typename":"TagType"},{"name":"rotaryencoder","id":"6430","__typename":"TagType"},{"name":"oled","id":"7720","__typename":"TagType"},{"name":"programmable","id":"19817","__typename":"TagType"}],"thingiverseLink":null,"filesType":null,"previewFile":{"id":"1002400","filePreviewPath":"media/prints/238307/stls/2156665_f505e568-95f7-4331-bd84-8e57f5c21d32/button-box-box_preview.png","__typename":"STLType"},"license":{"id":"12","disallowRemixing":false,"__typename":"LicenseType"},"remixParents":[],"remixDescription":null,"__typename":"PrintType","user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isFollowedByMe":false,"isHiddenForMe":false,"canBeFollowed":true,"billingAccountType":"personal","lowestTierPrice":null,"highlightedModels":{"models":[{"id":"136756","name":"Heart Ring","slug":"heart-ring","ratingAvg":"4.3333333333","likesCount":108,"liked":null,"datePublished":"2022-02-20T14:54:35.835078+00:00","dateFeatured":null,"firstPublish":"2022-02-20T14:54:35.835078+00:00","downloadCount":905,"mmu":false,"category":{"id":"42","path":[{"id":"17","name":"Fashion","nameEn":"Fashion","__typename":"CategoryType"},{"id":"42","name":"Other Fashion Accessories","nameEn":"Other Fashion Accessories","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-02-20T14:54:35.854790+00:00","image":{"id":"662072","filePath":"media/prints/136756/images/1303905_cd461977-0a69-4c25-a72a-4aa808fde2ce/rosegold.jpg","rotation":0,"imageHash":"FggCDoLIR5aAe4Z5halXiWh7CImDkDg=","imageWidth":682,"imageHeight":590,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"661157","name":"Quest 3 Gunstock adapters for Sanlaki gunstock","slug":"quest-3-gunstock-adapters-for-sanlaki-gunstock","ratingAvg":"4.5000000000","likesCount":88,"liked":null,"datePublished":"2024-04-13T03:10:54.722133+00:00","dateFeatured":null,"firstPublish":"2023-11-27T01:34:43.564974+00:00","downloadCount":515,"mmu":false,"category":{"id":"100","path":[{"id":"21","name":"Gadgets","nameEn":"Gadgets","__typename":"CategoryType"},{"id":"100","name":"Video Games","nameEn":"Video Games","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2024-04-13T03:10:55.183075+00:00","image":{"id":"2455288","filePath":"media/prints/661157/images/5208375_f09eb1d7-a8ef-4031-b809-1d6414f76773_2ce26e9e-ba73-4e52-98dd-60d6d347e074/pxl_20231127_013045215.jpg","rotation":0,"imageHash":"KQgGBYB+WqRgmHZuZfh3bq5xnwao","imageWidth":4080,"imageHeight":3072,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"140444","name":"Hinged Box","slug":"hinged-box","ratingAvg":"4.6666666667","likesCount":76,"liked":null,"datePublished":"2022-02-27T03:37:18.697742+00:00","dateFeatured":null,"firstPublish":"2022-02-27T03:37:18.697742+00:00","downloadCount":839,"mmu":false,"category":{"id":"29","path":[{"id":"3","name":"Household","nameEn":"Household","__typename":"CategoryType"},{"id":"29","name":"Office","nameEn":"Office","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-03-02T16:20:00.911802+00:00","image":{"id":"676197","filePath":"media/prints/140444/images/1332577_f45e8700-0542-4549-98c9-756f8853672d/box.jpg","rotation":0,"imageHash":"F/YFHYDHmJiAeHd5iGd4i8eJj6z4","imageWidth":759,"imageHeight":522,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"238307","name":"Programable Button Box with encoder and screen","slug":"programable-button-box-with-encoder-and-screen","ratingAvg":"0E-10","likesCount":35,"liked":null,"datePublished":"2022-07-08T17:40:45.755310+00:00","dateFeatured":null,"firstPublish":"2022-07-08T17:40:45.755310+00:00","downloadCount":81,"mmu":false,"category":{"id":"27","path":[{"id":"21","name":"Gadgets","nameEn":"Gadgets","__typename":"CategoryType"},{"id":"27","name":"Computers","nameEn":"Computers","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-07-18T19:09:02.898509+00:00","image":{"id":"1056643","filePath":"media/prints/238307/images/2156669_600433ff-83a2-4478-906e-a31c262627e3/right-view.jpg","rotation":0,"imageHash":"FQgGBIAIW8o411R1mZp3sBcdjw==","imageWidth":4032,"imageHeight":2268,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"137962","name":"Pulley - 40mm, 50mm, or 60mm","slug":"pulley-40mm-50mm-or-60mm","ratingAvg":"0E-10","likesCount":26,"liked":null,"datePublished":"2022-02-22T18:35:04.811730+00:00","dateFeatured":null,"firstPublish":"2022-02-22T18:35:04.811730+00:00","downloadCount":180,"mmu":false,"category":{"id":"49","path":[{"id":"48","name":"Hobby & Makers","nameEn":"Hobby & Makers","__typename":"CategoryType"},{"id":"49","name":"Tools","nameEn":"Tools","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-02-25T02:08:02.809718+00:00","image":{"id":"668034","filePath":"media/prints/137962/images/1316292_64cf35fe-195e-4e36-8585-a88806faced1/pxl_20220223_014858219.jpg","rotation":0,"imageHash":"WRgKBgAFeKhrhBe5dlapdmh3WbXwqx0=","imageWidth":2287,"imageHeight":2493,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"607723","name":"Breadboard Mount with Power Terminals","slug":"breadboard-mount-with-power-terminals","ratingAvg":"0E-10","likesCount":20,"liked":null,"datePublished":"2023-10-09T21:35:16.949186+00:00","dateFeatured":null,"firstPublish":"2023-10-08T22:51:25.429307+00:00","downloadCount":47,"mmu":false,"category":{"id":"96","path":[{"id":"90","name":"Learning","nameEn":"Learning","__typename":"CategoryType"},{"id":"96","name":"Other 3D Objects for Learning","nameEn":"Other 3D Objects for Learning","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2023-10-09T21:35:16.969199+00:00","image":{"id":"2287750","filePath":"media/prints/607723/images/4830333_78a1bed3-5221-469d-818c-45c2082c5180_5905f4c1-ed99-48fa-a4cb-2ce0ebf1e669/pxl_20231008_181340054.jpg","rotation":0,"imageHash":"JAgGDYI0rY1TWoqdO/g2q2mPvfbJ","imageWidth":4080,"imageHeight":3072,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"261229","name":"Medium hinged box","slug":"medium-hinged-box","ratingAvg":"0E-10","likesCount":13,"liked":null,"datePublished":"2022-08-18T15:27:49.937459+00:00","dateFeatured":null,"firstPublish":"2022-08-18T13:56:12.717389+00:00","downloadCount":217,"mmu":false,"category":{"id":"50","path":[{"id":"48","name":"Hobby & Makers","nameEn":"Hobby & Makers","__typename":"CategoryType"},{"id":"50","name":"Organizers","nameEn":"Organizers","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-08-18T15:27:49.966220+00:00","image":{"id":"1149810","filePath":"media/prints/261229/images/2333766_e1ab5a52-4675-4fbf-a93b-6380750d7906/med-hinged-box.jpg","rotation":0,"imageHash":"F/YJHICqlYeAiHdqmIejiW+b+A==","imageWidth":817,"imageHeight":517,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"},{"id":"139374","name":"Printer Feet","slug":"printer-feet","ratingAvg":"0E-10","likesCount":12,"liked":null,"datePublished":"2022-02-25T02:47:15.143723+00:00","dateFeatured":null,"firstPublish":"2022-02-25T02:47:15.143723+00:00","downloadCount":161,"mmu":false,"category":{"id":"2","path":[{"id":"1","name":"3D Printers","nameEn":"3D Printers","__typename":"CategoryType"},{"id":"2","name":"Other Printer Parts & Upgrades","nameEn":"Other Printer Parts & Upgrades","__typename":"CategoryType"}],"__typename":"CategoryType"},"modified":"2022-02-25T02:47:15.154689+00:00","image":{"id":"672021","filePath":"media/prints/139374/images/1324184_21370fd5-e9c1-437c-b983-9bf417122166/feet-tpu.jpg","rotation":0,"imageHash":"EwgGBYDnqIl7lUePZkOHlwSSBAAA","imageWidth":1128,"imageHeight":774,"__typename":"PrintImageType"},"nsfw":false,"club":false,"price":null,"user":{"id":"219037","handle":"Nebbish","verified":false,"dateVerified":null,"publicUsername":"Nebbish","avatarFilePath":"media/auth/avatars/12/127a3562-e5bc-4c5d-8a01-13f9e928fcda.jpg","badgesProfileLevel":{"profileLevel":18,"__typename":"BadgesProfileLevelType"},"__typename":"UserType","isHiddenForMe":false},"latestContestResult":null,"__typename":"PrintType"}],"featured":false,"__typename":"HighlightedModelsType"},"designer":false,"stripeAccountActive":null,"membership":null},"contests":[],"contestsResults":[],"prusameterPoints":null,"latestContestResult":null}}}