{"id":13634432,"url":"https://github.com/touchbar/Touch-Bar-Preview","last_synced_at":"2025-04-18T14:34:25.093Z","repository":{"id":50662261,"uuid":"77914176","full_name":"touchbar/Touch-Bar-Preview","owner":"touchbar","description":":computer: Touch Bar Preview is a small app to display your designs on the MacBook Pro’s Touch Bar.","archived":false,"fork":false,"pushed_at":"2019-07-08T17:32:18.000Z","size":2018,"stargazers_count":81,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-01T23:33:36.925Z","etag":null,"topics":["application","design","design-tools","free-software","macbook","macos","touchbar"],"latest_commit_sha":null,"homepage":"https://touchbar.github.io","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/touchbar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-01-03T12:13:50.000Z","updated_at":"2024-06-28T11:09:15.000Z","dependencies_parsed_at":"2022-09-02T06:21:20.852Z","dependency_job_id":null,"html_url":"https://github.com/touchbar/Touch-Bar-Preview","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchbar%2FTouch-Bar-Preview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchbar%2FTouch-Bar-Preview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchbar%2FTouch-Bar-Preview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/touchbar%2FTouch-Bar-Preview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/touchbar","download_url":"https://codeload.github.com/touchbar/Touch-Bar-Preview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223782781,"owners_count":17201849,"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":["application","design","design-tools","free-software","macbook","macos","touchbar"],"created_at":"2024-08-01T23:01:04.757Z","updated_at":"2024-11-09T03:30:58.430Z","avatar_url":"https://github.com/touchbar.png","language":"Swift","readme":"# Touch Bar Preview for macOS\n[![latest release](https://img.shields.io/github/release/touchbar/Touch-Bar-Preview.svg)](https://github.com/touchbar/Touch-Bar-Preview/releases/latest) [![license](https://img.shields.io/github/license/touchbar/Touch-Bar-Preview.svg)](https://github.com/touchbar/Touch-Bar-Preview/blob/master/LICENSE) [![Total downloads](https://img.shields.io/github/downloads/touchbar/Touch-Bar-Preview/total.svg)](https://github.com/touchbar/Touch-Bar-Preview/releases/latest) ![minimal system requirements](https://img.shields.io/badge/required-macOS%2010.12.2-blue.svg) [![donate](https://img.shields.io/badge/donate-buy%20me%20a%20coffee-yellow.svg)](https://www.paypal.me/alexkaessner)\n\n\u003cimg height=256 alt=\"app icon\" src=\"Touch Bar Preview/Touch Bar Preview/Assets.xcassets/AppIcon.appiconset/App-Icon-256@2x.png\"\u003e\n\nA small open source app to display your designs on the Touch Bar of the new MacBook Pro.\n\n## Install\n\n[Download](https://github.com/touchbar/Touch-Bar-Preview/releases/latest), unzip, and drag the app to Applications folder. Touch Bar Preview requires macOS 10.12.2 or higher.\n\n## Instructions\n**To use Touch Bar Preview just drag and drop a image file (PNG, JPEG) into the app.**\nThe image should be 2170px wide and 60px high. Since the Touch Bar is a high-resolution Retina display, this is equivalent to 1085pt by 30pt.\n\nThe app automatically overlaps the System button (esc) and Control Strip on top of your design. So you don't have to exclude them in your design! Your design will get the required offset to be perfectly aligned.\nIf your image is bigger or smaller than the required size, the image is currently stretched to fit into the app region.\n\n### Why is it not possible to hide the ESC and System Buttons on the right side?\nAs Apple states in the [developer documentation](https://developer.apple.com/documentation/appkit/nstouchbar) of the Touch Bar:\n\u003eOn the right side of the Touch Bar, the system supplies the always-available *Control Strip*. The Control Strip gives the user access to standard controls for display brightness, sound volume, Siri, and so on. Your app’s bars appear to the left of the Control Strip. The user can choose to hide the Control Strip, which gives the frontmost app the entire Touch Bar width.\n\nRead more about the Touch Bar in the [Apple HIG](https://developer.apple.com/library/content/documentation/UserExperience/Conceptual/OSXHIGuidelines/AbouttheTouchBar.html#//apple_ref/doc/uid/20000957-CH104-SW1).\n\n## Touch Bar UI Kit\nIf you're searching for a Touch Bar UI Kit, take a look at my [macOS UI Kit](https://github.com/alexkaessner/macOS-UI-Kit) Bundle.\n\nYou can also find the download link in the app.\n\n## Contributing\nFeel free to create pull requests if you want to support the app!\n\nIf you have any feature request or found a bug, please create a new [issue](https://github.com/touchbar/Touch-Bar-Preview/issues).\n","funding_links":["https://www.paypal.me/alexkaessner"],"categories":["Applications","Touch Bar"],"sub_categories":["Touch Bar","Development","Text","📦 Touch Bar (6)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouchbar%2FTouch-Bar-Preview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftouchbar%2FTouch-Bar-Preview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftouchbar%2FTouch-Bar-Preview/lists"}