Skip to content

Enables Touch Bar support on any Old School RuneScape client ⚔️🏹

License

Notifications You must be signed in to change notification settings

pg8wood/OSRS-touch-bar

Repository files navigation

OSRS Touch Bar

OSRS Touch Bar displays Old School RuneScape interface icons and maps them to the corresponding function keys in-game.

Touch bar screenshot

Download

View the latest release

Usage

On launch, your Touch Bar will display the interface shown above until you quit OSRS Touch Bar (even if you switch apps).

Should you need to access the Control Strip, simply enable it with the Control Strip toggle.

The Touch Bar buttons can be resized with the Fit Buttons to Touch Bar button.

Quitting the app will restore your original Control Strip settings.

Note: if you have your Touch Bar configured to show only the "Expanded Control Strip" or "F1, F2, etc. Keys", OSRS Touch Bar cannot display the RuneScape UI in the Touch Bar! This can be toggled in System Preferences → Keyboard.

Customization

The Touch bar can be customized similarly to how the Control Strip is customized in System Preferences. You may add, remove, and reorder as many buttons as you wish.

Touch bar customization UI screenshot

API Note

It should be noted that, like other "global" Touch Bar apps (BetterTouchTool, Touch Bär, etc), OSRS-touch-bar goes against Apple's current Touch Bar guidelines.

In order to use OSRS-touch-bar in conjunction with the RuneScape client, a private API is necessary to circumvent Apple's restrictions on hiding the Control Strip. As such, OSRS-touch-bar links against a private Apple framework DFRFoundation.framework.

tl;dr Since the OSRS client doesn't have its own App Controls, this app adds its own App Controls in the (otherwise unused) Touch Bar space.

Happy 'Scaping!