https://github.com/pg8wood/osrs-touch-bar

Enables Touch Bar support on any Old School RuneScape client ⚔️🏹
https://github.com/pg8wood/osrs-touch-bar

appkit cocoa control-strip oldschool-runescape osrs runescape swift-4 touch-bar touchbar

Last synced: 2 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/pg8wood/osrs-touch-bar
• Owner: pg8wood
• License: mit
• Created: 2018-02-25T08:35:44.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2020-06-03T18:11:39.000Z (over 4 years ago)
• Last Synced: 2024-09-29T00:21:43.707Z (3 months ago)
• Topics: appkit, cocoa, control-strip, oldschool-runescape, osrs, runescape, swift-4, touch-bar, touchbar
• Language: Swift
• Homepage:
• Size: 5.49 MB
• Stars: 18
• Watchers: 4
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# OSRS Touch Bar

OSRS Touch Bar displays [Old School RuneScape](http://oldschool.runescape.com) interface icons and maps them to the corresponding function keys in-game. 

![Touch bar screenshot](./docs/touchBarScreenshot.png)

# 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](./docs/customization.png)

## API Note

It should be noted that, like other "global" Touch Bar apps ([BetterTouchTool](https://www.boastr.net/), [Touch Bär](https://github.com/a2/touch-baer), 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!