Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/orchetect/maccontrolcenterui
SwiftUI menu builder DSL & controls that mimic macOS Control Center.
https://github.com/orchetect/maccontrolcenterui
control-center controlcenter macos swiftui swiftui-components
Last synced: about 5 hours ago
JSON representation
SwiftUI menu builder DSL & controls that mimic macOS Control Center.
- Host: GitHub
- URL: https://github.com/orchetect/maccontrolcenterui
- Owner: orchetect
- License: mit
- Created: 2022-12-21T09:20:09.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-27T22:33:40.000Z (23 days ago)
- Last Synced: 2025-02-13T00:12:48.540Z (7 days ago)
- Topics: control-center, controlcenter, macos, swiftui, swiftui-components
- Language: Swift
- Homepage:
- Size: 2.64 MB
- Stars: 116
- Watchers: 4
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Mac Control Center UI
[](https://developer.apple.com/swift) [](https://swiftpackageindex.com/orchetect/MacControlCenterUI) [](https://developer.apple.com/swift) [](https://github.com/orchetect/MacControlCenterUI/blob/main/LICENSE)
A **menu builder** and **suite of SwiftUI controls** that closely mimic the feel of **macOS Control Center** menus.
Integrates seamlessly with Swift's new `MenuBarExtra`.
Both **Dark** and **Light Mode** are fully supported.
## Getting Started
### Swift Package Manager (SPM)
1. Add MacControlCenterUI as a dependency using Swift Package Manager.
- In an app project or framework, in Xcode:
Select the menu: **File → Swift Packages → Add Package Dependency...**
Enter this URL: `https://github.com/orchetect/MacControlCenterUI`
- In a Swift Package, add it to the Package.swift dependencies:
```swift
.package(url: "https://github.com/orchetect/MacControlCenterUI", from: "2.3.0")
```2. Import the library:
```swift
import MacControlCenterUI
```3. Try the [Demo](Demo) example project to see all of the available controls in action.
## Requirements
Minimum requirements to compile: Xcode 14 on macOS 12.5 or newer.
Supports macOS 11.0+ once compiled.
## Known Issues
- Due to the lacklustre implementation of window resize behavior in SwiftUI, it is currently not possible to get smooth window resize animations without a tremendous amount of work. For that reason, most MacControlCenterUI controls whose Control Center counterparts use animation will instead use safer static view size changes.
## Author
Coded by a bunch of 🐹 hamsters in a trenchcoat that calls itself [@orchetect](https://github.com/orchetect).
## License
Licensed under the MIT license. See [LICENSE](https://github.com/orchetect/MacControlCenterUI/blob/master/LICENSE) for details.
## Sponsoring
If you enjoy using MacControlCenterUI and want to contribute to open-source financially, GitHub sponsorship is much appreciated. Feedback and code contributions are also welcome.
## Contributions
Contributions are welcome. Posting in [Discussions](https://github.com/orchetect/MacControlCenterUI/discussions) first prior to new submitting PRs for features or modifications is encouraged.