Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 24 additions & 6 deletions .gitignore
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,10 +1,28 @@
## .DS_Store
# macOS
.DS_Store
.AppleDouble
.LSOverride

## No Pods folder
# Xcode
xcuserdata/
*.xcuserstate
*.xcscmblueprint
DerivedData/
*.pbxuser
*.mode1v3
*.mode2v3
*.perspectivev3

# Build output
build/
*.pock

# Swift Package Manager
.build/
.swiftpm/

# CocoaPods (not used — project uses SPM)
Podfile
Podfile.lock
Pods/

## Userdata
Status.xcodeproj/xcuserdata/
Status.xcworkspace/xcuserdata/
*.xcworkspace
16 changes: 0 additions & 16 deletions Podfile

This file was deleted.

85 changes: 81 additions & 4 deletions README.md
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,6 +1,83 @@
# Status Widget
Always keep an eye on system information, like what time is it, or maybe WiFi status or Battery status. Configure Status items visibility from settings.
# **Status V2** — Pock Widget · Touch Bar GIF + Status Bar

# Preview
<img src="https://pock.app/_nuxt/img/pock_status_widget.33efaa7.png" height="60">
![Touch Bar Preview](images/TouchBar-Preview-PockStatusV2Widget.gif)

> ### **GIF Supporting**
> Display an animated GIF directly on your MacBook Touch Bar — alongside clock, WiFi, battery, and input source.

A [Pock](https://pock.app) widget that lets you **show any animated GIF on your Touch Bar**. Load it from a local file or a URL, control the size and scaling, and preview it live — all from the widget preferences. Perfect if you want to add a custom animation, a meme, a logo, or any GIF to your Touch Bar.

---

## Features

- **Animated GIF on Touch Bar** — display any `.gif` from a file or URL on the right edge of your Touch Bar
- **Width control** — resize the GIF from 30 to 300 pt
- **Scaling modes** — Fit, Fill (crop), or Stretch
- **Live preview** — see your GIF at real Touch Bar height before applying
- **Clock** — customizable date & time format
- **WiFi** — signal strength indicator
- **Battery** — icon and/or percentage
- **Input Source** — current keyboard language

---

## Requirements

- MacBook with Touch Bar
- macOS 10.15 or later
- [Pock](https://pock.app) installed

---

## Installation

1. Download the latest `.pock` file from [Releases](../../releases/tag/v1.0.0)
2. Double-click it — Pock will install it automatically
3. Open Pock → Widgets Manager and enable **Status V2**
4. Open preferences → enable **Show GIF** → paste a URL or choose a file

---

## Building from Source

No CocoaPods required. The project uses **Swift Package Manager**.

1. Clone the repo
2. Open `Status.xcodeproj` in Xcode
3. Xcode will automatically resolve the SPM dependencies ([PockKit](https://github.com/pock/pockkit), [TinyConstraints](https://github.com/roberthein/TinyConstraints))
4. Build (`⌘B`) — the `.pock` bundle appears in the Products group
5. Double-click the built `.pock` to install

---

## Preferences

![Settings](images/Settings.png)

Open **Pock → Widgets Manager → Status V2** to configure:

| Setting | Description |
|---|---|
| Language / Input Source | Toggle the input source indicator |
| WiFi Signal | Toggle the WiFi signal icon |
| Battery | Toggle battery display; choose icon and/or percentage |
| Date & Time | Toggle the clock; set a custom date/time format |
| **Show GIF** | Enable animated GIF on the right edge of the Touch Bar |
| Source | Load GIF from a local **file** or a **URL** |
| Width | Set the GIF display width (30–300 pt) |
| Scaling | Fit / Fill (crop) / Stretch |
| Preview | Live preview of your GIF at Touch Bar height |

---

## Keywords

`touch bar gif` · `touchbar gif` · `add gif to touch bar` · `pock widget gif` · `macbook touch bar animation` · `custom touch bar` · `touch bar customization` · `pock gif widget` · `animated touch bar` · `touch bar status widget`

---

## Credits

Based on the original [status-widget](https://github.com/pock/status-widget) by [Pierluigi Galdi](https://github.com/pigigaldi).
GIF integration and Status V2 by [EvyatarEshkar](https://github.com/EvyatarEshkar).
Loading