Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/loretoparisi/touchbar

Apple MacBook Pro TouchBar (NSTouchBar) Cheatsheet and Swift examples
https://github.com/loretoparisi/touchbar

apple-macbook cheatsheet macbook touchbar xcode

Last synced: 3 months ago
JSON representation

Apple MacBook Pro TouchBar (NSTouchBar) Cheatsheet and Swift examples

Host: GitHub
URL: https://github.com/loretoparisi/touchbar
Owner: loretoparisi
Created: 2016-10-28T09:54:05.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2017-01-04T02:28:04.000Z (almost 8 years ago)
Last Synced: 2024-07-18T12:15:10.363Z (4 months ago)
Topics: apple-macbook, cheatsheet, macbook, touchbar, xcode
Homepage: http://loretoparisi.com/
Size: 4.79 MB
Stars: 368
Watchers: 13
Forks: 32
Open Issues: 1
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# touchbar
Apple MacBook Pro TouchBar (NSTouchBar) Cheat Sheet

## How to enable the TouchBar simulator
To enable the `TouchBar` simulator you need `Xcode Version 8.1 (8B62) ` and `macOS 10.12.1` build `12B2657`. You can update Xcode via AppStore. To check your macOS build type in your Terminal

```
$ sw_vers
ProductName: Mac OS X
ProductVersion: 10.12.1
BuildVersion: 16B265
```

If you are running the previous build of `10.12.1` (16B2555), you have to manually update from Apple Support: https://support.apple.com/kb/dl1897?locale=en_US

Assumed you did the previous steps, open Xcode and the Window menu should look like

![schermata 2016-10-31 alle 19 56 51](https://cloud.githubusercontent.com/assets/163333/19867500/5888c9ce-9fa4-11e6-9ad9-b490e8863341.jpg)

so you should see the `Show Touch Bar` option just after the Organizer option.

## The TouchBar Cheat Sheet
![touchbar_layout_cheatsheet](https://cloud.githubusercontent.com/assets/163333/19802765/82767df4-9d05-11e6-8a21-71359fac1afb.png)

## Launch the Touch Bar simulator programmatically
The [TouchBarLauncher](https://github.com/zats/TouchBarLauncher) Xcode program in Swift, let you run the Touch Bar simulator programmatically and it's very handy. Made by [Sash Zats](https://github.com/zats) it uses the simulator host window controller `IDETouchBarSimulatorHostWindowController` to leverage the TouchBar.

## Touch Bar integrations
- [React Native TouchBar](https://github.com/ptmt/react-native-touchbar) is a [React Native](https://github.com/facebook/react-native) component that adds support for the macOS `TouchBar` in React Native.
- [Electron](https://github.com/electron/electron/issues/7781), Support MacBook Touch Bar API
- [NW.js aka NodeWebKit](https://github.com/nwjs/nw.js/issues/5501)

## References
- [About the TouchBar]( https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/AbouttheTouchBar.html)
- [Visual Design](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/VisualDesign.html#//apple_ref/doc/uid/20000957-CH106-SW1)
- [Interaction and Gestures](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/Interaction.html#//apple_ref/doc/uid/20000957-CH105-SW1)
- [TouchBar Icons](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/Icons.html#//apple_ref/doc/uid/20000957-CH107-SW1)
- [TouchBar Controls](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/ControlsandViews.html#//apple_ref/doc/uid/20000957-CH108-SW1)

## NSTouchbar class
The [NSTouchbar](https://developer.apple.com/reference/appkit/nstouchbar) is an object that provides dynamic contextual controls in the Touch Bar of supported models of MacBook Pro.

The `NSTouchbar` Class Diagram
touchbarclass

## Touchbar Examples API
- [NSTouchBar Catalog](https://github.com/loretoparisi/touchbar/tree/master/examples/NSTouchBarCatalogCreatingandCustomizingNSTouchBar), Creating and Customizing NSTouchBar
- [ToolbarSample](https://github.com/loretoparisi/touchbar/tree/master/examples/ToolbarSampleUsingNSToolbartoconstructawindowtoolbar), ToolbarSample: Using NSToolbar to construct a window toolbar

## Touchbar Tools
- [TouchBarScreenshotter](https://github.com/steventroughtonsmith/TouchBarScreenshotter), easily snap screenshots of the currently presented Touch Bar in macOS
- [TouchBarDemoApp](https://github.com/bikkelbroeders/TouchBarDemoApp), Allows you to use your macOS Touch Bar from an iPad (through USB connection) or on-screen by pressing the Fn-key.

## Touchbar Example Apps
- [KnightTouchBar2000](https://github.com/AkdM/KnightTouchBar2000), KITT 2000 chaser animation for your MacBook Pro TouchBar.
- [TouchFart](https://github.com/hungtruong/TouchFart), A fart app for the new Macbook Pro's Touch Bar
- [Touchbar Nyancat](https://github.com/avatsaev/touchbar_nyancat), nyancat animation on your +$2k MacBook Pro's Touchbar

## Touchbar Games (!)
- [Touch Bar Space Fight](https://github.com/insidegui/TouchBarSpaceFight)

## Touchbar Tutorials
- [How to Use NSTouchBar on macOS](https://www.raywenderlich.com/147118/use-nstouchbar-macos)
- [NSTouchBar 开发教程 (Development Tutorial, Chinese, Ed.)](http://www.macdev.io/tutorial/NSTouchBar.html)