Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/technosophos/glowbear
add custom Touch Bar buttons on macOS MacBook Pro
https://github.com/technosophos/glowbear
applescript macbook-pro macos nodejs touchbar touchbar-support typescript
Last synced: 2 months ago
JSON representation
add custom Touch Bar buttons on macOS MacBook Pro
- Host: GitHub
- URL: https://github.com/technosophos/glowbear
- Owner: technosophos
- License: other
- Created: 2017-08-29T04:12:13.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-01-23T16:05:33.000Z (almost 7 years ago)
- Last Synced: 2023-10-20T23:21:24.051Z (about 1 year ago)
- Topics: applescript, macbook-pro, macos, nodejs, touchbar, touchbar-support, typescript
- Language: TypeScript
- Size: 79.1 KB
- Stars: 39
- Watchers: 6
- Forks: 3
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# GlowBear: The TouchBar Customization Tool for your MacBook Pro
This is a tool for creating custom buttons to go on your MacBook Pro's touch bar
(that glowy bar that hijacked the F-key row). It also supplies hotkey support
so that you can map both a Touch Bar button and a hotkey.
## Prerequisites
- `node`
- `yarn` or `npm`
## Usage
Build it the first time with `npm install && npm build` or `yarn install && yarn build`
Create/edit your `~/.config/glowbear/glowbear.yaml` file to contain the buttons and commands you want to run.
Run with `npm start` or `yarn start`.
To raise the app, press `CMD-SHIFT-.`. At that point, the buttons will be visible
on the button bar, and the accelerator keys will be active.
## glowbear.yaml Format
The glowbear.yaml format contains a list of commands, with each command being
represented as a button on the Touch Bar.
```yaml
commands:
- name: "Web"
color: "#b00707"
accelerator: "a"
applescript: |-
tell application "Vivaldi"
activate
set visible of first window whose visible is true to true
end tell
```
Commands have the following properties:
- `name`: Text to display on the button.
- `color`: A CSS-formatted color for the button.
- `accelerator`: A hotkey (optional).
- `applescript`: The script to execute when the button is clicked or the
acclerator is executed.
Check out the [examples](examples/glowbear.yaml) directory for more examples.
## LICENSE
This project is licensed under the MIT license. See LICENSE.txt for more.
Images in this package are licensed under CC-0 from https://openclipart.org.
## Contributing
Feel free to open pull requests on this project. The main goal of the project
was to make a tool for my own personal use. So I don't actively develop on this
unless I get an idea.