Mobile profile emulation with Chroma from API

  • Created

We recommend that you read the Getting started with Kameleo Automation article before reading this one.

By default, when you create a mobile profile, you should use your mobile device to connect to the external spoofing engine. Automate browsing on the mobile device's browser is not supported yet, but you can set up Kameleo to start the mobile profile on your desktop. The profile will be launched (emulated) in our custom-built Chromium. You can launch these profiles from your code with the Local API and automate browsing with popular automation frameworks.

  1. First you need to filter for a Mobile Base Profile

    • const baseProfileList = await client.searchBaseProfiles({
        deviceType: 'mobile',
        osFamily: 'ios',
        browserProduct: 'safari',
        language: 'en-us',
    • var baseProfileList = await client.SearchBaseProfilesAsync(
    • base_profile_list = client.search_base_profiles(
  2. You need to set up our custom built chromium as a launcher, so the mobile profile will start on your desktop.

    • const createProfileRequest = BuilderForCreateProfile
      const profile = await client.createProfile({ body: createProfileRequest });
    • var createProfileRequest = BuilderForCreateProfile
      var profile = await client.CreateProfileAsync(createProfileRequest);
    • create_profile_request = BuilderForCreateProfile \
        .for_base_profile(base_profile_list[0].id) \
        .set_recommended_defaults() \
        .set_launcher('chromium') \
      profile = client.create_profile(body=create_profile_request)
  3. It is recommended to pass the following additionalOption when you start the profile. This allows you to click on elements using the cursor when emulating a touch screen in the brower. If you leave this out, your script may time out after clicks and fail.

    • await client.startProfileWithOptions(, {
        body: {
          additionalOptions: [
              key: 'disableTouchEmulation',
              value: true,
    • await client.StartProfileWithOptionsAsync(profile.Id, new WebDriverSettings()
        AdditionalOptions = new List<Preference>
          new Preference("disableTouchEmulation", true),
    • client.start_profile_with_options(, body={
        'additionalOptions': [
            'key': 'disableTouchEmulation',
            'value': True,

If you want to see the full example code, click any of the links below:

Was this article helpful?

2 out of 2 found this helpful