Skip to main content

Clone App Support

TikMatrix and IgMatrix support running multiple clone apps (such as GB TikTok, GB Instagram, Instagram Plus, or other modified versions) on the same device, each with its own package name. This feature enables you to manage multiple accounts more efficiently by using different app instances.

Risk Warning

Using clone apps may violate TikTok/Instagram's Terms of Service and could result in account suspension or ban. We only provide technical support for this feature and are NOT responsible for any account-related issues, including bans, suspensions, or restrictions caused by using clone apps. Use at your own risk.

What is a Package Name?​

Every Android app has a unique identifier called a package name. The official apps use standard package names:

  • TikTok (Global): com.zhiliaoapp.musically
  • TikTok (Asia): com.ss.android.ugc.trill
  • Instagram: com.instagram.android

Clone apps use different package names. For example:

  • com.zhiliaoapp.musically.gb (a TikTok clone)
  • com.instagram.gb.android (an Instagram clone)
  • com.instagram.android.1 (created by App Cloner or NomixCloner)

TikMatrix/IgMatrix provides three complementary methods to configure which clone apps to use.

Set a specific package name for each individual account. This is the most precise control.

Step 1: Install Clone Apps​

  1. Install your preferred clone app(s) on your device or CloudPhone.
  2. Make sure each clone app has a unique package name to avoid conflicts.
  3. Log in to different accounts in each app instance.

Step 2: Set the Package Name in Account Settings​

  1. Open Accounts in the left navigation.
  2. Click on an account to edit it, or click Add to create a new one.
  3. In the Package Name field, you can:
    • Manually enter the clone app's package name (e.g., com.instagram.android.1)
    • Auto-detect by clicking the Detect button (requires device selection first)
  4. Click Save.

When you run any automation script for this account, TikMatrix/IgMatrix will automatically use the configured package name.

Auto-Detect Package Name

The Detect button automatically detects which app is currently in the foreground on the selected device. Under the hood it runs:

adb shell dumpsys activity activities | grep ResumedActivity

To use it:

  1. Select a device for the account
  2. Open the clone app on that device
  3. Click the Detect button
  4. The package name will be automatically filled in

This works with any Android app — TikTok/Instagram clones, App Cloner, NomixCloner, and more.

Method 2: Instagram Clone Packages in the Open App Dropdown​

The Open App button in the toolbar includes a quick-launch list for Instagram clone packages. This lets you open or stop any clone app directly from the toolbar without navigating to account settings.

Adding an Instagram Clone Package​

  1. Click the Open App button in the toolbar.
  2. In the Instagram section of the dropdown, click + Add Clone Package.
  3. Enter the full package name of the clone app (e.g., com.instagram.android.1).
  4. Press Enter or click ✓ to confirm.

The package is saved locally and will appear in both the Open App and Stop App dropdowns.

Removing an Instagram Clone Package​

Click the × button next to any clone package in the dropdown to remove it from the list.

When configuring scheduled tasks or running scripts on a device group, the App Package Selection section lets you specify which app packages the automation engine targets — including both official packages and clone apps via a prefix filter.

This section appears in:

  • Post Settings for a group
  • Account Warmup Settings for a group
  • The Run Script dialog (before manually running any script)

Official Packages​

Check the boxes for the official package(s) you want to include:

AppPackageCheckbox Label
TikTokcom.zhiliaoapp.musicallyTikTok Global
TikTokcom.ss.android.ugc.trillTikTok Asia
Instagramcom.instagram.androidInstagram

Clone App Package Prefix​

Enter the common prefix of your clone apps. The automation engine will automatically discover all installed apps whose package names start with this prefix.

  • TikTok example: com.tiktok.clone. — matches com.tiktok.clone.1, com.tiktok.clone.2, etc.
  • Instagram example: com.instagram.android. — matches com.instagram.android.1, com.instagram.android.2, etc.
Multi-Account Limitation

When you enable the Clone App Package Prefix, the multi-account feature is disabled for that group task. The automation engine uses runtime package discovery instead of the fixed account-to-package mapping required for multi-account switching.

If you need both multi-account support and clone apps, use Method 1 to set individual package names per account.

How It Works​

When running any automation script, TikMatrix/IgMatrix resolves the target package name using this priority order:

  1. Account-level package name — if the account has a Package Name set, it is used.
  2. Clone prefix discovery — if a Clone App Package Prefix is configured for the group/task, all installed packages matching the prefix are collected and used.
  3. Official packages — checked official packages in the group settings are included.
  4. Built-in default — falls back to the platform default (com.zhiliaoapp.musically for TikTok, com.instagram.android for Instagram).

All resource IDs and XPath selectors are automatically formatted with the resolved package name.

Supported Scripts​

The following scripts fully support dynamic package names:

TikMatrix Scripts:

  • Login
  • Profile Editing
  • Post Creation
  • Account Warmup
  • Mass DM
  • Super Marketing
  • All other automation features

IgMatrix Scripts:

  • Login
  • Profile Editing
  • Post Creation
  • Account Warmup
  • Super Marketing
  • Boost Posts
  • Mass DM
  • Match Accounts
  • All other automation features

Best Practices​

1. Choose the Right Method for Your Scale​

ScaleRecommended Method
A few accounts with different clone appsMethod 1 (account-level)
Many accounts, all using the same clone app seriesMethod 3 (clone prefix)
Quick manual launch / testingMethod 2 (Open App dropdown)

2. Use Descriptive Usernames​

When managing accounts across multiple clone apps, include the app type in the username:

username_clone1  → clone app instance 1
username_clone2  → clone app instance 2
username         → official app

3. Organize Accounts by Groups​

Create separate device groups based on the clone app in use:

  • Group A: Accounts using the official app
  • Group B: Accounts using clone series A (e.g., prefix com.tiktok.clone.)
  • Group C: Accounts using clone series B

4. Test Before Bulk Operations​

Before running scripts on all accounts:

  1. Test with a single account first
  2. Use the Detect button to verify the correct app is detected
  3. Confirm all operations work as expected

5. Keep Package Names Consistent​

Once you set a package name for an account, don't change it unless you switch to a different clone app. Consistency avoids confusion and errors.

Troubleshooting​

Script Opens Wrong App​

Problem: The script opens the wrong app instead of the clone app.

Solution:

  1. Check the account's Package Name field in account settings
  2. Verify the clone app is installed and the package name matches
  3. Use the Detect button to re-detect the correct package name
  4. Restart the device if the app was recently installed

Can't Find UI Elements​

Problem: Script reports "element not found" errors.

Solution:

  1. Different clone apps may have slightly different UI layouts
  2. Check if the clone app version is compatible
  3. Try updating to the latest version of TikMatrix/IgMatrix
  4. Contact support if the issue persists

Multiple Accounts in Same App​

Problem: Want to switch between multiple accounts in the same app instance.

Solution:

  • TikTok/Instagram supports multiple logged-in accounts natively
  • Use the Switch Account feature in TikMatrix/IgMatrix
  • Set the same package name for all accounts in that app instance
  • TikMatrix/IgMatrix will handle account switching automatically
warning

Multi-account switching is not supported when using the Clone App Package Prefix in group settings. Use Method 1 (account-level package names) instead.

Detect Button Not Working​

Problem: The Detect button doesn't work or shows an error.

Solution:

  1. Make sure you have selected a device for the account first
  2. Ensure the clone app is currently open (in the foreground) on the device
  3. Check the device connection is stable
  4. Try re-opening the app and clicking Detect again

Clone Prefix Finds No Apps​

Problem: The clone prefix is set but no clone apps are discovered at runtime.

Solution:

  1. Verify that clone apps are actually installed on the device
  2. Double-check the prefix — it must match the beginning of the package name exactly (e.g., com.instagram.android., not com.instagram)
  3. Use adb shell pm list packages | grep <prefix> to confirm installed packages
  4. Make sure the prefix ends with a . to avoid unintended matches

Finding Package Names​

Using ADB Command​

# List all TikTok-related packages
adb shell pm list packages | grep musically

# List all TikTok Asia packages
adb shell pm list packages | grep trill

# List all Instagram-related packages
adb shell pm list packages | grep instagram

Using the Auto-Detect Feature​

The easiest way is to use the built-in Detect button in the account edit dialog:

  1. Open the account edit dialog
  2. Select the device
  3. Open the clone app on the device
  4. Click Detect
  5. The package name is automatically detected and filled in

This works for any Android app and is the recommended approach.

FAQ​

Q: Can I use multiple clone apps on the same device?

A: Yes. As long as each clone app has a unique package name, you can run multiple app instances on the same device and assign each to different accounts.

Q: Do I need to reinstall TikMatrix/IgMatrix?

A: No. Clone app support is built into the latest version. Just update and configure package names.

Q: Will my existing automation scripts still work?

A: Yes. All existing scripts are fully compatible. Accounts without a custom package name will continue using the default package.

Q: Does this work for both TikTok and Instagram?

A: Yes. Both TikMatrix and IgMatrix fully support clone app detection and automation.

Q: How does the auto-detect feature work?

A: When you click Detect, TikMatrix/IgMatrix runs adb shell dumpsys activity activities | grep ResumedActivity on the selected device to find the currently active app and reads its package name automatically.

Q: Can I use apps created by App Cloner or NomixCloner?

A: Yes. The package name feature works with any Android app cloning tool. Use the Detect button or enter the package name manually after checking with adb shell pm list packages.

Q: Why is multi-account disabled when I use the Clone Prefix?

A: The clone prefix feature uses runtime package discovery, which dynamically assigns packages to devices. This is incompatible with the fixed account-to-package mapping required for multi-account switching. Use Method 1 (account-level package names) if you need multi-account support with clone apps.