https://github.com/swiftDialog/swiftDialog
Create user-notifications on macOS with swiftDialog
https://github.com/swiftDialog/swiftDialog
Last synced: 5 months ago
JSON representation
Create user-notifications on macOS with swiftDialog
- Host: GitHub
- URL: https://github.com/swiftDialog/swiftDialog
- Owner: swiftDialog
- License: mit
- Created: 2021-03-11T20:43:09.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-04-29T07:19:09.000Z (about 1 year ago)
- Last Synced: 2024-05-02T02:11:00.036Z (about 1 year ago)
- Language: Swift
- Homepage:
- Size: 14.6 MB
- Stars: 489
- Watchers: 40
- Forks: 49
- Open Issues: 35
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-macadmin-tools - https://github.com/swiftDialog/swiftDialog
README
[](https://developer.apple.com/xcode/swiftui/) [](https://github.com/gonzalezreal/swift-markdown-ui) [](https://github.com/SwiftyJSON/SwiftyJSON) [](https://github.com/danielsaidi/WebViewKit)
[](https://github.com/bartreardon/swiftDialog/releases)
# swiftDialog
swiftDialog is an [open source](https://github.com/bartreardon/Dialog/blob/main/LICENSE.md) admin utility for macOS 12 or later written in SwiftUI that presents custom dialogs, displays informative messages or can be used as a form to request user input.
Latest releases can be found on the [Releases](https://github.com/bartreardon/Dialog/releases) page
Detailed documentation and information can be found in the [Wiki](https://github.com/bartreardon/Dialog/wiki)
## Appearance
Every aspect of swiftDialog's appearance can be modified.
At the most simple level you need only give swiftDialog a [Title](https://github.com/bartreardon/Dialog/wiki/Customising-the-Title) and a [Message](https://github.com/bartreardon/Dialog/wiki/Customising-the-Message-area) to display but there is more utility in modifying other aspects of the appearance:
* [Pass in an image resource](https://github.com/bartreardon/Dialog/wiki/Customising-the-Icon) to display as the swiftDialog icon, or use an app path or system preference bundle path and swiftDialog will extract the icon for display.
* [Add extra buttons](https://github.com/bartreardon/Dialog/wiki/Buttons-and-button-behaviour). Change the text to say what you want. Wait for user input or automatically time out.
* [Use markdown](https://github.com/bartreardon/Dialog/wiki/Customising-the-Message-area#markdown-support-new-from-v150) in the message to add **bold** or _italics_ or include URL links
* Change the [colour, size or even the font](https://github.com/bartreardon/Dialog/wiki/Customising-the-Title#customising-title-font-properties) used in the Title and Message areas
* [Change the size](https://github.com/bartreardon/Dialog/wiki/Window-Size-and-Behaviour) of the swiftDialog window
* Display [Videos](https://github.com/bartreardon/Dialog/wiki/Customising-the-Message-area#displaying-videos-new-from-v180) or [Images](https://github.com/bartreardon/Dialog/wiki/Customising-the-Message-area#displaying-images-new-from-v160) either locally or pass in a URL
* and lots more...
## Commandline Options
swiftDialog's interface is fully customised from a set of command line options.
For details on all the available options, please read the [Command Line Options](https://github.com/bartreardon/Dialog/wiki/Command-Line-Options) page on the wiki.
****
## 💡 Giving Feedback
🐞 If there are bugs or ideas, please create an [issue](https://github.com/bartreardon/Dialog/issues/new/choose) so your idea doesn't go missing.
Also come chat in the `#swiftDialog` channel in the [MacAdmins Slack](https://www.macadmins.org)
## 🤝 Contributing
Please read the [CONTRIBUTING.md](https://github.com/bartreardon/Dialog/blob/main/CONTRIBUTING.md) for details on how you can contribute.