MacPython/AppscriptModule
This wiki is in the process of being archived due to lack of usage and the resources necessary to serve it — predominately to bots, crawlers, and LLM companies. Edits are discouraged.
Pages are preserved as they were at the time of archival. For current information, please visit python.org.
If a change to this archive is absolutely needed, requests can be made via the infrastructure@python.org mailing list.
What is Appscript?
Appscript is a high-level, user-friendly MacPython-to-Apple Event Manager bridge that allows you to control scriptable Mac OS X applications using ordinary Python scripts. Appscript makes MacPython a serious alternative to Apple's own ../AppleScript language for automating your Mac.
For example, to get the value of the first paragraph of the topmost document in ../TextEdit:
app('TextEdit').documents[1].paragraphs[1].get()This is equivalent to the /AppleScript statement:
get paragraph 1 of document 1 of application "TextEdit"
Appscript builds upon lower-level Python packages (aem, osaterminology) to provide:
an Apple event-based RPC mechanism for sending commands to applications
- a mechanism for converting data between common Python and Apple event types
a simple embedded query language for constructing references to an application's object model
- a mechanism that uses application-defined terminology to present these references in human-readable form
- an integrated help system for exploring application terminology information
a clean, object oriented-like syntax for ease of use.
See:
Application scripting notes
Pages containing additional information on scripting individual applications: