Model M Remap icon

Model M Remap

Your classic IBM keyboard, with macOS shortcuts.

Model M Remap is a free Mac menubar app for setting up the keys of an IBM Model M connected through a Soarer's Converter. Every shortcut shows on the keyboard map. Click a key to add, change or remove what it does.

macOS 13 or later · Apple silicon · Free

Photo of the founder's IBM Model M 122-key, the keyboard used to build Model M Remap
Our IBM Model M 122-key. This keyboard is why the app exists.

Why we built Model M Remap

We use an IBM Model M 122-key, a classic terminal keyboard with 24 function keys and 10 extra keys on the left. The typing feel is unmatched, but on a Mac it feels foreign: there is no Command key, no key for copy, paste or screenshots, and its 34 extra keys do nothing.

The answer is Soarer's Converter, a community-made USB adapter that turns an old keyboard into a USB keyboard. Its settings live inside the adapter, so they work on any computer with no program running. The catch: the bundled tools are text commands and configuration files edited by hand, and one failed write can wipe the whole configuration.

We started with one simple command: press a key, choose what it does. After a dozen shortcuts we needed the whole picture: which keys are taken and which are still free. So we drew a map over a photo of our own keyboard, like the picture below. That map is what made us build this Mac app, so seeing and changing shortcuts takes a single click.

The first map: a photo of the real keyboard with the installed shortcuts and the list of keys
Our first map: a photo of the real keyboard with the shortcuts already installed. The Mac app was born from this picture.

How Model M Remap solves it

Every feature came from a real problem while setting up this keyboard.

A living keyboard map

Your keyboard layout is drawn with what every key does. Orange for shortcuts, blue for remaps, red when two rules clash, grey when empty.

Add, change, delete with a click

No configuration files to edit. Want to add a key that is not on the map? Press it on the keyboard and the app recognizes it by itself.

Eight keyboard profiles

IBM Model M 122-key, 101-key, 102-key ISO, Space Saving, PC/AT 84-key, PC/XT 83-key, plus generic 104- and 105-key layouts. A profile of your own is just one JSON file.

Safe to change

Every change is preceded by a backup, retried if it fails, and rolled back if it still fails. Your configuration is not lost to a single failed write.

Works without the app

The rules live in the adapter, not on the Mac. Quit the app or move to another computer and the shortcuts keep working.

Your own names for keys

Give any key a label like Open Terminal. Labels are stored on your Mac and shown on the map.

See the app

Every image below is the app's real window, not a mockup.

Get started in three steps

  1. 1

    Prepare the adapter

    Your Model M must be connected through a Soarer's Converter, a community-made Teensy-based adapter. We do not sell the adapter.

  2. 2

    Install with one command

    Open Terminal, paste the command below and press Enter. Model M Remap is installed in Applications and opens right away.

  3. 3

    Pick a profile and start

    Pick your keyboard profile in the Keyboard tab, then click a key on the map to set up your first shortcut.

Paste into Terminal (Apple silicon Mac, macOS 13 or later):

curl -fsSL https://remoteworker.id/api/releases/modelm-remap/latest/installer | sh

Built on community work

Model M Remap is made of a command line tool, a Mac app and a profile for each keyboard. The tools for Soarer's Converter are built from the sctools project (BSD-2-Clause) with two small fixes that we include. Soarer's Converter itself is the work of Soarer and its community.

Your data stays yours

This app uses no account and sends nothing to the internet. The configuration lives in the adapter; backups and labels live on your own Mac.

Questions about Model M Remap

Is it free?

Yes, it is free.

Do I need a Soarer's Converter?

Yes. This app manages what is stored in that adapter. An ordinary USB keyboard has no configuration storage like it.

Which keyboards are supported?

Every keyboard Soarer's Converter supports: PC/XT, AT, PS/2, 122-key terminal keyboards and IBM RT. Pictured maps exist for eight layouts; other keyboards can still be set up through the rules list and the key-detection button.

Can the app recognize the keyboard model automatically?

Only partly. The adapter recognizes the keyboard protocol, not its make or model, so you pick the matching map profile yourself.

Does it run on Windows or Linux?

The rules stored in the adapter work on any operating system, but the app is only available for macOS for now.

Does macOS show a warning when the app opens?

No, when you install it with the command above. The app is not notarized by Apple yet, but a file downloaded in Terminal gets no quarantine flag, so macOS opens it right away.

Which Mac do I need?

A Mac with Apple silicon and macOS 13 or later. The app uses python3 from the Xcode Command Line Tools.

Give your Model M the shortcuts it deserves.

Free. Install with one command, pick your keyboard profile and set up its keys with one click.