Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/pock/pock

Widgets manager for MacBook Touch Bar
https://github.com/pock/pock

control-strip display-macos-dock dock macbook-pro macos touchbar widgets

Last synced: 26 days ago
JSON representation

Widgets manager for MacBook Touch Bar

Awesome Lists containing this project

README

        


Widgets manager for MacBook's Touch Bar


Pock is a free, open-source tool that gives you quick access to your favorite controls and services while maximizing your on-screen real estate






Download
|
GitHub
|
ProductHunt
|
Permissions
|
Changelog

## Thank you!

If you want to support this project, you can [click here](https://paypal.me/pigigaldi)!
Pock will always be available as free software!

## How to install

1. Go to the [official website](https://pock.app) and click download.
2. Unzip the archive by double-clicking on the file or running `unzip`
3. Move the extracted file to `/Applications`

## Usage

1. Open Pock.

2. Check the menu bar for the newly added Pock icon. You can access Pock and widgets preferences from this menu item.

_(If you don't see Pock in your Touch Bar, go to the `Keyboard` pane in System Preferences and select "Touch Bar shows App Controls", then relaunch Pock)_

## Permissions

To have a flawless experience, please click [here](https://pock.app/docs/catalina) and read all the suggestions carefully.

Pock sends some _anonymous events_ over _AppCenter_ to speed up issues/bugs-catching. If you don't agree with this, then please, don't download it.
_These events will never be used for marketing purposes since it's not a commercial package_.

## How to uninstall

1. Quit Pock.

2. Move Pock app file from`/Applications` to Trash.

_(If you don't see the default system controls in your Touch Bar, go to the `Keyboard` preference pane in System Preferences and select "Touch Bar shows App Controls" or configure the system settings based on your needs)_

## Widgets

Includes five default widgets

##### Dock widget

Your macOS Dock inside your MacBook's TouchBar, the core widget.
It comes with fully-functional badge support, so you will not miss any notification.
More features can be configured in widget settings along with other preferences.
It now includes multi-window support!
*Enjoy your screen in full-size every time!*






##### Now Playing widget

Media information at a glance with gestures for media controls included.

| Gesture | Action |
| ----------- | :---------------- |
| tap | toggle play/pause |
| swipe left | previous song |
| swipe right | next song |



##### ESC widget

A handy ESC button is there, just in case, so you don't have to hide Pock to access the system one.



##### Status widget

Always keep an eye on system information, like what time it is, or maybe WiFi status or Battery status. Configure Status items from settings.



##### Control Center widget

Change screen brightness or system volume with easy controls.
Long press or slide on control center item to invoke sliders.



##### Weather widget

Stay updated with the latest weather forecast for your location, displayed directly into your Touch Bar.



##### More...

More widgets are coming!
Keep search for #pock on social media to be updated on future widgets releases!



## Preferences

You can adjust Pock and widgets settings to reflects your specific needs. You can access these panes from the **Preferences…** and **Manage Widgets…** menu items.





## Customize

You can customize the position of the widgets in the Touch Bar from the **Customize Pock…** menu item.



## Developers

Do you want to build a custom widget for **Pock**? Consult [**PockKit**](https://pock.app/docs) documentation to know-how!



## Contributions

Please look at the [Contributing](https://github.com/pock/pock/blob/master/CONTRIBUTING.md) file to know the guidelines needed to submit an issue or a pull request.

## Dependencies

* [TinyConstraints](https://github.com/roberthein/TinyConstraints)
* [Magnet](https://github.com/Clipy)
* [Zip](https://github.com/marmelroy/Zip)

## Special mentions

* [BrokenSt0rm](https://twitter.com/BrokenSt0rm) - Thanks for [openweather-proxy-rs](https://github.com/BrokenSt0rm/openweather-proxy-rs).
* [sveinbjornt](https://github.com/sveinbjornt/) - Thanks for [STPrivilegedTask](https://github.com/sveinbjornt/STPrivilegedTask).
* [boyvanamstel](https://gist.github.com/boyvanamstel/1409312) - Great sample of an _Objective-C_ class to loop through startup items.
* [Minebomber](https://stackoverflow.com/a/36115210) - Beautiful idea on how to retrieve additional information from Dock icons.

## Translated READMEs

🇺🇸 [English](README.md)
🇨🇳 [中文](.github/readmes/README.cn.md)
🇯🇵 [日本語](.github/readmes/README.ja.md)
🇹🇷 [Türkçe](.github/readmes/README.tr.md)

* Some translations may be different or incomplete.

## License

Under MIT license. See [LICENSE](LICENSE) file for further information.