SigPro Manual

Printable Version

The Basics

Getting Started


The Signature preferences of Mail with SigPro Installed
  1. The account settings such as "Default Signature" can be changed by clicking on the gear icon next to each account.
  2. Preview each signature in the signature view.
  3. Checking "Preview Signature" allows you to see the signature with live data when an account is selected.
  4. Click "Edit Signature” to edit a signature.
  5. Customize signature items, including managing quotation and setting iTunes tokens.

Edit Signatures


SigPro 'Edit Signature' window

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)


Simple Signature Tokens

Simple Signature

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


Image with URL Signature Tokens

Image with <br/>URL Signature data

Image with URL Signature appearance

Blog Entry: Add the RSS feed for a blog to have the last post of that blog appear in your signature


Blog entry with URL Signature Tokens

Blog entry with <br/>URL Signature data

Blog with URL Signature appearance

Script: Create a script to insert content into your signature (more information below)


Script entry with URL Signature Tokens

Script entry with <br/>URL Signature data

Script with URL Signature appearance

 

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.


Signature from webarchivecontextual menu

Signature from <br/>webarchive no tokens

Signature from <br/>webarchive with tokens

Signature from <br/>webarchive appearance

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.


Font contextual menu

Formatted tokens <br/>in signature

Formatted Signature appearance

Account Settings and Aliases


Account Setting
  1. Account list
  2. Email addresses for the account: both the default email address and any available aliases
  3. 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.


iTunes Summary setup window

iTunes Summary 'Play' signature setup

Music signature <br/>while playing icon

  <br/>Signature seen while playing

Music signature<br/>while paused icon

  <br/>Signature seen while paused

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.


Quotes preference window

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:


Signatue in message

Signature setup

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|]

Setting Up the Skype Button

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.


Skype tab setup

Skype signature in rich text

Skype signature in plain text

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.


Script token in signature

Open finder window to browse to script

Arguments are passed as a simple list separated by spaces. Currently no parsing is done to handle values with spaces in them.


Enter Arguments and set 'pre' tags

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.


Signature with 'pre' tags

Signature without 'pre' tags

Sample Script


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.