The Complete Reference Guide

Introduction: The Golden Rule

PaSS is an automation tool that intercepts outgoing calls before they connect. It checks the number you dialed against your list of rules.

The most important thing to remember is that PaSS reads your rules from top to bottom.

1. The first rule in your list that matches the call is the “winner”.
2. PaSS executes the actions for that rule only.
3. It then stops and ignores the rest of the list.

Therefore, order your rules from most specific (top) to most general (bottom).

Part 1: Creating a Rule (The Editor)

When you tap the + button on the main screen, you enter the rule editor.

The Empty Canvas

You start with an empty rule. A rule needs at least one Action to do something. Conditions are technically optional (a rule with no conditions applies to every call that reaches it), but you usually want to add them to target specific calls.

Choosing Building Blocks

You build a rule by tapping the + CONDITION and + ACTION buttons. This opens menus showing all available options.

The Conditions Menu

Tapping + CONDITION shows the "IF" options.

We will explain each of these in Part 2.

The Actions Menu

Tapping + ACTION shows the "THEN" options.

We will explain each of these in Part 3.

Part 2: The Building Blocks - Conditions (IF…)

A rule only runs if the call meets ALL the conditions you add to that rule. It is an “AND” logic (Condition A AND Condition B must be true).

1. Number Pattern

Targets the actual digits you dialed.

• Starts with: Useful for targeting country codes (e.g., `+49`), mobile prefixes (e.g., `06`), or special codes you define yourself to trigger a rule (e.g., `*1*`).
• Contains: Looks for a sequence anywhere in the number. Useful if you use a personal code like `###` in the middle of a number to trigger a rule.

2. Contact Account

Targets where the contact is saved on your phone (e.g., Google Account A, Google Account B, Phone Storage, Exchange).

• Include (Switch ON): The rule ONLY applies to contacts saved in the selected accounts.
• Exclude (Switch OFF): The rule applies to everyone EXCEPT contacts in the selected accounts. This is the best way to target "all non-work contacts".

Tip: If you check (Select All), it means *every* account (even ones added later) is included. If you check specific accounts, only those are monitored.

3. Contact Group / Label

Targets specific labels you have applied to contacts in your address book (e.g., "Family", "VIP", "Colleagues").

• Like Accounts, you can set this to **Include** or **Exclude** selected groups.

Tip: Just like accounts, (Select All) means all current and future groups are included.

4. Days of the Week

Makes a rule active only on specific days.

• Select the days you want the rule to be active (e.g., Monday-Friday for work rules).
• If no days are selected, the condition is ignored and the rule runs every day.

5. Time of Day

Makes a rule active only during a specific time window.

• Set a **Start time** and an **End time**.
• Useful for work-hour restrictions (e.g., active only between 09:00 and 17:30).

Part 3: The Building Blocks - Actions (THEN…)

If a rule matches, PaSS executes the actions from top to bottom. You can drag them to reorder. You only need to add the actions you want. Single SIM users can skip the SIM action entirely.

1. Choose SIM (Optional)

For Dual SIM users only. Determines which SIM card places the call.

• Specific SIM: Force the call to go through SIM 1 (e.g., "Work") or SIM 2 (e.g., "Personal").
• Ask every time: PaSS will pop up a selection dialog before the call connects.
• Use last used SIM: Checks your **call history** to see which SIM you used last for this specific number.

2. Add Prefix / Suffix

Adds characters to the number. Essential for both Single and Dual SIM users.

• Prefix (Before): Adds text to the *start* of the number. E.g., add `#31#` to hide your caller ID, or add a country code like `+49`.
• Suffix (After): Adds text to the *end* of the number. Sometimes used for calling card systems or entering pauses (`,`).

3. Remove Characters

Strips digits from the start or end of the number before dialing.

• Useful if you use "trigger codes". For example, if a rule triggers on numbers starting with `*1*` (to route to SIM 1), you must use this action to **remove the first 3 characters** so the phone dials the actual number, not the code.

4. Replace Characters

Finds a sequence in the number and replaces it with something else.

• Example: Find `+` and replace with `00` for international dialing compatibility.
• Example: Find a custom code like `###` and replace it with an anonymous prefix like `#31#`.

Tip: If you leave the 'Replace with' field empty, the found sequence will be deleted (replaced with nothing).

5. Show Notification

Provides visual feedback that a rule is active just before the call connects.

• Color overlay: A subtle colored bar at the top of the call screen (e.g., Red for Work, Blue for Personal).
• Toast: A standard, small text pop-up at the bottom of the screen.

Customization & Variables:

You can choose the position (Top, Middle, Bottom) and text size. The message supports basic HTML formatting (like `bold` or `
` for line breaks) and the following variables:

• `{rule}`: The name of the current rule.
• `{originalNumber}`: The number exactly as you dialed it.
• `{dialedNumber}`: The final number after modifications.
• `{sim}`: The name of the chosen SIM card.
• `{contactname}`: The full name of the contact (if found).

Part 4: Real-World Examples

How to combine the blocks to solve problems.

Example 1: Controlling Caller ID (Anonymity)

This is the most common use case for Single SIM users. You can either hide your number for specific calls or show it only to trusted contacts.

Scenario A: Default is “Show ID” -> Hide for specific people

Prerequisite: Your phone settings are set to show your number by default for everyone. Goal: You want calls to anyone in your “Patients” group to be anonymous.

• IF Contact Group is “Patients” (Include).
• THEN Add Prefix: #31# (or region equivalent like *67).
• THEN Show Notification (Toast: “Hiding ID”).

Scenario B: Default is “Hide ID” -> Show to trusted contacts

Prerequisite: Your Android call settings are set to hide your number by default for everyone. (See our settings guide). Goal: You want your “Family” or “Colleagues” group to see who is calling, but remain anonymous for everyone else.

• IF Contact Group is “Family” (Include).
• THEN Add Prefix: *31# (or region equivalent like *82).
• THEN Show Notification (Toast: “Showing ID”).

Example 2: Dual SIM - Basic Work/Private Split

Goal: You have a “Work” SIM and a “Personal” SIM. You have separated your contacts into a Work account (e.g., Exchange) and a Personal account (e.g., Gmail).

Rule A (Top of list): Work Contacts

• IF Contact Account is “Work” (Include).
• THEN Choose SIM: “Work”.
• THEN Show Notification (Color: Red).

Rule B (Bottom of list): Everything Else

• (No conditions added - this acts as a general catch-all rule).
• THEN Choose SIM: “Personal”.
• THEN Show Notification (Color: Blue).

Example 3: Complex Scenario (Work Hours)

Goal: During work hours (Mon-Fri, 9-5), any call to a number that is NOT in your contacts should be dialed anonymously AND use the work SIM.

• IF Day is Mon, Tue, Wed, Thu, Fri.
• IF Time is between 09:00 and 17:00.
• IF Contact Account is “All Accounts” set to Exclude (meaning: it’s not a known contact).
• THEN Add Prefix: #31# (to hide number - note: use *67 in North America).
• THEN Choose SIM: “Work”.

Example 4: The Ultimate “Pro” Setup (Stacking Rules)

This example shows how the “top-to-bottom” rule order allows you to build powerful workflows.

Goal:

1. Personal contacts always go via Personal SIM.
2. Work contacts always go via Work SIM, and your number must be visible.
3. Any other call during work hours goes via Work SIM, but anonymously.

How to set it up (Order is crucial!):

1. Personal Contacts

2. Work Contacts

3. Work Hours Unknown