Add hybrid cell style and icon strip to icons mode

Author: jsheffie

Makefile

@@ -68,6 +68,7 @@ config:
 		echo "GRID_ROWS=2" >> ~/.config/spacemap/config; \
 		echo "#CELL_STYLE=rects" >> ~/.config/spacemap/config; \
 		echo "CELL_STYLE=icons" >> ~/.config/spacemap/config; \
+		echo "#CELL_STYLE=hybrid" >> ~/.config/spacemap/config; \
 		echo "Created ~/.config/spacemap/config with defaults (8x2, icons)"; \
 	else \
 		echo "Config already exists at ~/.config/spacemap/config"; \
@@ -80,5 +81,6 @@ distconfig:
 	@echo "GRID_ROWS=2" >> ~/.config/spacemap/config
 	@echo "#CELL_STYLE=rects" >> ~/.config/spacemap/config
 	@echo "CELL_STYLE=icons" >> ~/.config/spacemap/config
+	@echo "#CELL_STYLE=hybrid" >> ~/.config/spacemap/config
 	@echo "Wrote ~/.config/spacemap/config"
 	@cat ~/.config/spacemap/config

README.md

@@ -4,18 +4,19 @@ A native macOS work`spacemap` that shows your yabai workspace grid on demand. Pr
 
 You do not have to disable System Integrity Protection to get this setup.
 
-Example Configuration: 
-```
-┌────┬────┬────┬────┬────┬────┬────┬────┐
-│ 1  │ 2  │ 3  │ 4  │ 5  │ 6  │ 7  │ 8  │  ← top row
-├────┼────┼────┼────┼────┼────┼────┼────┤
-│ 9  │ 10 │ 11 │ 12 │ 13 │ 14 │ 15 │ 16 │  ← bottom row
-└────┴────┴────┴────┴────┴────┴────┴────┘
-         ↑ active desktop highlighted in blue
-```
 ## Visualization
+Here I have 4 window open and spacemap is open `ctrl spacebar`
+Tou can see that we are on desktop 6 and there are 4 apps open.
+<img width="1793" height="943" alt="Screenshot 2026-05-11 at 1 50 18 PM" src="https://github.com/user-attachments/assets/b9f2dafc-d309-4c80-98be-8d0e1f19cc17" />
 
-<img width="751" height="172" alt="Screenshot 2026-05-10 at 10 14 35 AM" src="https://github.com/user-attachments/assets/f7f2556a-9a1e-450e-bae4-2ad4268767cf" />
+## Configuration Examples
+
+| spacemap screenshot | spacemap config | skhd config |
+|---------------------|-----------------|-------------|
+| <img width="711" height="136" alt="Screenshot 2026-05-11 at 1 20 00 PM" src="https://github.com/user-attachments/assets/bd9958db-07ee-466b-934c-e12d28ebd0a3" /> | <img width="195" height="75" alt="Screenshot 2026-05-11 at 1 42 02 PM" src="https://github.com/user-attachments/assets/4d493154-e1b2-4772-a408-639da7e3abe1" /> | - |
+| <img width="713" height="137" alt="Screenshot 2026-05-11 at 1 19 31 PM" src="https://github.com/user-attachments/assets/d298e386-6bc2-4ac3-8ba0-7184e2f072a5" /> | <img width="204" height="76" alt="Screenshot 2026-05-11 at 1 41 03 PM" src="https://github.com/user-attachments/assets/1a911ef2-5cb7-4746-87d1-92dddb9ec8b4" /> | - |
+| <img width="714" height="139" alt="Screenshot 2026-05-11 at 1 40 41 PM" src="https://github.com/user-attachments/assets/a4595e8b-2494-4d3b-b8cc-fcc41a4daf61" /> | <img width="199" height="76" alt="Screenshot 2026-05-11 at 1 42 45 PM" src="https://github.com/user-attachments/assets/522bc241-8d8a-4221-aad1-cc6e2e20a500" /> | - |
+| <img width="364" height="247" alt="Screenshot 2026-05-11 at 1 18 47 PM" src="https://github.com/user-attachments/assets/2eddfbc2-74a9-41dd-9d9a-cdba4f537232" /> | <img width="204" height="77" alt="Screenshot 2026-05-11 at 1 44 32 PM" src="https://github.com/user-attachments/assets/883414bb-b983-47e4-99bf-f46dd5484005" /> | - |
 
 
 Window positions are drawn as colored rectangles inside each cell (one color per app, derived from app name). The active cell updates instantly as you switch desktops, driven by yabai's `space_changed` signal.
@@ -24,8 +25,9 @@ Window positions are drawn as colored rectangles inside each cell (one color per
 
 - macOS 13+
 - [yabai](https://github.com/koekeishiya/yabai) installed at `/opt/homebrew/bin/yabai` and running
+- [skhd](https://github.com/asmvik/skhd) installed at `/opt/homebrew/bin/skhd` and running
 - Xcode Command Line Tools (`xcode-select --install`)
-- Accessibility permission (prompted on first launch)
+- Accessibility permission (prompted on first launch). This is not the same as disabling SIP protection, which is not required.
 <img width="722" height="844" alt="Screenshot 2026-05-10 at 10 58 32 AM" src="https://github.com/user-attachments/assets/b6d90393-2100-44bc-ac6f-00fe1de66a98" />
 
 
@@ -59,21 +61,15 @@ Change these to match your yabai space layout. A 4×4 grid would be `GRID_COLS=4
 | Value | Description |
 |-------|-------------|
 | `rects` | Colored rectangles scaled from real window geometry (default) |
-| `icons` | App icons positioned at each window's scaled location |
+| `icons` | App icons at each visible window's scaled position; all apps on the workspace shown as a small icon strip at the bottom |
+| `hybrid` | Colored rectangles (like `rects`) plus a small icon strip at the bottom showing all apps on the workspace |
 
 ```bash
 CELL_STYLE=rects   # default
 CELL_STYLE=icons
+CELL_STYLE=hybrid
 ```
 
-**`CELL_STYLE=rects`**
-
-<img width="752" height="476" alt="rects style" src="https://github.com/user-attachments/assets/1ee3e85c-12e4-4f34-a265-cb9f9fd69b56" />
-
-**`CELL_STYLE=icons`**
-
-<img width="718" height="464" alt="icons style" src="https://github.com/user-attachments/assets/5d35aa23-d5ef-4da1-8a74-df7278b43112" />
-
 Run `make distconfig` to write a fresh config with `icons` active and `rects` commented out.
 
 ## Usage

Sources/spacemap/CellView.swift

@@ -18,11 +18,16 @@ struct CellView: View {
 
             ForEach(windows, id: \.id) { window in
                 switch cellStyle {
-                case .rects: windowRect(window)
-                case .icons: windowIcon(window)
+                case .rects:  windowRect(window)
+                case .icons:  windowIcon(window)
+                case .hybrid: windowRect(window)
                 }
             }
 
+            if cellStyle == .icons || cellStyle == .hybrid {
+                iconStrip()
+            }
+
             Text("\(spaceIndex)")
                 .font(.system(size: 10, weight: .medium, design: .monospaced))
                 .foregroundColor(isFocused ? Color(hex: 0x4a9eff) : .white.opacity(0.4))
@@ -53,23 +58,49 @@ struct CellView: View {
 
     @ViewBuilder
     private func windowIcon(_ window: YabaiWindow) -> some View {
-        let scaleX = cellSize.width / displayBounds.width
-        let scaleY = cellSize.height / displayBounds.height
-        let x = (window.cgFrame.minX - displayBounds.minX) * scaleX
-        let y = (window.cgFrame.minY - displayBounds.minY) * scaleY
-        let w = max(window.cgFrame.width * scaleX, 14)
-        let h = max(window.cgFrame.height * scaleY, 14)
-        let iconSize = min(w, h)
+        if !window.isHidden && !window.isMinimized {
+            let scaleX = cellSize.width / displayBounds.width
+            let scaleY = cellSize.height / displayBounds.height
+            let x = (window.cgFrame.minX - displayBounds.minX) * scaleX
+            let y = (window.cgFrame.minY - displayBounds.minY) * scaleY
+            let w = max(window.cgFrame.width * scaleX, 14)
+            let h = max(window.cgFrame.height * scaleY, 14)
+            let iconSize = min(w, h)
 
-        if let icon = appIcon(for: window.app) {
-            Image(nsImage: icon)
-                .resizable()
-                .aspectRatio(contentMode: .fit)
-                .frame(width: iconSize, height: iconSize)
-                .offset(x: x, y: y)
+            if let icon = appIcon(for: window.app) {
+                Image(nsImage: icon)
+                    .resizable()
+                    .aspectRatio(contentMode: .fit)
+                    .frame(width: iconSize, height: iconSize)
+                    .offset(x: x, y: y)
+            }
         }
     }
 
+    @ViewBuilder
+    private func iconStrip() -> some View {
+        let icons = uniqueIconWindows()
+        HStack(spacing: 2) {
+            ForEach(icons, id: \.id) { window in
+                if let icon = appIcon(for: window.app) {
+                    Image(nsImage: icon)
+                        .resizable()
+                        .aspectRatio(contentMode: .fit)
+                        .frame(width: 12, height: 12)
+                }
+            }
+        }
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .padding(.horizontal, 3)
+        .frame(maxHeight: .infinity, alignment: .bottom)
+        .padding(.bottom, 3)
+    }
+
+    private func uniqueIconWindows() -> [YabaiWindow] {
+        var seen = Set<String>()
+        return windows.filter { seen.insert($0.app).inserted }
+    }
+
     private func appIcon(for appName: String) -> NSImage? {
         NSWorkspace.shared.runningApplications
             .first { $0.localizedName == appName }

Sources/spacemap/ConfigReader.swift

@@ -20,7 +20,12 @@ enum ConfigReader {
             switch key {
             case "GRID_COLS": cols = Int(value) ?? cols
             case "GRID_ROWS": rows = Int(value) ?? rows
-            case "CELL_STYLE": cellStyle = value == "icons" ? .icons : .rects
+            case "CELL_STYLE":
+                switch value {
+                case "icons":  cellStyle = .icons
+                case "hybrid": cellStyle = .hybrid
+                default:       cellStyle = .rects
+                }
             default: break
             }
         }

Sources/spacemap/Models.swift

@@ -1,7 +1,7 @@
 import Foundation
 import CoreGraphics
 
-enum CellStyle { case rects, icons }
+enum CellStyle { case rects, icons, hybrid }
 
 struct GridConfig {
     var cols: Int
@@ -28,6 +28,8 @@ struct YabaiWindow: Decodable {
     let app: String
     let space: Int
     let frame: WindowFrame
+    let isHidden: Bool
+    let isMinimized: Bool
 
     struct WindowFrame: Decodable {
         let x: CGFloat
@@ -36,6 +38,12 @@ struct YabaiWindow: Decodable {
         let h: CGFloat
     }
 
+    enum CodingKeys: String, CodingKey {
+        case id, app, space, frame
+        case isHidden = "is-hidden"
+        case isMinimized = "is-minimized"
+    }
+
     var cgFrame: CGRect {
         CGRect(x: frame.x, y: frame.y, width: frame.w, height: frame.h)
     }