Standalone Twitter Manager

Getting Started


We thank you for your business and hope you enjoy the fruits of our labor. Our products are not only developed by us but are also used in all of our projects so you can rest assured we test our products thoroughly under various conditions to ensure you receive a quality product. If however your environment experiences any type of issue with our products please feel free to visit our forum or email us at

Thank you,
The Team

Are you ready to skyrocket your Twitter Followers?

In order to use this Script you will need to complete 6 simple steps

  • Install the Script
  • Create a Twitter app
  • Configure the Script with your Twitter app info
  • Add your Twitter account Access Tokens to the Script
  • Add Hashtags, keywords or Twitter ids to get followers
  • Configure cronjobs to perform the Scripts tasks
  • Search for users to follow using the embedded Twitter search


  • Automatically follow twitter users
  • Automatically unfollow people who do not follow you
  • Find twitter users by keyword, hashtag or snipe users from competitors




Upload and Enable the Script


Upload the “new_twitter” folder to your

# Your-Site-Name/new_twitter

  • Connect to your websites FTP
  • Navigate to the root folder (or any sub folder where you want the twitter manager to reside
  • Upload the entire twitter_manager folder and all of its contents into the subfolder. You should then see Your-Site-Name/twitter_manager in your ftp program


Run the install script

After uploading the script you will need to set it up with a database. In order to do that visit the url for your twitter manager EX.

You will see the initial install script where you need to enter the folowing pieces of information
  • Database Name
  • Database Username
  • Database Password
  • Database Host (this can be setup through your hositng provider or if you have a standalone server you can use ppmyadminto setup an empty mysql database.
  • Optional Table Prefix (if you want your tables ot have a specific prefix)
  • Admin Account Username, Email Address and Password
Once hte information is entered click submit and the script will setup all necessary database tables and the install is finished.

After the install script runs you should see the login mask

Create your twitter App

In order to use the Script you need to create a twitter app.

  • Visit
    and sign in (if you are not already signed into twitter
  • Click Create new App

Fill out the app name, description, your website URL and the callback url.
Note: for the Callback URL copy it from the twitter Manager config section. You can reach the Twitter Manager Config Section via your site domain followed by

As an example

Congratulations you created a Twitter App

The resulting page will show the overview of your Twitter app with 4 tabs (Details, Settings, Keys   Access Tokens, Permissions). Click on Keys   Access Tokens as shown in the screenshot. You need to add these to the Twitter Manager Scripts configuration.

Additionally, for the app to work, we need to obtain Access tokens for our Twitter App. This allows us to perform all our needed functions without having to log in or authenticate the app for our account. To do this go back to your Twitter apps Key & Access Tokens tab and scroll down. Click to generate the tokens so that you can later add them to the Twitter Manager app config Access Tokens section.

Lastly we want to change the app permissions to ensure our script can perform all actions we need. on the site under your app, click on the permissions tab. Next click on the radio button for enable "Read, Write and Access direct messages " permissions.

Configure the Twitter Manager Script

  • Visit Twitter Manager configuration page

In your Admin navigation bar you click “twitter manager” (the Script is also reachable via


  • Connect Twitter Manager with twitter App

Under the settings tab of the Plugin enter in the Twitter App Key/Secret, the access tokens we generated and click Submit to save these settings

  • Add twitter Account(s)

Lets make friends :-)

  • Search

To setup keywords, hashtags and or TwitterIDs for our twitter Account click on “App config” in the left navigation.

Note: The Configuration screen is a little long
so we are breaking it down into its individual parts
for ease of understanding what each part does

  • Keywords, Hashtags

The first section you see is specified for Enabling the keywords following section as well as adding Keywords or hashtags which will be used by the system to search Twitter in order to find people who have tweeted about these keywords, keyword pairs or hashtags. These people will be followed by your twitter account in the expectation that these people will follow you back.

Please note: When entering keywords, keyword pairs and hashtags, add 1 per line. Just type in a keyword pair and hit enter to go to the next line so you can enter in another keyword, hashtag or keyword pair.

  • twitter ID's

The second section you see is specified for enabling the Twitter ID's following as well as adding Twitter ID’s which will be used by the system to search Twitter in order to find people who are following this specific Twitter ID. These people will be followed by your twitter account in the expectation that these people will follow you back.

Please note: When entering Twitter ID’s add 1 per line. Just type in a Twitter ID and hit enter to go to the next line so you can enter in another.

Advanced settings and error reporting

Configure the advanced settings to whitelist Twitter IDÄs you never want to unfollow and deal with any errors

  • If there are users you want to never unfollow (even if they do not follow you back) simply add their twitter ID in this field. One per line

  • Enter your email address. You will receive error notifications if any of the below error thresholds are reached

  • Select how many times the unfollow script can throw an error before the function disables itself and you receive notification (errors may occur if you reach the daily limit for your account or if the ratio of followers to unfollowers is too high.)

  • Select how many days you want the script to wait before it unfollows people. We recommend 2-3 days (ex. if 3 days is selected the script will select all people who you followed older than 3 days and unfollow people who have not followed you back.)

  • Select how many times the follow script can throw an error before the follow function disables itself and you receive notification.(errors may occur if you reach the daily limit for your account or if the ratio of followers to unfollowers is too high.)

Start your engines

Part 1: Setting up cron to run the Twitter Manager system

The last section allows you to set up how the script is run to follow/unfollw other twitter users based on your keywords and twitter competitor ids.

  • Frequenqy Cronjob: This section sets how often the script is run. If you decrease the time it will runn more often. Icreasing the time will run the script less often (we recommend leaving the range we have set).

    Enabled Following: This chckbox allows you to turn the act of following other people on and off. If you want ot take a break from following people just uncheck the box and save the settings. To restart following people go back to this settings page, check the box and save the settings again.

    Limit Following / per day: Due to Twitters daily caps you can follow a ax of 1,000 people per day. Additionally smaller accounts have a different logic than larger follower accounts. For this reason we recommend starting off with a smaller follower number per day of between 400 and 600 and as your account grows then you should increase your daily following activity slowly up to 1,000 people per day.

    Frequency Following / per cronjob: Here you ahve the ability to give a range of how many people should be followed each time the cron runs. This randomness ensures that Twitter does not see the script as a a bulk follow script.

  • Next come the (Enabled UnFollow) / (Limit UnFollow / per day) / (Frequency UnFollow / per cronjob) settings. These settings are similar to the settings for following and are configured in the same way but they control how you UNfollow people how do not follow you back.

  • Please note: Twitter has limits of followers per hour, per day and may automatically disable your Twitter App (that we created earlier in this tutorial) so it is better to be more cautious and not too aggressive. With that said you can set this number as high as you like

Part 2: Setting up external cron to call the twitter manager cron urls

In order for the scripts to run we need to set up cronjobs. These are scheduled jobs that will call our scripts to run at designated times. For example every 1 minute.

Depending on your technical skill you can achieve this through a number of methods. Either setting them up directly on your linux/windows server or using a 3rd party service.

We recommend using It is a free cron service that is reliable for achieving the needs of this Script.

Go to
to register and login

Once logged into click on the cronjobs tab at the top

Then click on Create cronjob

  • Enter a title for this cronjob. i.e. Run Twitter Follow Script
  • Enter the script url. You get this again from the Twitter manager Config tab on your website
  • Set a scheduled time for running this cron. i.e. every 1 minute, only on wednesdays, etc. (We recommend running hte cron every minute)
  • Click save and you are done Now set up crons for the unfollow and tweet scripts

To help you do research in order to find the right users to follow we have integrated a twitter search function. Next to the twitter account you want to find users click on “Search for Users”. You will be brought to a form. Enter in the search content (keywords, hashtags, usernames) and select the search type you wish to perform (either search by screen names, User based search or search by tweets. Click search now and the Script will return any results that match your terms

From the results we can either check all users we want to follow and click the Follow Selected users button or we can use the results to get Twitter id’s of users who have a large following that match our focus and add that to this Twitter Accounts configuration “Twitter ID” section. This is a powerful tool to help you research how many people are tweeting about topics as well as a way to snipe thousands of twitter users to your own twitter account.

Twitter Manager Logs

The Logs section allows you to see the history of follows and unfollows for a specific account. Additionally you can view the activity of your cronjob and see how your twitter account (following vs. followers) look over time in line chart form.

This documentation is provided by