gazectl 0.4.1 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +26 -15
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,34 +1,49 @@
1
- # gazectl
1
+ <div align="center">
2
+ <pre> ██████╗ █████╗ ███████╗███████╗ ██████╗████████╗██╗
3
+ ██╔════╝ ██╔══██╗╚══███╔╝██╔════╝██╔════╝╚══██╔══╝██║
4
+ ██║ ███╗███████║ ███╔╝ █████╗ ██║ ██║ ██║
5
+ ██║ ██║██╔══██║ ███╔╝ ██╔══╝ ██║ ██║ ██║
6
+ ╚██████╔╝██║ ██║███████╗███████╗╚██████╗ ██║ ███████╗
7
+ ╚═════╝ ╚═╝ ╚═╝╚══════╝╚══════╝ ╚═════╝ ╚═╝ ╚══════╝
8
+ </pre>
2
9
 
3
- Head tracking display focus switcher for macOS + [Aerospace](https://github.com/nikitabobko/AerospaceWM).
10
+ **Head tracking display switcher for macOS**
4
11
 
5
- Uses your webcam and Apple's Vision framework to detect which way your head is turned, then switches Aerospace monitor focus automatically.
12
+ <br />
13
+
14
+ <img src="assets/demo.png" width="500" />
15
+
16
+ </div>
17
+
18
+ ---
19
+
20
+ `gazectl` uses your webcam to detect which monitor you're looking at and automatically switches focus to it. It uses Apple's Vision framework for real-time face tracking and works with the [Aerospace](https://github.com/nikitabobko/AerospaceWM) tiling window manager.
21
+
22
+ > macOS only. Requires macOS 14+ and [Aerospace](https://github.com/nikitabobko/AerospaceWM).
6
23
 
7
24
  ## Install
8
25
 
9
26
  ```bash
10
- npm i -g gazectl
27
+ npx gazectl@latest
11
28
  ```
12
29
 
13
- Or run directly:
30
+ Or install globally:
14
31
 
15
32
  ```bash
16
- npx gazectl
33
+ npm i -g gazectl
17
34
  ```
18
35
 
19
- Requires macOS 14+ and [Aerospace](https://github.com/nikitabobko/AerospaceWM).
20
-
21
36
  ## Usage
22
37
 
23
38
  ```bash
24
39
  # First run — calibrates automatically
25
40
  gazectl
26
41
 
27
- # With verbose logging
28
- gazectl --verbose
29
-
30
42
  # Force recalibration
31
43
  gazectl --calibrate
44
+
45
+ # With verbose logging
46
+ gazectl --verbose
32
47
  ```
33
48
 
34
49
  On first run, gazectl asks you to look at each monitor and press Enter. It samples your head angle for 2 seconds per monitor, then saves calibration to `~/.local/share/gazectl/calibration.json`.
@@ -54,7 +69,3 @@ On first run, gazectl asks you to look at each monitor and press Enter. It sampl
54
69
  swift build -c release
55
70
  cp .build/release/gazectl /usr/local/bin/gazectl
56
71
  ```
57
-
58
- ## License
59
-
60
- MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gazectl",
3
- "version": "0.4.1",
3
+ "version": "0.4.2",
4
4
  "description": "Head tracking display focus switcher for macOS + Aerospace",
5
5
  "bin": {
6
6
  "gazectl": "bin/gazectl"