BlackHatToolz.com Bot User Guide

This guide is an introduction to the basic & advanced usage of the bots on BlackHatToolz.com. This will display

information on how to get your accounts setup within the bots & using each of the features.

Note that to truly understand what actions the bot is performing you should have a good understanding of the

website that the bot works with before attempting to use the program(s) at all.

This user guide uses Twitter Bot as an example program as it is currently the most advanced bot on BHT & all

other BHT programs are similar when performing actions.

PC Requirements

BHT Bots require that you have Microsoft .NET Framework 4.0 Client Profile installed onto your machine. This

is installed automatically onto machines that have Windows Update enabled or can be installed separately

here: https://www.microsoft.com/en-gb/download/details.aspx?id=17113

For any “Unable To Manage Processed Resources” messages please re-install the program using the BHT

Installer file located here: http://www.blackhattoolz.com/members/showthread.php?1427

General Proxy Information

BHT bots that support proxies support HTTP proxies only. Your proxies can be public proxies, private proxies, IP

authenticated proxies, user/pass authenticated or those that require no authentication at all.

In order to use IP authenticated proxies you should first login to the website where you have purchased your

proxies from & locate the IP Access page & enter the IP address of your machine (http://whatsmyip.org/)

You can find a list of recommended proxy providers for our bots here:

http://www.blackhattoolz.com/proxies.php

When running multiple accounts on the same website proxies are essential. We recommend running no more

than 5 accounts per single proxy & an ideal number of accounts to run per proxy would be 1-3.

When creating accounts on websites you should also not create more than 1 account per day per IP & if your

proxies are in the same subnet (192.168.0.1, 192.168.0.2, 192.168.0.3) you should also not run multiple

threads to prevent detection from the site that you are botting.

When loading proxies into BHT bots they should be loaded from a text file, 1 proxy per line in any of the

following formats:

Proxy:Port

Proxy:Port:ProxyUsername:ProxyPassword

Example

127.0.0.1:8888

127.0.0.1:8888:Username:Password

Proxy username & password must be provided when using user authenticated proxies. They are not required

when using public proxies / no authentication proxies or IP authenticated proxies.

General Email Accounts Information

Many bots on BHT support automatic email verification. Where this is supported your email accounts must

also have POP3 access enabled in order to use them with the bot(s).

Supported email providers for BHT bots are: Hotmail, Yahoo, Gmail, AOL, GMX, ChewieMail, Mail.ru, Mail.com.

Email accounts can be purchased from: https://buyaccs.com/ - http://247accs.com/

You can create your own Yahoo accounts using our Yahoo account creator here:

http://www.blackhattoolz.com/members/showthread.php?1458-Yahoo-Account-Creator-Phone-Verifier

General Multi-Threading Information

Multi-threading is the ability for a program to run multiple actions at the same time. In the case of BHT bots

this means running multiple accounts at the same time, for example, if you were to run the Follower Module &

select Threads To Run: 5 then the program will process 5 of your accounts at the same time & once it has

completed any of these accounts that ‘thread’ will move onto the next account in the system to process.

Multi-Threading does use more CPU & memory on your machine so be aware that your machine may not be

powerful enough to run a high number of threads, this is shown by an unresponsive program / very slow

responsiveness & a sign that you should reduce the number of threads that you are running.

Spintax Information

Spintax is supported in all fields that offer this feature; you will see this by the directions above the text box

(Spintax Supported / Tokenizable will be shown).

Spintax allows you to create unique messages / text so that not all of your accounts promote exactly the same

content.

An example spintax text:

{Hi|Hey|Hello|Howdy} {Friend|Follower|Buddy}

The above example would then randomly output any of the following texts:

Hi Friend / Hi Follower / Hi Buddy

Hey Friend / Hey Follower / Hey Buddy

Hello Friend / Hello Follower / Hello Buddy

Howdy Friend / Howdy Follower / Howdy Buddy

In this example there are 12 potential different unique messages from a simple 7 word spintax string.

Troubleshooting

All BHT programs have many detections & learning systems in place that find potential errors & report these to

you via the process log at the bottom of each of the programs. Occasionally the websites that our bots work

with can change their responses / ways in which actions are sent. In these cases our bots may not be able to

function correctly & require human input to update these for the changes made to the sites. Other issues that

may occur are site issues, proxy issues & user input errors. Below are some of the potential issues that you

may encounter using our bots & an explanation of each:

“Can't process managed resources” – If you see this error either the .dll file that was distributed with the .exe

has been moved or the packed exe has been downloaded onto a machine that does not support this runtime

method. To resolve this issue download the BHT Installer & re-install the program onto your machine.

“Unknown Issue” – This issue means that the program did not understand the response from the website / a

response other than what was expected has been returned. When this error is shown an error log file is

automatically generated inside of the /datastore/error_logs/ folder in the same directory where the EXE is

placed on your PC. To resolve this issue send an email with all of the log files inside of this folder to

admin@blackhattoolz.com with a note of which bot you encountered this issue with & our support will get

back to you as soon as possible with a new release or resolution to the issue.

“The connection timed out” – This error means that the program attempted to load a URL & upon doing so the

response time was longer than your settings set on the settings panel on the Max Timeout setting. This can

occur due to your own bandwidth being throttled (Too many downloads at once for example), the proxy server

having this same issue, or the site that the bot works with having this issue or currently undergoing updates. If

you are continually seeing this error with specific accounts check the proxy that the account uses & if the

proxy is working ok on other websites it is still possible that the proxy has been banned from the website that

the bot works with.

“The remote server returned an error: (403)” – This is a HTTP connection error. This error usually occurs when

the proxy that the program is attempting to use has denied access to your IP address / user credentials,

potentially due to your IP changing on IP authenticated proxies, an expired proxy subscription or incorrect

proxy login information. Other times when this error may occur is when the website that the bot works with

has denied access to the IP / proxy in use.

“400 Bad Request” / “500 Internal Server Error” – This error is shown when the program attempts to send

malformed data to the server. This error often occurs due to an incorrect input from the user, sometimes due

to including spaces in a username or password or characters that the website does not accept for the field that

the program is attempting to use.

“407 Proxy Authentication Required” – This error is created from the proxy server of the proxy that the

program is attempting to use. Make sure to login to your proxy service, confirm a valid subscription, update

your authentication IP & confirm the login information is correct. Sometimes when purchasing proxies it can

take some hours for them to become ‘live’.

Account Management / Account Manager

The account manager is where you can load your accounts & proxies into each program that will be used to

perform actions on the website that the bot works with.

You can add account(s) to the program individually by entering the required information into the above form.

It is essential that you provide the correct data that the program asks for, in this example a Twitter Username,

whereas some bots may request for an email address. Some websites, E.g. Pinterest, only allow login using an

email address so by providing incorrect data into the bot it will not be able to login to your account(s).

Any fields with (Optional) can be left blank, or with the current text inside of it, E.g. Port (Optional).

Once you have entered your account information into the form click the Add Account button & you will see

your account added to the Account Manager view as seen below.

Within the account manager you can check accounts individually & select the “Remove Selected Account”

button to completely remove the account from the system, or you can perform mass actions using the buttons

to the site of the form:

Remove All Accounts – This will completely remove all account(s) from the system.

Remove All Proxies – This will remove all proxies from the ‘Proxy Pool’ (More information below).

Export Disabled Accounts – This will provide you with account(s) that have been found as disabled while the

bot has been performing actions on your account(s). This will export nothing if the program has not yet

performed any actions on your account(s).

Remove Disabled Accounts – This will remove any account(s) found as disabled from the system.

You can import accounts / proxies in bulk to the system by using the Load Accounts / Proxies feature.

Accounts & Proxies should be loaded into the system from a text file, 1 account/proxy per line in the format

displayed upon clicking Load Accounts / Load Proxies, E.g. Once clicking Load Accounts in Twitter Bot you will

be prompted with the load format:

An example of a complete load format would be:

BlackHatToolzCo:Password:127.0.0.1:8888:ProxyUsername:ProxyPassword:email@email.com:07841242366

Any fields that you do not require information for can be left as 0 (zero). The only 100% required fields are the

account’s username & password. An example of skipping some data is shown below:

BlackHatToolzCo:Password:127.0.0.1:8888:0:0:email@email.com:0

In the above example the Proxy Username, Proxy Password & Phone Number were skipped.

Accounts & Proxies

When loading account(s) into the system, either via the individual form or via text file you can choose to add a

proxy to the account, E.g.

BlackHatToolzCo:Password:127.0.0.1:8888

When loading accounts with proxies this ties the account to that proxy, so the account will always be locked to

that proxy for any process that is run with the bot. Should you ever change your proxies you will need to

remove the account from the system & re-add the account with its new proxy.

If account(s) are loaded without any proxy then by default they will use your own IP address of the machine

that you are running the program from UNLESS you use the Load Proxies feature, continued below.

The Load Proxies feature allows you to load proxies into the program that will be used for any process where

there is not already a proxy linked to an account. So for example, if you load 10 accounts into the program, 5

with proxies & 5 without then the 5 accounts without proxies attached to them will by default use your own

PC’s IP address. BUT if you also loaded proxies into the program via Load Proxies then one of these proxies in

the ‘proxy pool’ will be used at random each time an action is performed on an account without a proxy.

Be aware that when using the Load Proxies feature & importing accounts without proxies linked to them a

proxy will be chosen at random each time an account is selected to perform an action. So your accounts will be

using a different proxy each time it is used. It is far safer to link proxies to accounts when importing accounts.

You can see if proxies are loaded into the bot just below the account management area:

To remove the proxies loaded from the program use the “Remove All Proxies” button located on the right

hand side of the Account Management tab.

Account Checker

The account checker allows you to run a scan across all of your accounts to check whether they are

active/disabled, if the proxy on the account is having issues & if an account has other issues, E.g. Temporarily

Suspended / Phone Verification Required / Other potential account issues.

Each BHT bot is different depending on the way in which it interacts with the website but the majority of our

releases allow you to select a mode to check accounts with:

Check By Logging In – This option will login to each of your accounts to check their status. This feature along

with all other features will use the proxy that is tied to the account, a proxy from the proxy pool if there is no

proxy attached to the account but proxies loaded in the pool, or no proxy (your own PC’s IP) if there is no

proxy tied to the account & also no proxies loaded into the proxy pool.

Check By Profile Page – Providing you have loaded accounts with the appropriate data (username rather than

email address or username / user ID where required) the bot will use your own IP address to load up each of

your account profiles to see if they are still available or if they are suspended. This mode does not login to any

of your accounts & is less of a risk to your accounts if you are not using proxies.

You can also load accounts into the bot from a text file to check rather than accounts that are already loaded

into the account management area. To do this simply select the “Accounts From File” option & upon clicking

the Start Process button you will be prompted to load your accounts to check. The format in which these

accounts should be loaded is shown below the form:

See the Account Management area to understand exactly how to format this data.

After selecting a number of threads to run & clicking the Start Process button you will see the counts update

instantly as each account is processed. Await the process to complete & the process log to report that the

current process has completed or the thread count to reach 0 before exporting accounts or you will only be

exporting the accounts that have been processed by the threads so far compared to all of your accounts

loaded into the system.

Upon completion of the process you can then export your accounts using any of the buttons available. Each

button will export its own set of accounts:

Export Active Accounts – These are active / good accounts that are ready to use.

Export Disabled Accounts – These accounts are banned from the site or potentially have been provided with

incorrect login information.

Export Suspended Accounts – This is different for each site / some sites ban accounts completely, whereas in

Twitter’s case they can also temporarily suspend account pending E.g. Further verification.

Export PVA Locked Accounts – These accounts are phone verified locked / when the bot attempted to login to

the account it was prompted to phone verify the account before it is able to perform any actions.

Export Proxy Issue Accounts – This is an option available in some releases where the account had issues

connecting to the site that the bot works with, E.g. Twitter. In this case the bot is unable to check if the

account is active so the account is loaded into this section where you can potentially export the accounts,

update their proxy information & re-import the accounts via the Account Manager.

Account Creator

The account creator module in each of the BHT bots allows you to automatically create accounts on the

website that the bot works with using the information that you provide. Where email verification / SMS

verification is required / optional our bots support automatic verification using POP3 enabled email addresses

& third party SMS API’s, E.g. http://www.smspva.com/

To use the account creator you must enter all required variables into the program in order for the program to

know what data to use while creating accounts:

Each program requires different data & the data required is shown above the text area. In this case, for

Twitter, the program requires you to enter a username, first name & last name for each account that you wish

to create & optionally additional proxy information.

The format required in this example is:

Username:FirstName:LastName:ProxyInfo

For example, an account without proxy information:

MyAccount101:Joe:Bloggs

An account with proxy information:

MyAccount101:Joe:Bloggs:127.0.0.1:8888

An account with proxy information that requires username / password authentication:

MyAccount101:Joe:Bloggs:127.0.0.1:8888:MyProxyUsername:MyProxyPassword

When you provide proxy information with an account that proxy will be used to create that account. If you do

not enter proxies into this area then the program will use proxies from the ‘Proxy Pool’ (See Accounts &

Proxies for more information on the Proxy Pool). If you do not have proxies loaded into the proxy pool & also

do not provide proxy information with the account information then the bot will use your own IP address to

register each account.

Once you have entered your username / user data information there is another field where you can enter

email address data to register accounts with, this field is also required:

Email information should be entered in the format of:

EmailAddress:EmailPassword

For example:

email@email.com:EmailPassword

In order for the program to automatically email verify your accounts the email account MUST be POP3

enabled. Should the emails for the website that the bot uses go to the spam/junk box then your email

accounts should also be spam filter disabled as POP3 cannot access this junk inbox.

Supported email providers for BHT bots are: Hotmail, Yahoo, Gmail, AOL, GMX, ChewieMail, Mail.ru, Mail.com

If you do not provide a password with the email accounts that you load into the program then email

verification will be skipped while creating accounts.

The account creator as seen above offers additional options that are customisable during account creation:

“Delay Between Creating Accounts” – This is the time that the bot will wait for on each thread before creating

the next account. If you are running more than 1 thread then the multiple threads will run simultaneously &

then each sleep / wait for X seconds that you enter into this field before creating the next account.

“Max Accounts To Create” – This is simply the maximum number of accounts that you want the program to

create each time you press the Start Process button.

“Rotate Email Account Upon Registration Failure” – This option allows you to link usernames / name

information to the email accounts that you load into the account creator. So each username / name

information will be selected 1 by 1 along with the email accounts that you load. Should an issue occur during

registration, E.g. Username already taken, then the program will skip that email address & move onto the next

one. If left unchecked the program will attempt to re-use the same email account that it selected for the

previous account that failed to create with the next account that it attempts to create.

“Verify Emails Only” – This option is available only where login is not required to email verify accounts.

Websites that do require login during email verification are supported in other BHT bots via the “Email

Verifier” tab where you can load full login information for the accounts that you wish to email verify. To use

this feature you only need to load email accounts with their passwords into the Email Addresses field, select

the number of threads that you wish to run & click Start Process.

Once all required data has been entered you can then select the number of threads to run & click the Start

Process button. See “General Multi-Threading Information” for more information on how multi-threading

works within BHT bots.

Clicking the Stop Process button will completely stop the process. Each thread will complete its current action

& the bot will not continue to create more accounts once each thread has closed.

Clicking the Pause Process button will halt all threads until the Resume Process button has been clicked which

is only shown after this button has been clicked.

As the program runs you will see the counts increase as the threads start / stop & as accounts are created.

Using any of the Export buttons before all threads are closed will provide you with incomplete data as

accounts are only added to these lists as they are created.

“Export Unused Email Addresses” – This button allows you to export all email addresses that were not used by

the program & that were not found as already in use. If the bot has not yet processed all email addresses then

there is still potential for bad email addresses to be in this list.

“Export Unused Names” – This button allows you to export all usernames / name data that were not used by

the program & that were not found as already in use. If the bot has not yet processed all of this data then

there is still potential for bad data to be in this list.

“Export Created Accounts” – This button will export all accounts that have been created by the bot for this run

only (Since the Start Process button was clicked). You can also find a complete list of all programs ever created

by the bot inside of the /datastore/ CreatedAccountsBackup.txt file where the .exe is located.

“Export User:Pass Format” – This option will export all accounts created this run in Username:Password

format, ignoring any proxy information & additional information such as the email address used to register the

account & the email password.

“Export Verified Accounts” – Some websites, in this case Twitter, require additional verification during

registration, E.g. Email / SMS verification. Using this button the program will only export the accounts that are

fully verified as per the site’s requirements.

“Export Unverified Accounts” – This option will export all created accounts for this run that have not been

verified for any reason, E.g. Email address password not provided / SMS verification disabled or failed.

Important Account Creator Notes:

Account creation must be done in a controlled manor. Creating multiple accounts using the same IP address /

proxies in a short space of time will likely get all of your accounts created banned/disabled/suspended in one

hit. You should use many different IP’s / proxies during account creation to remain anonymous when creating

multiple accounts on any site. Preferably do not create more than 1 account per IP per day & if your proxies

are all in the same subnet (192.168.1.1, 192.168.1.2, 192.168.1.3 etc) then you should run no more than 1

thread during account creation & keep a high delay between each account that is created.

Information Generator

The information generator allows you to lookup information on each of your accounts & provides you with

total counts for all of your accounts with the need to login to your accounts at all / the bot does the work for

you.

The only options before starting the process are the normal threads to run option & a checkbox to display data

in the spreadsheet. If you are running tens of thousands of accounts you may not wish to view all of the data in

the spreadsheet within the information generator tab & instead decide to export the data to CSV for use in a

separate program / script / excel.

List Manager

This feature is specific to Twitter Bot. This feature logs into each of your accounts & looks up their current lists

& displays information of list name & member count (invited users).

You can also export this data to CSV format which also includes the URL to each of your lists available.

The current Twitter limitations (As of July 2016) are:

Maximum Lists Per Account: 1000

Maximum Invited Users Per List: 5000

User Follower / Subscriber / Friend Adder

The user follower / subscriber for each BHT bot allows you to automatically follow other users on the site. In

most cases this sends the user a notification of your follow / subscribe / friend add request & gain impressions

to your own profile. To truly understand how the module works in each bot you should have a good

understanding of how the website that the bot interacts with works.

Each BHT program has a feature, where applicable, to send follow / subscribe / friend requests. In order for

the program to find users on each of the websites that the bots work with you must enter a search criteria or

load in your own list of usernames / user ID’s to send requests to.

The Keyword(s) section is where you can provide this information to find specific users. The keywords entered

into this section are used on the search area within the site that the bot works with, E.g. The keyword

“Bangkok” is entered above. This is the same as searching Twitter for “Bangkok”:

As seen above, a search has been performed on Twitter for the keyword “Bangkok”. The program will then

scrape the usernames of users found through the search results & use these to send follow requests.

You can also enter:

user:Username

By entering this Twitter Bot will scrape the followers of the specific username that you enter.

All BHT bots will only ever process each scraped username / post ID once across all of your accounts so no two

accounts you have loaded into the program will follow the same user again in the future. The cache for this is

stored inside of the /datastore/AlreadyXXXX.txt files where the .exe is located.

With Twitter Bot you can also specify the search mode used on Twitter within the Settings Panel (More info

available for the settings panel in the Settings user guide below):

The amount of users scraped per keyword also depends on the setting you have on the settings tab for “Pages

To Scrape Per Keyword”:

Each site provides a different number of results per page; you can see the count increase as the scrape works

via the live count updates under “Users Scraped”.

To load your own list of usernames to follow instead of using the built in scraper you can click the blue link for

“Load Text File Of Users To Follow” where you will be prompted to select a text file of usernames. This text file

should contain usernames of Twitter users, one per line. This format should be usernames only, not the URL to

the Twitter profiles.

The keywords area also supports any search patterns allowed by each of the sites, E.g. On Twitter you can use

additional keyword such as “lang:fr” to find French language tweets only.

The other options available within the Follower Settings panel are explained below:

“Scrape Users Only” – This option will not perform any actions on your accounts other than logging in &

scraping users from the search results. As this runs usernames found will be stored in the

/datastore/ScrapedUsers.txt file where the .exe is located. Note that you will not be able to then follow these

users with the program once they are in this file as the program only ever follows each username once across

all of your accounts with these modules. The Mass Promoter allows you to mass perform actions on single

accounts / post ID’s, more information on the Mass Promoter is available further on in this user guide.

“Follow-Back Followers Before Finding New Users” – If this option is checked then the bot will scan through

the followers on your account & follow those back that you are not already following before scraping new

users using your keywords.

“Only Follow Users With More Followers Than Following” – Often you find accounts on Twitter that mass

follow with a very low number of followers. By checking this option Twitter Bot will ignore these accounts.

“Delay Between Actions” – This is the time that the program will sleep/wait before sending the next action for

each account, E.g. Follow 1 user. Wait 5-10 seconds. Follow another user. Wait 5-10 seconds. Repeat….

The 5-10 seconds option is a random delay between these 2 numbers for each action to simulate a desktop

user’s activity while browsing & following users on Twitter.

“Max To Send Per Account” – This is the maximum number of actions that you want each of your accounts to

make. E.g. Follow between 10 & 20 users for each account.

“Max Actions To Send (Total)” – This is the maximum number of actions that you want the program to make

for each run across all of your accounts, E.g. By setting 100 the program will not follow any more than 100

users over the entire process for all of your accounts. E.g. If you have 100 accounts & run 100 threads each of

your accounts will follow 1 user only.

“Follow Users With X-Y Followers” – This allows you to tell the program to follow users on Twitter that have a

specific number of followers, E.g. Users with more than 10 followers but less than 100000.

Twitter Bot also has some additional settings as seen above. These features are self-explanatory & optional. If

you do not understand the options then make sure to get a full understanding of how Twitter works before

using these options. The “Favourite User’s Latest Tweet” option will go to each Twitter profile before it follows

the user & favourite (like) their latest tweet & then proceed to follow the user, sending them 2 x notifications.

Also note: The default avatar on Twitter is the eggshell image. Profiles with this image will be ignored if the

“Ignore Profiles With Default Avatar” checkbox is checked before starting the process.

As with all other features, the process overview allows you to select a number of threads to run & start the

process along with options to Stop / Pause processes & a live stats view as the feature runs.

The Scheduler feature allows you to tell the program to re-run the process on your current settings made

before pressing the Start Process button every X hours. This is customisable with the above form & you must

set the Scheduler Enabled to “Yes” for this feature to automatically start itself again.

Once you have your scheduler settings set then click the Start Process button.

Clicking the Stop Process button at any time will disable all future scheduled processes for this feature.

Retweet / Favourite / Liker

All BHT bot features are similar to the previous chapter (User Follower / Subscriber / Friend Adder) in the

sense that you enter keywords to find users with / load your own usernames, enter your preferred settings for

delays & max actions, set your scheduler settings & then click the start process button.

The Retweet / Favourite module offers a couple of different options:

“Also Follow Tweet Owner” – By using this option the program will follow the account on Twitter that posted

the tweet that it has scraped & then will retweet / favourite (Like) the tweet afterwards.

The Retweet/Favourite ration is a percentage. The percentage in this case, as shown within the program is for

the percentage that it should retweet posts. So 70% of the time the bot will retweet posts & 30% of the time it

will Favourite (Like) the tweet that is currently being processed.

List Inviter

This feature is specific to Twitter Bot only. Twitter offers a feature on-site called “Lists” where you can add

users to a specific list to view these users tweets only. When adding a user to a list they are also sent a

notification which can gain views to your list & profile.

The List Inviter uses the same user scraper & settings as previous functions explained in this user guide.

You can enter lists to add users scraped to via the text area above. When adding lists these should be in the

format of:

ListName:ListDescription

For Example:

My List Name:My List Description

The List Description field is optional, so you could simply enter a list name without a description, E.g.

My List Name:

Note that the colon (:) at the end of the list name must still be included.

As this process runs it will check your account(s) to see if any of the list names that you have loaded into the

feature are already available on each of your accounts & if so it will use that list only. If no lists that you have

entered exist on the account being processed then it will automatically create one of these lists at random

from the list entered. This prevents all of your accounts from having exactly the same list names.

User Messenger / Direct Messenger

BHT programs that support messaging still rely on the rate limits & any other limitations of the website that

the bot works with, for example, on some sites you can only send messages to users that you are friends with

or users that follow you.

You can select the message mode before starting the process to send messages to either your own followers

or you can load a text file containing usernames to message (1 per line, username only, not full profile URL).

Instructions for the message format that should be entered are available above the text area, in this case as

shown above you should enter 1 message that optionally supports spintax (See spintax section for more info).

Send Tweets / Status Updater

Each BHT bot sends different actions, depending on the website that it works with, this example will use

Twitter Bot to display how to send a new tweet.

As shown in the image above, to send tweets you can enter 1 tweet per line. As the program processes your

accounts it will select a tweet at random from this list of tweets that you enter. Spintax is supported as shown

by the (Tokenizable) comment above the text area.

By checking the “Use Each Tweet Once Only” checkbox, each line that you enter (each tweet) will only be used

for 1 account. For example, if you enter 10 tweets but have 100 accounts only 10 of your accounts will post a

tweet, or less accounts depending on how many tweets you enter to post per account from the Max To Post

Per Account option that is seen below this text area.

Twitter Bot also supports posting tweets with links from RSS Feed URL’s. To use this feature check the “Use

RSS Feed Scrape Mode” & enter URL’s to your RSS feed’s into the Tweets To Send area, 1 per line.

The tweets that will be posted using the RSS Feed mode will appear as:

Post Title Post URL

E.g. RSS Feed Item:

Tweet Created:

As seen above, if posting multiple tweets the program will scrape multiple items from the RSS feed.

You can also specify specific accounts to post tweets to by checking the “Link Tweets To Accounts” checkbox.

To use this feature enter tweets in the “Tweets To Send” text area in the following format:

[ACC:AccountUsername][TWEET]This is the tweet text[/TWEET]

To post a tweet & an image, or simply an image, you can also use BBCODE, E.g.

This is my tweet text [IMG]C:\users\username\desktop\image.jpg[/IMG]

The AccountUsername variable should be the exact username that you loaded the account with through the

account manager in order for the bot to find the correct account to post the tweet to.

By clicking the “Export Submitted Tweet ID’s” button the program will produce a text file containing all of the

tweet ID’s that have been posted since clicking the Start Process button for your use / records. These ID’s can

be used later on in the Mass Promoter module which is explained in the next chapter of this user guide.

@Mention Own New Followers – This option will replace the [MENTION] token from your tweet with a

follower that has not previously been scraped by the bot (Providing you have not removed the

/datastore/AlreadyMentioned.txt cache file). E.g.

Thanks [MENTION] For The Follow – Would Be Replaced With: Thanks @username For The Follow

@Mention Multiple Followers – This option would use multiple usernames in the same tweet, E.g.

Thanks @username1 @username2 @username3 For The Follow

The @Mentioner feature only looks up the latest 5 pages (90 followers) of your new followers to prevent this

process from slowing down due to accounts with thousands of followers.

Mass Promoter

The Mass Promoter module allows you to mass promote your own posts / profiles. By using the accounts that

you have loaded into the program you can mass follow / like a specific profile or post to boost counts on the

website that the bot works with.

The Mass Promoter offers the main input area where you can enter the required usernames / posts to

promote. Above this area you can see the exact entries that should be entered.

In the example above:

TwitterUsername – This can be a username, E.g. BlackHatToolzCo

Tweet ID – This is the ID of the tweet, E.g. 531897368422387712

TweetID:Reply To Send, E.g. 531897368422387712:Great tweet!

TweetID:VoteInteger, E.g. 751443065605386240:1

You can enter multiple entries, 1 per line, E.g.

BlackHatToolzCo

AnotherUsername

ADifferentUsername

You can easily find the tweet ID by clicking the … button next to a tweet & clicking “Copy link to Tweet”. This

will display a popup like the below:

When voting on polls you should enter the format in: TweetID:VoteInteger.

The VoteInteger should be the option you wish to vote for, E.g.

751443065605386240:1 – This would vote for “This is option 1”.

751443065605386240:2 – This would vote for “This is option 2”.

Each vote option increases by 1, E.g. Option 1 would be 1, Option 2 would be 2 etc.

Once you have entered the usernames / tweet to promote you can then select the method in which you would

like these ID’s to be promoted:

Mass Follow Mode – Uses your accounts loaded to follow the username(s) specified.

Mass Favourite Mode – Mass Favourites (Likes) The Specified Tweet ID(s).

Mass Re-Tweet Mode – Mass Re-Tweets The Specified Tweet ID(s).

Mass Reply To Tweet Mode – Mass Replies The Specified Tweet ID(s) With Your Given Comments.

Mass Vote To Poll – Mass Votes The Specified Poll ID(s).

You can also select a way in which you would like the mass promoter to promote the ID’s that you have

entered by choosing from the options below:

Promote Each Item X-Y Times – This option will use your “Actions To Send” number, E.g. 50-100 to promote

each ID 50-100 times. So if you had 10 accounts loaded you could be sending a potential of 500-1000 actions.

Choose Items At Random For Each Promotion – This option will stick by your “Actions To Send”, E.g. 50-100 to

send between 50 & 100 actions across all of your accounts to random ID’s from the list. So no more than a

potential top end of 100 actions will be sent.

Promote Each Item Once Only – This option will promote each ID that you enter 1 time only. So if you entered

E.g. 50 Tweet ID’s to Favourite then only 50 actions will be sent.

Profile Updater

The profile updater module allows you to set the bio / location & other data along with the ability to upload a

profile image to your accounts.

To use this feature simply enter the required information as shown in the form below:

By checking the “Update Profiles That Do Not Already Have A Custom Image Already Uploaded” option this

feature will skip any account that is processed that already has a custom avatar uploaded to its profile.

The 2 folder options allow you to specify a folder where you have stored images on your hard drive. These

images will be used with the corresponding fields, E.g. Profile Image / Background Image.

Where options are not available to specify a folder to upload images from these are automatically selected

from the following folder where the .exe is located:

/datastore/images/

For software that also sets the gender of the account you may have sub-folders such as:

/datastore/images/male/

/datastore/images/female/

In these cases you should place images to upload into the 2 folders above.

Images should not be stored in sub-folders, E.g.

/datastore/images/randomfolder/

The other fields, as shown above each text area, allow you to enter Bios, Locations, Websites & the Names to

set on your accounts as they are processed. You should enter these 1 per line & they also support spintax.

Additional options also specific to Twitter Bot can be seen below:

The Reset Account Passwords feature is useful should you have purchased your accounts from a provider &

wish to lock them out of these accounts.

The Set Accounts Languages option will display Twitter in English when you login to your accounts, should they

have been created in a different country that’s native language is not English.

Profile Scraper

The profile scraper is a unique feature to Twitter Bot that allows you to scrape the data from other users on

Twitter for your profiling purposes.

This feature is uses scrapers similar to other features in Twitter Bot allowing for keyword entries such as:

Keyword(s) To Search

user:Username – Searches for the followers of a specific user

Keyword lang:fr – Searches for language specific Tweets.

The scraper in this module still uses the search options set on the Settings Tab (Explained further in this guide).

User Unfollower

The Unfollower module allows you to unfollow specific users, users that do not follow you, or all users that you

are following on your accounts.

This module uses the same settings as the other features of the bot (Delay settings, max per account / max

total settings) & also offers additional settings:

Ignore The Latest X Users That Each Account Is Following – This option will ignore the latest users that you are

following, this way for example, you can follow 100 users per account each day & set the Unfollower to run

daily to unfollow all users apart from the latest 100 following. This way if the users that you have followed the

previous day have not followed you back Twitter Bot will automatically unfollow these users.

Un-Favourite Tweets Before Starting Unfollower – This is a separate option that when checked un-favourites

(Un-Likes) all of the Tweets that your account has Favourited (Liked) before starting to unfollow users for each

account that is processed.

The following Unfollow modes can be selected also:

Unfollow Users That Are Not Following You Back – This option unfollows users that your account(s) are

following that do not follow you back. This still uses the “Ignore The Latest X Users That Each Account Is

Following” option so if you wish to ignore this option enter 0 in this field also.

Unfollow ALL Users Of Each Account – This will ignore users whether they follow you back or not & unfollow all

users that each of your accounts is following, within your max per account / max total limits.

Unfollow Specified Usernames Entered Below – This option will ONLY unfollow the usernames that you enter

into the field below it when processing each account.

Settings Panel

The Settings Panel contains options that you can set that all applicable modules will abide by.

Above you can see the connection settings that you can set:

Maximum Timeout Setting – This is the amount of seconds that each URL call attempts to load before it fails,

E.g. When a webpage times out.

Max Connection Retries – Should a connection fail, due to a timeout or any other reason, the program will

retry the same connection X times depending on what you enter here.

Simultaneous IP Connections – When you are running multiple accounts in Twitter Bot you may have many

accounts without proxies (Using your own IP) or many accounts running the same proxy. By enabling this

option you are telling the program that it is ok to process accounts across multiple threads that are using the

same IP / Proxy. By disabling this option only accounts on a unique IP will be processed within each thread.

All keyword scrapers within Twitter Bot abide by the above rules, for example, when using the Follower you

can enter “motorcycle” as a keyword & it will use the above rules.

Pages Per Keyword To Scrape – This is how many consecutive pages of data you wish to scrape from Twitter.

Each search page contains a certain number of results, as the scraper runs you can see the items scrape

increasing in segments, for each page that is being processed. Should you wish to scrape more results per

keyword you can increase this count. This option includes when entering “user:username_to_scrape” as a

keyword. So it will only scrape X pages of the followers of a specific account also.

Skip Keyword If No New Results In 5 Pages – If set to Yes the program will attempt to scrape new results for

your desired keyword. If no new results are found within 5 pages (All ID’s found have been used previously)

then the program will skip that keyword & move onto the next keyword that you have entered.

Enabling this option will store any “Unknown Issue” error logs to the /datastore/error_logs/ folder so that you

can email them to admin@blackhattoolz.com for a diagnosis of the issue that you have encountered.

When searching on Twitter you can select an option in which to display results, each option shown above. You

can also see in the image below that the bot is selecting from the options on the website as seen below:

If your proxies rotate / are frequently scraped or updated by your proxy provider you can use our proxy

downloader setting as shown below:

To use this feature set the “Load Proxies From URL” option to “Yes”. Enter the URL where your proxies are

updated on, these should still be in Proxy:Port format, 1 proxy per line & then select how frequently you wish

the bot to update the proxies it has loaded into the system in minutes.

Note that when the program updates the proxies it will stop all threads, download new proxies & then restart

the threads. So the minutes delay time should not be less than 10 minutes as this would reduce efficiency.

In order to create accounts on Twitter you must not phone verify the account upon registration. If this process

is not completed / you have selected to skip phone verification then accounts will be prompted for re-

verification shortly after creating an account.

To use the phone verification options you can select to phone verify accounts manually, which will prompt you

to enter a phone number to receive an SMS verification method to, this will also be the phone number

registered to the Twitter account, or you can have the bot automatically phone verify your accounts during

registration by using the smspva.com API.

To find your API key on smspva.com login to your account & then click the silhouette icon of your profile next

to your balance & then click “Profile And API Key” which will display “Your API Key: xxxxxx”.

The max wait time for SMS is the maximum time in seconds that you want the bot to wait for the verification

SMS to arrive. E.g. 600 seconds – If no verification SMS has been received within 600 seconds then skip the

phone verification process & move onto the next account to create.

The captcha settings allow you to manually enter captchas as they are prompted to enter as the bot processes

your accounts or you can use a captcha service to automatically solve captchas for you.

Once you entered / changed any setting you must click the Save Settings button on the Settings panel in

order for these changes to take effect.

Spintax Tester

Wherever spintax (Tokenisation) is supported you can enter 1 line that can be created into many unique lines,

E.g. {Hi|Hey|Hello} World! I Am Nested {{Spintax|Spun}|{Tokenised|Tokened}} Content!

Before using the spintax you may wish to check that it is valid using this module:

Simply enter your spintax into the first field & click the Spin It button & each time you press this button you

will be shown a potential different output for the spintax that you have entered.

Should your spintax be invalid then you will see that the output content is not plain text, E.g.

Proxy Tester

BlackHatToolz.com Bots use socket connections / HTTPWebRequest within VB.NET. Many sites require

additional headers to be sent for authentication headers, E.g.

X-Requested-With

X-Auth-Token

Authorization

Your proxies must also forward / allow these headers where they are required to be able to work with the site

that the bot works with or they will cause issues.

To test your proxies simply click the Import Proxies button & load your proxies in the globally supported

format:

Proxy:Port

Proxy:Port:ProxyUsername:ProxyPassword

Once loaded click the start process button & the program will automatically confirm that your proxies can

forward the required headers & also that they can access the homepage of the site that the bot works with.