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: about 18 hours 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.