Plugins for Apple Mail
SigPro Manual
The Basics
Getting Started
- The account settings such as "Default Signature" can be changed by clicking on the gear icon next to each account.
- Preview each signature in the signature view.
- Checking "Preview Signature" allows you to see the signature with live data when an account is selected.
- Click "Edit Signature” to edit a signature.
- Customize signature items, including managing quotation and setting iTunes tokens.
Edit Signatures
To edit a signature, select the signature and click “Edit Signature”(#4 above). The edit window provides a set of tokens that can be incorporated into any signature. When the signature is used, the token will be replaced with the relevant content to provide a customized signature for each email. Tokens can be added to the signature by dragging them into the signature window.
Simple Tokens:
User Name: The “Full Name” field in the Accounts definition or defined in the SigPro account settings for individual email addresses.
Account Description: The “description” field in the Accounts definition
Email: Email Address as defined in the currently selected mail account
Obscured Email: The “Email Address” field in the Accounts definition translated into a format that most bots will not use to create spam lists, i.e. “sigpro dot support at smallcubed dot com” for “sigpro.support@smallcubed.com”
Skype Button: A button linking to Skype using information from the Skype sidebar. (more information below)
Content Tokens:
URL: Provide a url and a description to add a link into your signature
Image: Provide a url to an image to include the image in your signature
URL w/Image Provide a url to an image, and a url for a link to have a linked image in your signature
Blog Entry: Add the RSS feed for a blog to have the last post of that blog appear in your signature
Script: Create a script to insert content into your signature (more information below)
Adding HTML Content:
Using SigPro it is easy to add content to your signature using a web archive file or an html file through the contextual menu (right-mouse click or ctl+click). After adding html content or a web archive file, you can add tokens to complete the signature. Note that with web archive files, images won’t be visible in the signature editor, but will show up correctly in the signature.
Formatting:
Add formatting to the tokens through the formatting menu of Mail or the “Font” contextual menu. Any formatting applied to the token will be applied to the replacement text.

Account Settings and Aliases
- Account list
- Email addresses for the account: both the default email address and any available aliases
- Set Default Signature for each email
Aliases are added to accounts in the “Accounts” tab of Mail’s preferences. The aliases appear in the small box in the “Account Setting” when the account for the alias is selected.
To set a default signature for an email address, select the address, then from the dropdown menu on the right (#3 above), select the desired default signature.
To have all aliases use the same default signature check: “Use same signature for all email addresses”.
iTunes Integration
The “iTunes” settings can be used to let people know what you are listening to in Apple Music.
iTunes Tokens:
iTunes Song: The currently playing song Music.
iTunes Album: The album of the currently playing song
iTunes Artist: The artist of the currently playing song
iTunes Status: The current status of Apple Music (see below)
iTunes Summary: The summary as set in the iTunes window
The iTunes tokens iTunes Song, iTunes Album, iTunes Artist and iTunes Status can be dragged into any signatures. However, they will only have information if Music is playing.
Another way to display Music infromation is to use the iTunes Summary in your signature. The iTunes Summary will display the content of the status signatures as setup in the iTunes signature window. You can have a different signature display depending on whether Music is: playing, paused, open but not playing, or not open.
Using Random Quotations
The quotes tokens can be used to insert the “Quotation”, “Quote Author”, and the “Quote Citation” into a signature. Each token can be formatted separately as desired. The tokens will be filled in from the content of your “Random Quotes File”.
Quotes:
Quotation: The quotation
Quote Author: The author of the quotation
Quote Citation: Where the quote was taken from
Random Quotes File
In the Signature sidebar there is the “Quotes” section for selecting a “Random Quotes” file to import for use with your signatures.
File Format
The “Ramdom Quote” files can now be created as a json files(filename.json) with the structure:
{
"name": "Category Name",
"description": "Category Description",
"quotes": [
{
"q": "The Quotation",
"a": "The Author",
"c": "A Citation"
}
]
}
In the quotations section, basic HTML format like <strong></strong> to bold, <em></em> to italizie, <u></u> to underline, and <br/> to add line-breaks, can be used along with more complicated inline styling in HTML such as <span style='color:#812bb8'></>span>.
Note that you should only use ‘single quotes’ in the span style.
Sample with HTML formatting
"q": "The <em>quick</em> brown fox jumped over the lazy brown dog.<br/>The <strong>quick</strong> brown fox jumped over the lazy brown dog.<br/>The <u>quick brown</u> fox jumped over the lazy brown dog.<br/>The <span style='color:#812bb8; font-weight:bold; font-size:2em;'>quick</span> brown fox jumped overthe lazy brown dog."
"a": " Typist"
"c": "Typing Practice"<br />
}
Displays as:
The Older Random Quotes File Format is also Accepted
The “Ramdom Quote” file should be a standard text file(.txt) with each quotations, separated by a carriage return. Each line should be broken into three parts: a quotation, an author and a citation.
Sample quote formats:
“Some quotation worth having in an email”:Scott Little:’The read me doc of SigPro’
The first part is the quote, the second is the author and the third is the citation. They should be separated by a colon (:) and can be enclosed within any of several different types of delimiting characters, but the opening and closing for each MUST be the same. Both the author and the citation are optional. The following are allowed:
She sells seashells by the seashore
|…from so simple a beginning endless forms most beautiful and most wonderful have been, and are being, evolved.|:|Charles Darwin|:|On the Origin of Species|
‘There are three types of “Creationist”, Young Earth, Intelligent Design and “Just plain screwed-up”’::
You can also have a quotation that is multi-line. In order to do this simply wrap the entire entry in brackets ([]). The brackets must be the first and last non-blank characters around the quotation, author and citation. The line breaks will be respected in the signature.
Multi-lined Quote:
["…from so simple a beginning
endless forms most beautiful and
most wonderful have been, and are being, evolved.":"Charles Darwin":|On the Origin of Species|]
To add a Skype link to a signature, set up your Skype name in the Skype tab, then drag the Skype token into the signature.
Advanced
Using Scripts
The script token allows scripts to be used to pull content into a signature. This is an advanced feature for users who are comfortable with script writing.
When the script token is dragged into a signature it provides a Finder window to select the scripts. A second window then appears to provide arguments and set whether to use <pre> tags.
Arguments are passed as a simple list separated by spaces. Currently no parsing is done to handle values with spaces in them.
The <pre> tags are used to insert line brakes in the script output. When they are present a <br/> tag is placed at the end of existing signature content and replaces any line break in the script’s returned data.

Contact Information
If you have further questions, or SigPro doesn't act as you expect, you can contact us at the following email address: support@smallcubed.com.
©2022 SmallCubed • All rights reserved.