Setting up

Step by step guides on how to set up and activate the bot

Activation

Activating the bot is a straight-forward process. Firstly, head over to the settings.json file located in the EarthSideIO folder and fill in the required information. A template can be seen below, and will also be in your folder once you download & start the bot. In case you rather want to edit your settings in bot, you can of course also do that.

Here we have a template of what the settings.json file should look like once your information has been properly entered.

{
   "license":"YOUR LICENSE HERE",
   "config":{
      "webhook":"YOUR DISCORD WEBHOOK HERE",
      "notifications":true, // If you want the bot to send system notifications
      "disallow_public_logging":false, // If you want your checkouts to be hidden in public webhook
      "captchaProviders":{
         "capmonster":{
            "apiKey":"YOUR CAPMONSTER KEY HERE"
         },
         "2captcha":{
            "apiKey":"YOUR 2CAPTCHA KEY HERE"
         },
         "anticaptcha":{
            "apiKey":"YOUR ANTICAPTCHA KEY HERE"
         },
         "aycd":{
            "apiKey":"YOUR AYCD API KEY HERE"
         },
         "captchaai":{
            "apiKey":"YOUR CAPTCHAAI KEY HERE"
         }
      },
      "captchaServices":{ //Here you can select what captcha provider you want to use for every site.
         "asos":"", // Input examples: capmonster, 2captcha, anticaptcha, aycd, captchaai
         "awlab":"",
         "courir":"",
         "footasylum":"",
         "footlocker":"",
         "galerieslafayette":"",
         "mesh":"",
         "offspring":"",
         "office":"",
         "panagora":"",
      },
      "mesh_express":false // Use Mesh express shipping method
   }
}

If you manually edit your settings file, make sure to copy and paste your file here and then save the output in your settings, to correct and format issues. Once your information has been properly entered and saved, we can now look at the next chapter below.

Profiles

After installing EarthSideIO.exe and setting up all the required tools mentioned here, you should now start to prepare your profiles. In the EarthSideIO directory on your desktop, you can find a file called Profiles.csv. This is where you enter all your profiles.

Catchall

You can use your catchall for all of our sites. Just input random@YOURCATCHALL in the email column.

Randomize feature

The bot gives you the possibility to use random data on the First Name, Last Name, and Phone Number fields. In order to use it, input random or RANDOM in one of those fields.

Webhook per profile

The last column of the profiles webhook is named Webhook. This allows you to set different webhooks depending on the profile you're running. Leave this field empty if you wish to use the webhook in your settings.json.

Jigging feature

The bot gives you the posibility to automatically Jig some of your info in your profiles. The fields that support this feature are:

  • First Name

  • Last Name

  • Address 1

  • Address 2

In order to use this feature, add XXX before or after the info you wish to j1g. This will add 3 random letters replacing the XXX. For example, if you input Earthside Street XXX in your Address 1 field, the bot will convert it to Earthside Street ABT.

State

For sites such as Awlab, MrPorter, Net-A-Porter and Mesh it's required to fill in the state column of your profile. To figure out what to insert there, read it up on the guides for those websites in Supported Websites. Make sure to check if the site you want to run requires it, as otherwise it will result in shipping errors.

Different Shipping/Billing

With the latest update, you can now also use a different shipping and billing address. This requires you to download this adjusted profiles.csv. This option currently works for:

  • Asos (can cause cancels)

  • AW-Lab

  • Courir

  • Footlocker

  • Mesh

  • Zalando

You can still use the different shipping/billing profiles.csv for other sites by leaving billing empty.

Tasks

EarthsideIO manages tasks by having them placed in respective folders for every site.

In order to create tasks, you will have to open up the folder called EarthSideIO which should be placed on your desktop. Within that directory, you will spot multiple folders which are named like each site we do support (f.e. Asos, Offspring, Snipes etc.).

In order to create tasks for a specific site, you should open the folder which is named like the site. For example to create tasks for Offspring, you should open the Offspring folder. In there you will find an empty Offspring_Taskscsv file. By opening it, you can see all the necessary fields in order to run that site.

For guides on how to setup your tasks.csv for every site, click here.

You can create multiple tasks csv and name it however you wish for better reference, as long as they are placed inside the site folder. The bot will ask you what csv you whish to run when starting tasks.

Proxies

Next to security, the second reason many people use proxies is privacy. As a proxy shares its IP address instead of your own, it allows you to remain anonymous when using the internet. Another key reason to use proxies is the added speed they can provide to your network.

Proxies are required for EVERY website that we support and this is one of the most important tool of them all. Proxies are required when running tasks as they prevent you from getting banned on the specific website you are running on due to the constant requests made to the website at very low delays. In order to add proxies to the bot, open up the Proxies folder in the EarthSideIO directory. Now you can either create a new proxy list by creating a new .txt file in which you can insert your proxies or you insert them into the proxies.txt file which should already be there.

So that the bot knows which proxy list you want to be used for each of your tasks enter the proxy list name (file name) without the .txt at the end in the Proxies column in your tasks file.

You can update proxy files while running and the bot will automatically switch them after saving the .txt file.

We also have our own partnered proxy provider that offers fantastic proxy speeds at superb prices for all EarthSide users.

Instances

Similar to other CLI bots, EarthSideIO offers you to open up multiple terminal windows per key on the same device. This means you can open multiple instances to start multiple tasks.csv files or to run f.e. multiple regions splitted between instances. The max number of instances is currently set to 6 instances per key. All task limits are fixed per instance. So if the task limit is set to 200, you are allowed to open 6 instances with a max of 200 tasks each.

Last updated