{"id":13785641,"url":"https://github.com/loretoparisi/touchbar","last_synced_at":"2025-05-11T21:31:30.963Z","repository":{"id":139861247,"uuid":"72195898","full_name":"loretoparisi/touchbar","owner":"loretoparisi","description":"Apple MacBook Pro TouchBar (NSTouchBar) Cheatsheet and Swift examples","archived":false,"fork":false,"pushed_at":"2017-01-04T02:28:04.000Z","size":5026,"stargazers_count":367,"open_issues_count":1,"forks_count":30,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-17T22:35:05.763Z","etag":null,"topics":["apple-macbook","cheatsheet","macbook","touchbar","xcode"],"latest_commit_sha":null,"homepage":"http://loretoparisi.com/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loretoparisi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-10-28T09:54:05.000Z","updated_at":"2024-08-22T17:52:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd5c496a-80d7-43f6-a9b7-c09518952687","html_url":"https://github.com/loretoparisi/touchbar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loretoparisi%2Ftouchbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loretoparisi%2Ftouchbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loretoparisi%2Ftouchbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loretoparisi%2Ftouchbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loretoparisi","download_url":"https://codeload.github.com/loretoparisi/touchbar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253638879,"owners_count":21940433,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-macbook","cheatsheet","macbook","touchbar","xcode"],"created_at":"2024-08-03T19:01:02.860Z","updated_at":"2025-05-11T21:31:26.399Z","avatar_url":"https://github.com/loretoparisi.png","language":null,"funding_links":[],"categories":["Table of Contents:","Others"],"sub_categories":["Demos:"],"readme":"# touchbar\nApple MacBook Pro TouchBar (NSTouchBar) Cheat Sheet\n\n## How to enable the TouchBar simulator\nTo 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\n\n```\n$ sw_vers\nProductName:\tMac OS X\nProductVersion:\t10.12.1\nBuildVersion:\t16B265\n```\n\nIf 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\n\nAssumed you did the previous steps, open Xcode and the Window menu should look like\n\n![schermata 2016-10-31 alle 19 56 51](https://cloud.githubusercontent.com/assets/163333/19867500/5888c9ce-9fa4-11e6-9ad9-b490e8863341.jpg)\n\nso you should see the `Show Touch Bar` option just after the Organizer option.\n\n## The TouchBar Cheat Sheet\n![touchbar_layout_cheatsheet](https://cloud.githubusercontent.com/assets/163333/19802765/82767df4-9d05-11e6-8a21-71359fac1afb.png)\n\n## Launch the Touch Bar simulator programmatically\nThe [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.\n\n## Touch Bar integrations\n- [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.\n- [Electron](https://github.com/electron/electron/issues/7781), Support MacBook Touch Bar API\n- [NW.js aka NodeWebKit](https://github.com/nwjs/nw.js/issues/5501)\n\n## References\n- [About the TouchBar]( https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/AbouttheTouchBar.html)\n- [Visual Design](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/VisualDesign.html#//apple_ref/doc/uid/20000957-CH106-SW1) \n- [Interaction and Gestures](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/Interaction.html#//apple_ref/doc/uid/20000957-CH105-SW1)\n- [TouchBar Icons](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/Icons.html#//apple_ref/doc/uid/20000957-CH107-SW1)\n- [TouchBar Controls](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/ControlsandViews.html#//apple_ref/doc/uid/20000957-CH108-SW1)\n\n## NSTouchbar class\nThe [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.\n\nThe `NSTouchbar` Class Diagram\n\u003cimg width=\"922\" alt=\"touchbarclass\" src=\"https://cloud.githubusercontent.com/assets/163333/20582611/e61952ea-b1e2-11e6-87fa-3e04fd56e9f7.png\"\u003e\n\n## Touchbar Examples API\n- [NSTouchBar Catalog](https://github.com/loretoparisi/touchbar/tree/master/examples/NSTouchBarCatalogCreatingandCustomizingNSTouchBar), Creating and Customizing NSTouchBar\n- [ToolbarSample](https://github.com/loretoparisi/touchbar/tree/master/examples/ToolbarSampleUsingNSToolbartoconstructawindowtoolbar), ToolbarSample: Using NSToolbar to construct a window toolbar\n\n## Touchbar Tools\n- [TouchBarScreenshotter](https://github.com/steventroughtonsmith/TouchBarScreenshotter), easily snap screenshots of the currently presented Touch Bar in macOS\n- [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.\n\n## Touchbar Example Apps\n- [KnightTouchBar2000](https://github.com/AkdM/KnightTouchBar2000), KITT 2000 chaser animation for your MacBook Pro TouchBar.\n- [TouchFart](https://github.com/hungtruong/TouchFart), A fart app for the new Macbook Pro's Touch Bar\n- [Touchbar Nyancat](https://github.com/avatsaev/touchbar_nyancat), nyancat animation on your +$2k MacBook Pro's Touchbar\n\n## Touchbar Games (!)\n- [Touch Bar Space Fight](https://github.com/insidegui/TouchBarSpaceFight)\n\n## Touchbar Tutorials\n- [How to Use NSTouchBar on macOS](https://www.raywenderlich.com/147118/use-nstouchbar-macos)\n- [NSTouchBar 开发教程 (Development Tutorial, Chinese, Ed.)](http://www.macdev.io/tutorial/NSTouchBar.html)\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floretoparisi%2Ftouchbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floretoparisi%2Ftouchbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floretoparisi%2Ftouchbar/lists"}