{"id":13528812,"url":"https://github.com/rodrigobdz/fish-apple-touchbar","last_synced_at":"2025-07-29T19:33:09.126Z","repository":{"id":48904195,"uuid":"159330302","full_name":"rodrigobdz/fish-apple-touchbar","owner":"rodrigobdz","description":"⚡️ Supercharge your touchbar with fish 🐠","archived":false,"fork":false,"pushed_at":"2022-04-29T15:56:25.000Z","size":9859,"stargazers_count":91,"open_issues_count":0,"forks_count":7,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-11-02T15:36:26.617Z","etag":null,"topics":["awesome-fish-shell","awesome-plugin","fish-shell","fisher","iterm2","macbook-pro","touchbar","touchbar-support","zsh-apple-touchbar"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/rodrigobdz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-11-27T12:13:56.000Z","updated_at":"2024-08-10T17:38:35.000Z","dependencies_parsed_at":"2022-09-23T23:33:50.033Z","dependency_job_id":null,"html_url":"https://github.com/rodrigobdz/fish-apple-touchbar","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/rodrigobdz%2Ffish-apple-touchbar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigobdz%2Ffish-apple-touchbar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigobdz%2Ffish-apple-touchbar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rodrigobdz%2Ffish-apple-touchbar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rodrigobdz","download_url":"https://codeload.github.com/rodrigobdz/fish-apple-touchbar/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228041240,"owners_count":17860221,"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":["awesome-fish-shell","awesome-plugin","fish-shell","fisher","iterm2","macbook-pro","touchbar","touchbar-support","zsh-apple-touchbar"],"created_at":"2024-08-01T07:00:25.218Z","updated_at":"2024-12-04T04:09:35.013Z","avatar_url":"https://github.com/rodrigobdz.png","language":"Shell","funding_links":[],"categories":["Plugins","Table of Contents:"],"sub_categories":["other plugin","Developer:"],"readme":"# fish-apple-touchbar [![Mentioned in Awesome fish-shell](https://awesome.re/mentioned-badge.svg)](https://github.com/jorgebucaran/awesome-fish#utilities)\n\n\u003e Supercharge your touchbar with fish\n\n## Requirements\n\n- [fish](https://github.com/fish-shell/fish-shell)\n- [iTerm2](https://iterm2.com)\n- MacBook Pro with [Touch Bar](https://developer.apple.com/macos/touch-bar)\n\n## Installation\n\n1. Set up iTerm2\n\n   Go to **View \u003e Customize Touch Bar** and drag the **Function Keys** (F1) item to your touchbar.\n\n   Your touch bar should now look like this:\n\n   ![function keys touchbar](./assets/iterm2-touchbar-function-module.png)\n\n1. Install with [Fisher](https://github.com/jorgebucaran/fisher)\n\n   ```console\n   fisher install rodrigobdz/fish-apple-touchbar\n   ```\n\n1. Open a new terminal session to activate the package\n\n## Usage\n\nIt currently shows three default views from [zsh-apple-touchbar](https://github.com/zsh-users/zsh-apple-touchbar) which are configurable in `fish-apple-touchbar.fish`.\n\n![fish-apple-touchbar preview](./assets/preview.gif)\n\nPreview made with [Touch Bar Simulator](https://github.com/sindresorhus/touch-bar-simulator) and [Gifski](https://github.com/sindresorhus/gifski-app).\n\n## Related\n\n### Projects\n\n- [zsh-users/zsh-apple-touchbar](https://github.com/zsh-users/zsh-apple-touchbar): **fish-apple-touchbar** is based on zsh-apple-touchbar and was ported to work with fish. For more information, please read [zsh-apple-touchbar/issues/2](https://github.com/zsh-users/zsh-apple-touchbar/issues/2).\n- [derekstavis/touchrunner](https://github.com/derekstavis/touchrunner): Offers some extended functionality. Keybinding commands to configure the Touchbar were useful for the creation of **fish-apple-touchbar**.\n\n### Dev Documentation\n\n- [Proprietary Escape Codes - iterm2](https://iterm2.com/documentation-escape-codes.html)\n- [Touch Bar - iterm2](https://iterm2.com/documentation-touch-bar.html)\n- [Control Characters and Escape Sequences - Terminal Guide](https://terminalguide.namepad.de/seq/osc-1337-setkeylabel/)\n- [`commandline` - fish](https://fishshell.com/docs/current/cmds/commandline.html)\n- [`bind` - fish](https://fishshell.com/docs/current/cmds/bind.html)\n\n## License\n\n[MIT](LICENSE) © [rodrigobdz](https://rodrigobdz.github.io/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodrigobdz%2Ffish-apple-touchbar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frodrigobdz%2Ffish-apple-touchbar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frodrigobdz%2Ffish-apple-touchbar/lists"}