https://github.com/jo-tools/applescript-automation
Using AppleScript for Automation with Xojo
https://github.com/jo-tools/applescript-automation
applescript automation macos xojo
Last synced: over 1 year ago
JSON representation
Using AppleScript for Automation with Xojo
- Host: GitHub
- URL: https://github.com/jo-tools/applescript-automation
- Owner: jo-tools
- License: mit
- Created: 2023-10-14T14:19:23.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-09T16:32:15.000Z (over 1 year ago)
- Last Synced: 2025-03-09T17:25:27.198Z (over 1 year ago)
- Topics: applescript, automation, macos, xojo
- Language: Xojo
- Homepage: https://www.jo-tools.ch
- Size: 4.55 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# AppleScript-Automation
Xojo example project
[](LICENSE)
## Description
There used to be a time where any application just could execute AppleScripts to Automate other applications such as: `tell application X to do Y`.
That's no longer the case starting with `macOS 10.14`. It's become a bit trickier to do that with a Xojo built application, since not everything is built in.
This example project shows:
- How to use AppleScript for Automation in a Xojo built application by providing an `Info.plist` with `NSAppleEventsUsageDescription`.
*Without that, nothing will work at all.*
- How to determine if the application has permission for AppleEvents / Automation (`AEDeterminePermissionToAutomateTarget`).
- Explains how to deal with the permission results.
- In case you determine the application has no permission:
How to open System Preferences at Privacy - Automation *(so that the user can allow the app)*.
Additionally:
- Check if an Application is running *(find .app by BundleIdentifier )*
and if not: launch it.
### ScreenShots
Automate `Terminal.app` by executing a Shell command in `Terminal.app`
Determine Permission to automate `Terminal.app`
## Xojo
### Requirements
[Xojo](https://www.xojo.com/) is a rapid application development for Desktop, Web, Mobile & Raspberry Pi.
The Desktop application Xojo example project ```applescript-automation.xojo_project``` is using:
- Xojo 2024r4.2
- API 2
### How to use in your own Xojo project?
1. Drag the example `Info.plist` into your project.
Edit it and change the `NSAppleEventsUsageDescription` to fit your app's purpose.
2. To determine Automation-Permission and opening System Preferences at Privacy - Automation
- copy-and-paste the Module `modAppleScriptUtils` into your project.
If you want to check for an .app running *(and launching it if required)* then additionally
- copy-and-paste the Module `modMacOsApplications` into your project.
3. Use the provided Methods in the Modules in a similar way to this example project.
4. [Codesign](https://github.com/jo-tools/xojo2dmg) *(with hardened Runtime)* and/or [Notarize](https://github.com/jo-tools/xojo2dmg) your application:
Make sure to have the `Entitlement` enabled: `com.apple.security.automation.apple-events`
- set Xojo Build Settings: macOS -> Sign
- or use [Xojo2DMG](https://github.com/jo-tools/xojo2dmg)
## About
Juerg Otter is a long term user of Xojo and working for [CM Informatik AG](https://cmiag.ch/). Their Application [CMI LehrerOffice](https://cmi-bildung.ch/) is a Xojo Design Award Winner 2018. In his leisure time Juerg provides some [bits and pieces for Xojo Developers](https://www.jo-tools.ch/).
### Contact
[](mailto:xojo@jo-tools.ch)
[](https://www.facebook.com/juerg.otter)
[](https://twitter.com/juergotter)
### Donation
Do you like this project? Does it help you? Has it saved you time and money?
You're welcome - it's free... If you want to say thanks I'd appreciate a [message](mailto:xojo@jo-tools.ch) or a small [donation via PayPal](https://paypal.me/jotools).
[](https://paypal.me/jotools)