1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
import SwiftUI
/// The top-level configuration for the bar.
///
/// Set appearance, define blocks, and choose the bar position here.
/// This is the primary file a user edits to customise phbar.
enum Config {
/// The bar height in points (pt).
///
/// Tip: Set this value to 30 to match the default macOS
/// menu bar height.
static let height: CGFloat = 30
/// The bar position on the screen.
static let position: Position = .top
/// The font used for all text and icons in the bar.
static let font: Font = .custom("Comic Code", fixedSize: 14)
/// The color used for texts and icons.
static let foreground: Color = .hex("#aed3f3")
/// The color used for the bar background.
static let background: Color = .hex("#010408").opacity(0.825)
/// The colors used to highlight a cell at different levels (see ``Cell``).
static let highlights: [Color] = [.hex("#0f304a"), .hex("#1f689d")]
/// The blocks that make up the bar, listed in display order.
///
/// Each block is positioned on the left or right side of the bar
/// and runs a shell command, optionally on a repeating interval.
/// See ``Config-swift.enum/Block`` for the full configuration options.
static let blocks: [Block] = [
Block(name: "app", placement: .left, command: "echo ' Safari '"),
Block(
name: "memory", placement: .right, command: "~/.config/phbar/scripts/memory", interval: 10),
Block(
name: "clock", placement: .right, command: "~/.config/phbar/scripts/clock", interval: 1),
]
}
// MARK: Support types
extension Config {
/// The bar position on the screen.
enum Position: Sendable {
/// Anchor the bar at the top of the screen.
case top
/// Anchor the bar at the bottom of the screen.
case bottom
}
/// A block defined in the configuration.
///
/// Represents one unit of the bar. Each block is a named command that
/// produces output on an optional timer. See ``phbar/Block`` for the
/// runtime counterpart that manages execution and cell publishing.
struct Block: Sendable {
/// The block identifier used for manual updates.
///
/// Some blocks do not need to be updated on an defined
/// interval. You might want instead to react to specific
/// events or "manually" update them.
/// In such cases, you can send a standard system
/// notification that tells phbar to trigger an update
/// for the block identified by the name.
///
/// E.g: `notifyutil -p house.panini.phbar.touch.<name>`
///
/// Be aware that nothing stops you from having multiple
/// blocks with the same name. In such case, triggering
/// a notification will cause all blocks with that name
/// to be re-evaluated.
let name: String
/// Whether the block anchors to the left or right side of the bar.
let placement: Placement
/// The shell command used for updating the content.
///
/// You can write an expression directly in the block
/// definition or you can point to a proper executable
/// script somewhere on the system.
///
/// The command process will inherit the environment
/// of the process that executed phbar in the first place.
/// This means that running phbar from your regular shell
/// or from launchctl might result in different behaviours.
/// Make sure to test both scenarios properly.
let command: String
/// The interval, in seconds, at which the command is executed.
///
/// If set to `nil`, the block will be evaluated just once
/// at launch. You can of course trigger a manual update via
/// a notification later on.
let interval: Double?
/// Define a block of the bar.
///
/// - Parameters:
/// - name: The block identifier used for manual updates.
/// - placement: Left or right side of the bar.
/// - command: The shell command used for updating the content.
/// - interval: The interval, in seconds, at which the command is executed.
///
init(name: String, placement: Placement, command: String, interval: Double? = nil) {
self.name = name
self.placement = placement
self.command = command
self.interval = interval
}
/// Where the block is anchored inside the bar.
enum Placement: Sendable {
/// Anchored to the left side of the bar.
case left
/// Anchored to the right side of the bar.
case right
}
}
}
|
