# Pock

**Repository Path**: mirrors/Pock

## Basic Information

- **Project Name**: Pock
- **Description**: Pock 是一款 macOS App，你可以通过它把 Touch Bar 变成系统中的 Dock 栏，直接用来切换和启动 App，尽享全屏幕体验
- **Primary Language**: Swift
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://www.oschina.net/p/pock
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 2
- **Created**: 2019-04-02
- **Last Updated**: 2025-09-20

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

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.
     
     <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 five 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](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)

<small>* Some translations may be different or incomplete</small>.



## License

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