Ircle Reference - - Scripting

Ircle main page | Reference Guide main page

Ircle Scripting

Ircle makes use of AppleScript to automate tasks. AppleScript is a scripting language/software that comes with System 7.5 and later.

On the Ircle site you can find links to documentation and scripts made by others.

AppleScript
AppleScript is the scripting language for the Macintosh. It is an English-like language that has been compared to batch files on PC's, but it is more like UNIX shell scripts in its power and flexibility.

Download AppleScript?
You can get AppleScript and the AppleScript Language Guide here.

How to set up Ircle to use AppleScripts
First of all, go to 'Preferences' and click on the tab labelled 'Scripts'. There you have to show Ircle where your Scriptfolder is located, by clicking on the select-button in the Script Folder Area. You can also tell Ircle to use a script on startup. Click on the select-button in the startup script area to show Ircle which script you want to use as your startup script. After you selected the script folder and/or startup script, click on the 'OK'- button or hit return and choose 'Save Preferences' from the File Menu.

How to run a script in Ircle

To run a script in Ircle type /scriptname and then hit return. For example: type /colorgreet #channelname followed by return.
The script will be executed and unloads after completion.

Some scripts can be loaded into Ircle memory permanently and be used to process events sent by Ircle (text coming in, timer events etc.). Type /load scriptname or /load to load them. Type /unload to delete them from Ircle memory. Ircle will not send events to the script anymore. Only one script can be loaded at the same time.

Making your own AppleScripts
You can write your own scripts or edit scripts by using the Script Editor which comes with the AppleScript installation. Check out the example scripts for scripters folder. It contains example scripts for loadable scripts and executable scripts.