MagiCall Help

General Usage
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, tap [OK] or select Menu>Minimize.

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 New from the main window.

Create a new copy
Tap and hold the stylus to display the context menu. Select Add Copy... from the context menu.

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

Delete a rule
Tap and hold stylus to open the context menu. Select Delete from the context menu.

Move a rule
Select one rule, and then tap and hold stylus to open the context menu. Select Move Up, Move Down, Move To Top or Move To Bottom from the context menu.

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.

Rule Configuration
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}
{name}
{lastname}
{firstname}
{date}
{time}
{message}
{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}

{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

{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.

Filter
Rule name
Rule type
Filter type
Phone #
Category
SMS filter
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.

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.
Sender Name: Filters messages sent by specified senders. You may use ';' to separate names.
Meeting Recipient: Filters outlook contacts who are attendees of a present appointment.

Phone #
If you choose Specific 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.

Examples:
To block the entire area code 852, enter (852)* or (852)???-????.
To block any phone number containing 7, enter *7*.
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.

Outlook 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 on its right side.

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.

Enabled
You can enable or disable an individual rule by:
1. selecting or deselecting the [Enabled] checkbox from the Rule Configuration window
2. tapping the icon of each rule from the Rule List window
3. selecting Enabled from Context Menu of the Rule List window

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: Messages will not make sounds.
Move: Messages are moved to the folder specified in the [To folder] text box. (Use '\' to separate sub-folders)
Mark as read: Messages will be marked as read. There will be no system new message notifications.
Mark as read and move: Messages will be marked as read and moved to the specified folder. (Use '\' to separate sub-folders)
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 Service Codes. 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.

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. Selecting [Show tray icon] will display a notice tray icon on the Today screen. Selecting [Show notifications] will show a notification and display a mono icon on title bar. Selecting the [Log events] will record the event in the log file and notify you through Today/Home plugin.

Using Command Line

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

Valid Options:
-h	To start MagiCall and hide its main 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
-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

Sample:
MGC -h -pwd spdpwd -e "Block All" -d Spam "Some Others"

Options
General
Advanced
Security
Signature
Save & Cancel

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

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.

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 SMS filter.

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
\NNN	Octal code for character NNN

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

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. Contact our support center if this doesn't help: support@mobiion.com.

My key lost
Use our online "Resend Key Service" to regain your key: www.mobiion.com/resend.php