# pock

**Repository Path**: rexiyz/pock

## Basic Information

- **Project Name**: pock
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-01
- **Last Updated**: 2025-01-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


<p align="center"><img src="https://pock.app/_nuxt/img/pock-icon-big-sur.53a4c62.png" width="96"/></p>
<p align="center"><b>Widgets manager for MacBook's Touch Bar</b></p>
<p align="center">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</p>

<p align="center">
<img width="800" src="https://pock.app/_nuxt/img/pock_widgets.5cf5510.png"/>
</p>

<p align="center">
<a href="https://pock.app/download?file=pock_0_9_0__22.zip">Download</a> | <a href="https://github.com/pock/pock">GitHub</a> | <a href="https://www.producthunt.com/posts/pock">ProductHunt</a> | <a href="https://pock.app/docs/catalina">Permissions</a> | <a href="https://github.com/pock/pock/releases/tag/0.9.0-22">Changelog</a>
</p>


## 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.

<small>_(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)_</small>


## Permissions

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


## How to uninstall

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

<small>_(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)_</small>


## Widgets

<small>Includes 6 default widgets</small>

##### 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!_*
<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_dock_widget.6c84647.png"/>
</div>
<div align="left" style="margin-top:6px">
<img width="500" src="https://pock.app/_nuxt/img/pock_app_expose.122ed53.png"/>
</div>

##### 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 |

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_now_playing_widget.fb1e8cf.png"/>
</div>

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

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_esc_widget.03f476d.png"/>
</div>

##### 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.

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_status_widget.33efaa7.png"/>
</div>

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

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_control_center_widget.3ab93ea.png"/>
</div>

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

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_weather_widget.584df8f.png"/>
</div>

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

<div align="left">
<img width="500" src="https://pock.app/_nuxt/img/pock_more_widget.b8c7aa2.png"/>
</div>


## 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.

<div display="float">
<img width="262" src="https://pock.app/_nuxt/img/preference_general.f5f55b1.png"/>
<img width="262" src="https://pock.app/_nuxt/img/preference_nowplaying_widget.4cfa367.png"/>
<img width="262" src="https://pock.app/_nuxt/img/preference_dock_widget.b2bb413.png"/>
</div>


## Customize

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

<div align="left">
<img src="https://pock.app/_nuxt/img/pock_customize.25172d4.png"/>
</div>


## Developers

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

<div align="center">
<img width="260" src="https://pock.app/_nuxt/img/xcode12_plus_pockkit.68788ac.png"/>
</div>


## Contributions

Please look at the [Contributing](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)

<small>* _Some translations may be different or incomplete_</small>_.


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