MagiCall Help

General Usage
Manage Profiles
Setting Up a Rule
Rule Configuration
Using Command Line
Perl RegEx Quick Ref
Options
Log Viewer
Registration
Rule List Filter
Start & Stop Service
Login Window
List of icons
Quit & Close MagiCall

Rule List Filter
Choose a filter type from the Filter Type menu in the top-right corner of the main window, the rule list will be updated based on the rule type selected.

Start & Stop Service
Press the button in the top-left corner of the main window to start or stop the filtering service. "Running" means MagiCall is on service. "Stopped" means MagiCall will not capture any calls or messages.

Login Window
If you have set up a login password, a login window will pop up each time you attempt to enter the main window or the log dialog.

List of icons
run indicates MagiCall is in the running state;
stop indicates MagiCall is in the stopped state;
event indicates a rule has been triggered;
inbound indicates an incoming call rule type;
outbound indicates an outgoing call rule type;
sms indicates an SMS rule type;
missed indicates a missed incoming call type;
inbound_disabled outbound_disabled sms_disabled missed_disabled indicate the rule is disabled;
time indicates the rule is effective within the time specified in the configurations;
keep indicates the log is in Kept state and cannot be deleted.

Exit & Close MagiCall
To completely exit MagiCall, select Menu>Exit from the main window.
To close the main window but keep the program running, tap [OK] or select Menu>Minimize.

Manage Profiles
Create a profile
Delete a profile
Rename a profile
Add rules to a profile
Remove rules from a profile

Create a profile
Select Manage>New profile... and input a name to create a profile. Each profile must have a unique name. If the name you input to create a new profile exists already, the existing profile is actived instead of creating a new profile.

Delete a profile
You may delete the active profile, by selecting Manage>Delete profile.

Rename a profile
You may rename the active profile, by selecting Manage>Rename profile... and then input a new name.

Add rules to a profile
When you create new rules, they will be added to the active profile automatically. You may also include other rules from the global rule pool to the active profile, by selecting Manage>Add rules....

Remove rules from a profile
To exclude rules from the active profile, select Manage>Exclude rules..., or Manage>Selected Rule>Exclude. Rules are excluded from the active profile only. They are still existing in the global rule pool and other profiles. To delete a rule completely, read Delete a rule.

Setting Up a Rule
Create a new rule
Create a new copy
Modify a rule
Delete a rule
Move a rule

Create a new rule
Select Manage>New Rule... from the main window.

Create a new copy
Tap and hold the stylus on a rule to display the context menu and then select Add Copy... from the context menu, or select Manage>Selected Rule>Add Copy... from the menu.

Modify a rule
Tap an item from the rule list in the main window.

Delete a rule
Tap and hold stylus on a rule to open the context menu and then select Delete from the context menu, or select Manage>Selected Rule>Delete from the menu.

Move a rule
Tap and hold stylus on a rule to open the context menu and then select Move Up, Move Down, Move To Top or Move To Bottom from the context menu, or select actions from menu Manage>Selected Rule. Note: This only affects the current actived profile, the position of rules in other profiles will not be changed.

Rule Configuration
General
Filter
Operation
Appointment
Others
Select Outlook Contacts
Select SIM Contacts
Select Call Logs
Select an Application
Using Contextual Parameters
Edit Menu
Save & Cancel

Select Outlook Contacts
To select phone numbers from Outlook Contacts, select Menu>Select Outlook Contacts. A gray menu item means this item is not available in current case.

Select SIM Contacts
To select phone numbers from SIM Contacts, select Menu>Select SIM Contacts. A gray menu item means this item is not available in current case. If your phone does not use SIM cards, this item will always be gray.

Select Call Logs
To select phone numbers from Call Logs, select Menu>Select Call Logs. A gray menu item means this item is not available in current case.

Select an Application
To select an application, select Menu>Select an Application. A gray menu item means this item is not available in current case.

Edit Menu
You can select/copy/paste data in the text box by using the Edit Menu. To open the Edit Menu, select Menu>Edit.

Save & Cancel
Select Save or [OK] to save changes, or select Menu>Cancel to discard modifications.

Using Contextual Parameters
Contextual parameters are predefined keys which will be replaced by actual values in a real case. You can select valid contextual parameters of a certain circumstance from Menu>Insert or input them by yourself. A gray menu item means this item is not available in current case. Valid contextual parameters are:
{phone}
{phone}[x,y]
{mobile}
{keyword}
{name}
{lastname}
{firstname}
{date}
{time}
{message}
{msg-clip}
{signature}
{appt-subject}
{appt-notes}
{appt-location}
{appt-start-date}
{appt-start-time}
{appt-end-date}
{appt-end-time}
{appt-duration}

{phone}
Indicates an incoming or outgoing phone number or a number from a message sender. You may add a leading '-' to remove plus mark from phone numbers. For example: -{phone}

{mobile}
Indicates the mobile phone number of the caller, the phone call receiver, or the message sender. You may add a leading '-' to remove plus mark from phone numbers. For example: -{mobile}

{keyword}
Indicates the first matched keyword found in the SMS content.

{name}
Indicates the name of the caller, the phone call receiver, or the message sender.

{lastname}
Indicates the last name of the caller, the phone call receiver, or the message sender.

{firstname}
Indicates the first name of the caller, the phone call receiver, or the message sender.

{date}
Indicates the date when a rule is triggered.

{time}
Indicates the time when a rule is triggered

{message}
Indicates the content of a received SMS message

{msg-clip}
Indicates the content of a received SMS message but excluding the matched keyword

{signature}
Applies the customized signature

{appt-subject}
Indicates the subject of an existing appointment

{appt-notes}
Indicates the notes of an existing appointment

{appt-location}
Indicates the location of an existing appointment

{appt-start-date}
Indicates the start date of an existing appointment

{appt-start-time}
Indicates the start time of an existing appointment

{appt-end-date}
Indicates the end date of an existing appointment

{appt-end-time}
Indicates the end time of an existing appointment

{appt-duration}
Indicates the duration of an existing appointment in this format: h:mm:ss

{phone}[x,y]
You can only use this parameter to automatically change phone numbers before calls. {phone} is critically required by default while [x,y] is optional. x and y both take a value of an integer, with a range from -255 to 255. You may add a leading '-' to remove plus mark from phone numbers. For example: -{phone}[0,0]. For detailed usage of x and y, please refer to the following:
[0,0]
[+x,+y]
[+x,-y]
[+x,0]
[-x,+y]
[-x,-y]
[-x,0]
[0,+y]
[0,-y]

{phone}[0,0]
{phone}[0,0] works the same as {phone}.

{phone}[+x,+y]
Reserves the first to x characters from the left of {phone} and the first to y characters from the right of {phone} while eliminating the other characters. If the length of {phone} is shorter than x+y, all characters of {phone} will be reserved.

{phone}[+x,-y]
Reserves the first to x characters from the left of {phone} while eliminating the first to y characters from the right of {phone}. If the length of {phone} is shorter than x+y, then [+x,-y] works the same as [+x,0]; else if, it works the same as [0,-y].

{phone}[+x,0]
Reserves the first to x characters from the left of {phone} while eliminating other characters. If the length of {phone} is shorter than x, then all characters of {phone} will be reserved.

{phone}[-x,+y]
Reserves the first to y characters from the right of {phone} while eliminating the first to x characters from the left. If the length of {phone} is shorter than x+y, then [-x,+y] works the same as [0,+y]; or else, it works the same as [-x,0].

{phone}[-x,-y]
Eliminate the first to x characters from the left of {phone} and the first to y characters from the right while reserving only the leftover characters. If the length of {phone} is shorter than x+y, all characters of {phone} will be eliminated.

{phone}[-x,0]
Eliminates the first to x characters from the left of {phone} while reserving the other characters. If the length of {phone} is shorter than x, all characters of {phone} will be eliminated.

{phone}[0,+y]
Reserves the first to y characters from the right of {phone} while eliminating all other characters. If the length of {phone} is shorter than y, all characters of {phone} will be reserved.

{phone}[0,-y]
Eliminates the first to y characters from the right of {phone} while reserving all other leftover characters. If the length of {phone} is shorter than y, all characters of {phone} will be eliminated.

General
Rule name
Rule type
Call rule
Enabled

Rule name
Rule name is used to specify the usage of a rule. (optional)

Rule type
Select a rule type from the list. Rule types include: Incoming Call, Outgoing Call, SMS and Missed Call.

Call rule
Select an option to active this filter according to current call state:
Always apply: Always active this filter regardless of call states
Apply when no call ongoing: Active this filter when there is no active call
Apply when on a call: Active this filter when you are on a call

Enabled
You can choose a condition to enable this rule through any of the following options:
Always: Enable this rule unconditionally
When roaming only: Enable this rule when roaming
When non-roaming only: Enable this rule when non-roaming
Never: Disable this rule unconditionally

You may change the enable state of a rule by any of the following ways:
1. Select one rule to open the Rule Configuration window, navigate to the [Enabled] field and change it
2. Tap the icon of each rule from the Rule List window (only works on devices with a touch screen)
3. Select one sub-menu item from Enabled from the Context Menu of the Rule List window

Filter
Filter type
Phone #
Category
Name list
SMS filter

Filter type
Choose one type you want to filter:
All: Filters all incoming calls, outgoing calls, SMS messages or Missed calls regardless of their numbers or names.
Specific Number: Filters numbers that match the ones specified in the Phone# field.
Contacts: Filters numbers that are alike to one of those numbers from Outlook Contacts or SIM Contacts.
Unknown Number: Filters numbers that are not alike to any numbers from Outlook Contacts or SIM Contacts.
Anonymous: Filters calls without caller numbers or messages without sender numbers.
Outlook Category: Filter numbers that are owned by Outlook contacts belonging to the selected Outlook Categories.
Contact's Name: Filters messages sent by specified senders or filters calls from or to specified contacts. You may use ';' to separate names.
Meeting Recipient: Filters outlook contacts who are attendees of a present appointment.
Contact's Notes: Filters messages sent by specified senders or filters calls from or to specified contacts whose notes in Outlook is matched. You may use Regular Expressions in this field.

Phone #
If you choose Specific Number, Contacts or Unknown Number as the filter type, the Phone # text box will also be enabled. You may use two wildcard characters '*', and '?' in this text box. '*' represents any digit in any times. '?' represents a single digit. In addition, you can use one single Perl compatible regular expression line in this text box. Read Perl RegEx Quick Reference for simplified syntax explanations.

You may also use a leading character '~' to make negative logic.

There is an icon shortcut on the right side of this field. You may select this icon to open a new dialog for editing multiple items.

(This field is optional for filter type Contacts and Unknown Number. If it contains contents, the phone number being compared must match both criteria. If it is empty, the phone number being compared only needs to match the filter type criterion.)

Examples:
To block the entire area code 852, enter (852)* or (852)???-????.
To block any phone number containing 7, enter *7*.
To block all other phone numbers except 12345678, enter ~12345678.
If you want to block phone number 633-7777 but not care about its area codes or country codes, just enter 633-7777.

Each item consists of a phone number and an optional comment using one space as the separator, so please don't leave spaces among phone numbers. To separate multiple items, use ';'. For example: (123)456-7890 Jack Will; (987)654-3210 Peter Lee; 135-790-8642

A valid phone number filter can contain digits, '#', '\*', '*', '?'. Other characters or text after the first space of each item will be ignored.

To select multiple numbers from Contacts or from Call Logs, select the icon on the right side of this field.

Note: If this field contains multiple items, it will not be editable, and only display a message of <n Items>. You can select it to open another window for editing.

Category
If you choose Outlook Category as the filter type, This field will be enabled. You can select categories by selecting the text box or by selecting the icon shortcut on its right side.

Name list
If you choose Contact's Name as the filter type, This field will be enabled. Enter contacts' name here for filtering. Use ';' to separate names. You may also select the icon shortcut on the right side of this field to open a new dialog for editing. In addition, you can use one single Perl compatible regular expression line in this text box. Read Perl RegEx Quick Reference for simplified syntax explanations.

SMS filter
Use the SMS filter to filter messages that contain specified contents. Clear up the contents in the text box, if you do not want to filter by contents.
Contents are filtered by the keys specified in the filter criteria. Use a space, a tab, or a return character as a separator between keys. If a key contains a separator, embrace the key with double or single quotes ("" or ''). For each key, you must use the same type of quote on both sides. There are three types of keys:
Must Include: If a key is headed by a '+', this indicates that this key must be included.
Must Not Include: If a key is headed by a '-', this indicates that this key must not be included.
Any: Not be headed by '+' or '-' indicates that this key can be included or can be not included.
A message suitable to be filtered must not contain the contents that are specified in the Must Not Include key but it must contain those contents that are specified in the Must Include key as well as contains at least one specified Any key.

Regular Expressions
You may also use Perl compatible regular expressions for filtering SMS contents. Just enclose each regular expression line with '<' and '>'. Regular expressions can be used with normal string keys and with headed signs as well. For example, if you want to filter SMS with texts consisting of 8 digits in its content, you may use this expression: +<\d{8}>

Read Perl RegEx Quick Reference for simplified syntax explanations.

Operation
Action1
Action2

Action1
Choose what to do when a rule is filtered.
System Default: Phone calls will ring as normal and messages will be processed in a normal way.
Pass on to next rule: Calls or messages are passed on to a next matching rule, but Action2 is executed.
Hang up: Hang up incoming or outgoing calls.
Pick up and drop: Answer an incoming call and immediately hang it up.
Pick up and hold: Answer an incoming call and hold it.
Ignore: Your phone will not ring when ignoring an incoming call.
Answer: Answer incoming calls automatically after specified seconds.
Delete: Messages are permanently deleted.
Mute: SMS will not make sounds. (only available on Pocket PC devices)
Move: SMS will be moved to the folder specified in the [To folder] text box. (Use '\' to separate sub-folders)
Mark as read: SMS will be marked as read. There will be no system New Message notifications.
Mark as read and move: SMS will be marked as read and moved to the specified folder. (Use '\' to separate sub-folders)
Send DTMF: Send DTMF digits to the phone line. Good inputs include: regluar phone pad (0-9,#,*); pause (','); answer ('a'); hang up ('h'). For example: ,,a,12*34#,,h
Change dialed number: Automatically make relevant intelligent changes to outgoing numbers before calls by using what you have specified in the [Call to] text box. You can use a comma (',') to pause for a second. To pause longer, use more commas.
Change dialed number (v2): Change outgoing numbers in a new way (through Phone App). This option can work with USSD. You can use a comma (',') to pause for a second. To pause longer, use more commas.

Action2
If you do not want to do anything when a rule is triggered, choose Do nothing. Otherwise, select Send SMS, Send Email or Launch application.
Send SMS: Type the receiver's number in the [To] text box. Use the semicolon (';') to separate multiple receivers from each other. Type a message in the [Message] text box.
Send Email: (To make this option working, you need to select an Email Account from Options first) Type email addresses in the [To] text box. Use the semicolon (';') to separate email addresses. Type a message in the [Message] text box.
Launch application: Type the full path of a program in the [App path] text box. Specify appropriate parameters for the application in the [Param] text box. Press [Test] to test whether the application is correctly running.

Appointment
Use appointments as additional filtering criteria. That means this rule will be matching only when there is a matching appointment existing.

Meeting Status
Sensitivity
Busy Status
Subject
Category

Meeting Status
Specify a meeting status as a criterion. Select Any if you don't care about it. If an appointment has attendees, it is a meeting otherwise it is not a meeting.

Sensitivity
Specify an appointment sensitivity as a criterion. Select Any if you don't care about it.

Busy Status
Specify an appointment status as a criterion. Select Any if you don't care about it.

Subject
Specify an appointment subject as a criterion. Leave it empty if you don't care about it.

Category
Specify appointment categories as a criterion. Leave it empty if you don't care about it.

Others
Set intervals
Choose notice types

Set intervals
[Between] and [and] define the interval of a day when the rule functioning. If the value of [Between] equals to that of [and], the rule will function all day long. If the value of [Between] is bigger than that of [and], the intervals are [Between] to 23:59:59 and 0:00 to [and].
[On] defines the day of week on which the rule is functioning. Specifying none will disable the rule.

Choose notice types
Select notices when a rule is triggered.
[Show tray icon]: will display a notice tray icon on the Today screen
[Show notifications]: will show a notification and display a mono icon on title bar
---[Enable beep sound]: will play a short beep sound with notifications (only for devices with a touch screen)
---[Customize...] Notification Title: put customized notification title here. Notification Body: put customized notification text here. You may use html format text in the body field. Three placeholders are available for use: %1 - represents a phone number; %2 - represents a contact's name; %3 - represents a changed outgoing number
[Log events]: will record the event in the log file and notify you through Today/Home plugin
[Set notification LED]: will change the state of the LED specified in the LED Option. (only works when your device has LED. LED may not behave the same as the selected option, depending on OEM implementation)

Using Command Line

Usage:
MGC <option1> <option2> <option3> ...

Valid Options:
-h	To start MagiCall and hide its main window
-lv	To show the Log Viewer window
-q	To quit the currently running instance of MagiCall
-p	To pause MagiCall but not to quit it
-r	To resume MagiCall if it is paused
-prof profile_name	Active the profile whose name is specified
-noprof	Deactive current profile, and use the global rule pool instead
-clog	To compact the log file
-dlog	To permanently delete the entire log file
-e rule1 rule2 ...	To enable the rule(s) with the given name(s)
-d rule1 rule2 ...	To disable the rule(s) with the given name(s)
-pwd password	To supply the password if it has been set up in MagiCall

Samples:
MGC -h -pwd spdpwd -e "Block All" -d Spam "Some Others"
MGC -h -pwd passwd -prof "Profile 1"

Options
General
Advanced
Security
Misc
Save & Cancel

Save & Cancel
Tap Save or [OK] to save changes. Select Cancel to discard changes.

General
Always show the tray icon
Auto start when the system reboots
Use Today/Home plug-in
Delete log items older than
Caller ID comparison count
Data file location

Always show the tray icon
To show a tray icon on the Today screen, select this option. When MagiCall is running, deselecting this option will hide all tray icons except the notice tray icon.

Auto start when the system reboots
If you have selected this option, MagiCall will auto start in background when the system reboots. Otherwise, manual startup is required.

Use Today/Home plug-in
If you have installed Today/Home plug-in module. This option is enabled. You may select it if you want to display this plug-in in your Today(PPC) or Home(SP) screen.

Delete log items older than
Specify how long the logged items will be kept.

Caller ID comparison count
Define how many digits to be compared for MagiCall to determine if a phone number is matching a Phone# filter item which does not contain any wildcards. Unlike MagiCall 1.x which compares all digits, this option makes v2.x to work more likely same as system default. (Windows Mobile only compares last 6 digits).
Note: Filter items with wildcards will not be affected by this option. They always compare all digits.

Data file location
Choose a folder to store rule file and log file. After you change the file location, you may be asked to restart MagiCall or reload rules.

Advanced
Email account for sending Email
Keep copies in Sent Folder
Send SMS/Email once every minutes
Answer calls after this seconds
Lock Rules file and Logs file
Look into SIM Contacts

Email account for sending Email
Select an Email account to work with Action2 "Send Email".

Keep copies in Sent Folder
Make copies in Sent Folder when using Action2 to send SMS or Email.

Send SMS/Email once every minutes
Send only one SMS or Email to a same recipient of a same rule every specified minutes.

Answer calls after this seconds
This option is for Action1 "Answer" for incoming calls.

Lock Rules file and Logs file
If this option is checked, Rules file and Logs file will not be accessible to other programs when MagiCall is running. Enable this option will prevent those two files from being modified accidentally, but you will fail to synchronize them either.

Look into SIM Contacts
Enable this option if your phone has a SIM card and there are some contacts stored on it, otherwise MagiCall will not treat SIM Contacts as known numbers.

Security
Set password
Reset password
Clear a password
Keep logon in this minutes

Set password
Press [Set password] to set a new password. When a password is specified, you are required to enter the password each time you log into the main window or the Log Viewer.

Reset password
To change the password, press [Reset password].

Clear password
Use the [Clear password] button to clear the existing password.

Keep logon in this minutes
Use this option to keep in the logon status as long as specified minutes. Set it to 0 to disable it.

Misc
LED Option
Auto clear
Replace numbers in SMS
Signature

LED Option
Specify a LED ID for changing state by rules. Please refer to rule LED setting. Disabled if there is no LED available on the device.

Auto clear
If checked, it will automatically turn off the specified LED when opening the rule list window or Log Viewer.

Replace numbers in SMS
Choose a type of SMS in which you want to replace numbers with contacts' name.

Signature
Specify a signature of your own to replace the text of the contextual parameter {signature}

Log Viewer
Open a log
Delete logs
Delete Log File
Compact Log File
Keep/Unkeep logs
Basic Information
Advanced Operation

Open a log
Tap a log item to open the log.

Delete logs
Select log items by tapping the icons on the left, and select Menu>Delete.

Delete Log File
Log File will be deleted entirely and permanently. Note: Kept logs will be deleted also.
To delete Log File, select Menu>Delete>Entire Log File.

Compact Log File
All deleted items will be physically removed from the log file, the size of log fie will be reduced.
To compact log file, select Menu>Compact Log File.

Keep/Unkeep logs
Select log items by tapping the icons on the left and select Menu>Keep/Unkeep. A kept log will not be deleted even if it is older than the time that specified in the Delete log items older than.

Basic Information
Displays information including when a rule was triggered, what phone number was called, what action in Action1 has been taken, and the original SMS message.

Advanced Operation
If the triggered rule contains an action of Action2, relevant information will display in this section. Information includes what action in Action2 was, what number was the call called / message sent to, and what message sent; or what application was launched, what parameters were used to launch the application, and what the result of the application was.

Perl Regular Expression Quick Reference
You may use Perl compatible regular expressions for Phone #, Name list and SMS filter, by enclosing a regular expression line with '<' and '>'. For example: <\d{8}>

Specific characters
Metacharacters
Anchors
Quantifiers
Character class metacharacters
Character class shortcuts

Specific characters

\t	A tab character
\n	A newline character
\r	A carriage return character
\f	A form feed character

Metacharacters
The following 12 characters need to be escaped with a backslash - '\' - because by default, they mean something special:
\ | ( ) [ { ^ $ * + ? .

.	Match any one character (except \n)
\|	Alternation
( )	Group and capture
[ ]	Define character class
\	Modify the meaning of the next char

Anchors
These are also known as zero width assertions.

^	Match at the beginning of a string (or line)
$	Match at the end of a string (or line)
\b	Match at a 'word' boundary
\B	Match at not a 'word" boundary

Quantifiers
By default, qualifiers are "greedy". They attempt to match as many characters as possible. In order to make them match as few characters as possible, follow them with a question mark '?'.

*	Match 0 or more times
+	Match 1 or more times
?	Match 0 or 1 time
{N}	Match exactly N times
{N,}	Match at least N times
{N,M}	Match at least N times but not more than M times

Character class metacharacters

^	If the first character of a class, negates that class
-	Unless first or last character of a class, used for a range

Character class shortcuts
These shortcuts can be used either on their own, or within a character class.

\d	[0-9]	A digit
\D	[^0-9]	A non-digit
\s	[ \t\n\r\f]	A whitespace char
\S	[^ \t\n\r\f]	A non-whitespace char
\w	[a-zA-Z0-9_]	A 'word' char
\W	[^a-zA-Z0-9_]	A 'non-word' char

FAQs
How to register
My registration failed
My key lost
My old key doesn't work

How to register
Select Menu>Registration from the main window; check if the name you received from online shops or from us is exactly same as in the [Owner] field including cases (if necessary you can change Owner Name by selecting Menu>Modify Owner Name); enter the code you received into the [Code] field; select [OK].

My registration failed
Please use the default MS keyboard when typing; use the exact owner name, this field is case-sensitive; don't use any extra spaces inside the name; check if the owner name on your device is exactly the same as the one used in your order including the cases. Check if your code is for correct version of MagiCall, you may download the latest version from our website and regain your code. Send an email at our support if this doesn't help: support@mobiion.com.

My key lost
Visit our online "Resend Key Page" to regain your key: http://www.mobiion.com/resend.php

My old key doesn't work
We may sometimes change activation keys for newer versions. To get your latest key, visit our "Resend Key Page": http://www.mobiion.com/resend.php