Tweet Twain Pro User Manual V1.0

TweetTwain.com

http://www.tweettwain.com

TWEETTWAIN PRO USER MANUAL VER 1.0 Ultimate tool for social media monitoring and management!

Table of Contents

Disclaimer...................................................................................................................................................... 4

Introduction .................................................................................................................................................. 5

Downloading and Installing TweetTwain ...................................................................................................... 6

Launching TweetTwain ................................................................................................................................. 8

Upgrading to TweetTwain Pro ...................................................................................................................... 9

Setting up API keys ...................................................................................................................................... 10

Adding Twitter Accounts ............................................................................................................................. 11

Mapping Facebook Accounts ...................................................................................................................... 14

Composing and Publishing your First Tweet ............................................................................................... 17

Sending Direct Message .............................................................................................................................. 18

Mentions ..................................................................................................................................................... 19

Re-Tweets ................................................................................................................................................... 21

Monitoring Brands ...................................................................................................................................... 22

Auto-Reply .................................................................................................................................................. 23

Auto Follow ................................................................................................................................................. 24

Auto Re-Tweet ............................................................................................................................................ 25

Feed Monitoring ......................................................................................................................................... 26

Application Integration ............................................................................................................................... 27

Keyword Statistics ....................................................................................................................................... 28

Account Statistics ........................................................................................................................................ 29

Search & Follow .......................................................................................................................................... 30

Bio Search and Follow ................................................................................................................................. 31

Keyword Search and Follow ........................................................................................................................ 32

Account Based Follow ................................................................................................................................. 33

Search and Add to List ................................................................................................................................ 34

Un-follow Non-followers ............................................................................................................................. 35

Un-follow All ............................................................................................................................................... 36

Twitter Campaigns ...................................................................................................................................... 37

Importing Tweets to TweetTwain ............................................................................................................... 42

Exporting Tweets ........................................................................................................................................ 43

Analyzing the Links ...................................................................................................................................... 44

Auto-Tweets: Auto-Generate and Publish Tweets ..................................................................................... 46

Shorten Multiple URLs ................................................................................................................................ 47

Settings........................................................................................................................................................ 48

Un-installing TweetTwain ........................................................................................................................... 57

Support ....................................................................................................................................................... 58

Disclaimer

The information presented herein represents the views of the author as of the date of publication and is for informational purposes only.

Third party services like Twitter, Bit.ly and their API affect the performance of TweetTwain. Changes of their services might cause TweetTwain to not work on some of its features. We have no control over the changes they make in their services. Because of this we cannot make any guarantees that all of the features available now will continue to function as it is, but your license have access to our lifetime updates and you can get any changes we make to the program for free.

Additionally, the developers and distributors of the TweetTwain tool are explicitly removed from any and all liability associated with the use of this tool and will not be held liable for any damages arising from the use, misuse or abuse of TweetTwain. We recommend that you use the software judiciously and not abuse it for the purpose of spamming those services. Doing so will most likely result in your accounts being terminated, in effect wasting any effort you’ve put into it. You agree to accept liability for any damages caused by misusing TweetTwain.

TweetTwain don not promote spam. This tool was created for you to market your product effectively with less effort. Please use it well and provide value to your fellow tweeters.

Introduction

TweetTwain is a desktop tool to monitor and manage multiple Twitter accounts. You can fully automate your Twitter accounts to keep them alive, attract more followers, promote your products and measure your performance on social media platforms such as Twitter.

Downloading and Installing TweetTwain

TweetTwain is developed in Sun Java (http://www.java.com) and will work in all operating systems. To download/upgrade Java please visit http://www.java.com/ Pre-requisite: Java 1.6 or 6.0 Tip: To know whether Java is already installed in your system or to know the version of Java, go to your console (command window) and type java –version Once you have Java installed, go to the below URL and click on the ‘Launch’ button. http://www.tweettwain.com/download-tweettwain-java-webstart You may receive a security warning as shown below.

Check 'Always trust content from this publisher' and click on Run to proceed with the installation. The installation wizard will download all the required files from the server and configure TweetTwain on your machine. Once the installation is complete, a desktop icon and a new menu item will appear on your desktop.

Frequently Asked Questions

1. What is Java Web Start? Java Web Start is a framework developed by Sun Microsystems that allows users to start application software for the Java Platform directly from the Internet using a web browser. Updates of the software download from the Web become available when the user has a connection to the Internet, thus easing the burden of deployment. 2. My browser is not launching the application TweetTwain is distributed as Java Web Start and some browsers like Google Chrome downloads the JNLP file instead of launching the program. Double-click on the downloaded (tweettwain.jnlp) file to launch the installer. 3. I am not able to run the application Please make sure you have Java 1.6(or 6.0) installed in your computer. 4. I am getting a security warning while launching the application You can ignore the warning as TweetTwain is distributed with a self-signed certificate. 5. How do I un-install TweetTwain You can un-install TweetTwain using your OS default un-installation method (for Windows, go to Control Panel -> Add/Remove Programs -> TweetTwain and click on Un-install) 6. How can I upgrade to the latest version of TweetTwain? All updates will be automatically delivered to your computer on restart of TweetTwain.

Launching TweetTwain

You can launch TweetTwain by double-clicking the desktop shortcut or by locating the TweetTwain menu. Your initial screen will look like this:

Setting up TweetTwain is explained in the below sections.

Upgrading to TweetTwain Pro

Go to Settings->Upgrade to TweetTwain Pro and click on “Buy Now” button. Make payment via PayPal and you will receive your registration details in 24 hours. Enter your registration details which you received from us and click on Upgrade.

On successful completion of the above steps, you will receive a success message as shown below.

Make sure you restart TweetTwain to enable all hidden features.

Setting up API keys

This is an option feature, if you do not want to set-up your own API key, you can skip to the next section. TweetTwain uses the following API services to load and publish contents: 1. Twitter – social networking service 2. Facebook – social networking service 3. Bit.ly – URL shortening service Tip: We recommend you to use your own API key so that you can avoid conflicts when there are changes to the API keys or the service provider suspends API keys because of violating their terms and conditions. Watch the below video to learn how to create your own Twitter API key: http://www.tweettwain.com/online-help-tweettwain-tutorial/14-tweettwain-screencasts-video-tutorials#branding

For other services, visit their own website to create API keys.

Adding Twitter Accounts

You can add unlimited number of Twitter accounts to TweetTwain. Each Twitter account will be associated with a Twitter API key. So, if you have any plan to change your API key, do it before adding Twitter accounts. Go to Settings->Manage Twitter Accounts and click on Add Account. A popup window appears asking your Twitter screen name as shown below:

Enter your screen name and click on Add. Read the instructions carefully and click on OK. A browser Window appears with Twitter website. Log in using your screen name or email address and allow access to TweetTwain by clicking Allow button:

A one-time PIN will be displayed on the screen as shown below:

Copy and paste the PIN in the TweetTwain pop-up.

Make sure there are no extra spaces while copying the PIN. Click on OK, on successful completion of the above steps you will receive a message as below:

Your new account will be listed in the accounts list.

Mapping Facebook Accounts

You can map your Facebook account to your Twitter account. All contents published to your Twitter account will be published to your mapped Facebook account. Go to Settings->Manage Facebook Accounts and click on Map Facebook Account Enter your Facebook account name, select your Twitter account to which this account needs to be mapped and click on Add button. You can enter your Facebook page id if you want to publish to your page instead of your profile page.

Your Facebook app page will be displayed with the below content asking your permission to access your profile details. Click on Allow.

Now you can come back to TweetTwain and click on the OK button.

You may get another page with the below content, click on Allow Publishing.

On successful completion of the above steps you will get a success message as shown below:

Composing and Publishing your First Tweet

Go to File->New Tweet or click on the New Tweet button on the toolbar to launch the Tweet window. You can directly upload images to yfrog, a free image hosting service. To upload an image, click on Browse and select your file. Select your accounts to which the message needs to be published. Click on Upload to upload your file to yfrog. A URL will appear on the message window once the upload completes. Enter your message in the text area provided. If you have long URLs in your message, shorten those by clicking the ‘Shorten Url’ button. Once you are done with the message, click on Preview button. Click on the Publish button to ‘Publish’ it to Twitter. If there is a Facebook account mapped to the selected Twitter account, the story will be published to your Facebook wall or Page wall as per the settings.

If you want to publish your message on a later date or time, uncheck the Now checkbox and select your desired date and time.

Sending Direct Message

You can send DM to all your friends with single click on a button. Go to File->New Direct Message or click on the New DM button on the toolbar. Select your account from the drop down, all your friends screen name will be loaded on the right-hand list. Select your friends to whom DM needs to be sent or click on the select all button. Enter your message and click on Preview to preview the message. Select a Delay from the drop-down which is the delay between two DM requests. Once you are done with the settings, click on Send.

Tip: As per the Twitter rules, you can send only 250 DMs in a day. On reaching the limit, TweetTwain pauses sending DMs and continues when the DM window is available.

Mentions

All mentions to your account will be listed in this tab. TweetTwain updates the content real time, so you can monitor your account and give reply or re-tweet the tweet. Go to Mentions tab and select your account. All mentions till date will be loaded in the bottom table.

Select a row and right-click for options.

Reply: Click on reply to reply to the user who mentioned your screen name in their tweet.

Follow: Click on Follow to follow the user Re-Tweet: Click on Re-Tweet to re-tweet the tweet Edit and Re-Tweet: You can edit the message and re-tweet with this option.

Send DM: Send direct message to the author of the tweet Clear: Clear the bottom pane View Profile: View the profile page of the author in a browser

Re-Tweets

Here you can view all the re-tweeted tweets and the number of re-tweets.

Right-click a re-tweet to reply, follow, send DM or view profile.

Monitoring Brands You can monitor your brand or keywords on Twitter and export tweets to a CSV file. TweetTwain monitors tweets for your keywords and display it for you real time. Go to Monitor Brands tab and select your account. Enter your keyword and click on Add to List.

You can delete your keywords by clicking on the Delete link on the keywords table.

TweetTwain monitors keywords every X minutes as per your brand monitor setting and loads the tweets on the bottom pane.

If the export option is enabled, tweets will be exported to a tab separated file under the data folder (%user_home%/TweetTwain/Keywords/tweettwain.txt).

Auto-Reply You can send replies automatically to those who refer your keyword in their tweet. While adding keyword, check ‘Send Auto-Reply’ and click on Set button to set auto-replies. Type your message and click on Add. You must add at least 3 replies and TweetTwain randomly picks a reply and sends reply based on your automation setting (Low/Medium/High).

You can view the auto-reply log on the bottom pane as shown in the screenshot below.

Auto Follow You can set TweetTwain to automatically follow users who mention specific keywords in their tweets. The follow frequency can be controlled by the Automation settings.

You can see the follow request log on the bottom pane.

Auto Re-Tweet

You can automatically re-tweet tweets containing specific keywords.

TweetTwain monitors Twitter timeline for your keywords and re-tweets tweets matching your keyword. You can control the re-tweet frequency via Automation settings.

Feed Monitoring You can configure TweetTwain to automatically publish your new blog posts to Twitter and Facebook. Go to Feeds tab and fill the details as shown in the below screenshot:

Make sure the feed URL is in RSS format. Click on Test to test your blog URL. All your feed URLs will be listed in the bottom pane. TweetTwain at regular interval checks for new blog posts and posts new blog entries to Twitter and Facebook.

Application Integration You can integrate your business applications with Twitter and Facebook via TweetTwain. Update your organizational messages to a database table and let TweetTwain read those messages and publish to your social media accounts. Go to Integration tab and add your database details as shown in the below screenshot.

The above sample assumes a database table MESSAGES with two columns MESSAGE (String) and PUBLISHED (Boolean). Every 60 minutes, TweetTwain reads one un-published message from the MESSAGES table and publishes to your associated account. After publishing the message, TweetTwain sets the publish flag to true.

Keyword Statistics TweetTwain is capable of generating visual graphics from the data collected from Twitter. Go to Trend Analysis tab and select your keyword. Click on Generate Chart to generate a graph with your data for easier analysis.

You can export the graph as PNG image by right-clicking on the graph and selecting ‘Save as...’ option. Note: You must keep TweetTwain running to collect data from Twitter.

Account Statistics

You can analyze your followers and friends count by looking at the account statistics graph.

Search & Follow

One of the unique features of TweetTwain where you can automate your follow/un-follow/add to lists actions. Go to Settings->Options->Search tab and configure your search.

You can add new search tabs by clicking the menu bar icon shown in the below screenshot.

Warning: Mass follow/un-follow actions may force Twitter to suspend your account. Use this feature with ultimate care.

Bio Search and Follow

You can search user’s biography and send follow requests. Enter your brand name or keyword and click on Search & Follow. TweetTwain loads X number of users matching your search criteria and sends follow request at regular interval as set in the search settings.

You can see the following details of a user in the search result: Screen Name – Twitter screen name of the user Following? – Following status (Not Following – Requesting – Following/Pending) Followers – Number of followers Following – Number of people the user is following Biography – User’s Twitter biography

Note: If your request to follow is pending or you have been blocked from following a user, the status will be shown as ‘Pending’.

Keyword Search and Follow

You can search for a specific keyword within tweets and follow only those users. This tool is useful when you want to follow users in a specific niche.

Tip: You can restrict the search for a location by typing the city or state name in the Location textbox and selecting the area from the drop-down.

Account Based Follow

You can follow all followers of a user or all users following a specific user. Enter the username and select ‘Followers’ or ‘Following’ and click on Follow.

Tip: You can follow all your followers by entering your screen name in the username textbox and selecting ‘Followers’.

Search and Add to List

Another unique feature where you can search users, follow them and add them directly to a Twitter list. Also you can create a new list by selecting ‘Create New List’ from the drop-down. Enter the list name in the pop-up and click on OK.

The newly created list will be loaded in the lists drop-down, select the list and click on ‘Search & Follow’

Un-follow Non-followers

You can un-follow all your non-followers using TweetTwain. Select your account form the drop-down, select ‘Non-followers’ option and click on ‘UnFollow’. TweetTwain loads X number of non-followers and sends un-follow request.

Un-follow search result:

Un-follow All

You can un-follow all your friends by selecting ‘All’ option. You can clean your account with this option.

Twitter Campaigns

Go to Campaign tab and click on 'New Campaign' button. Enter the campaign details and click on Save.

Account: Your Twitter account

Name: A short name for your campaign

Start Date: Campaign start date

End Date: Campaign end date

Hashtag/Code: If you want to measure your performance based on a hashtag or promotion code, enter it here. Make sure you are entering a unique hashtag for example #ANDROIDMARKET2012

Link: The long URL to your campaign page. TweetTwain uses Bit.ly URL shortening service to shorten your URL and you can track the link clicks.

Message: A short message which will be published to Twitter. Make sure you include your hashtag in the message. The short URL will be included automatically.

Tweet Now: Publish the message to Twitter

Preview the message and once you are ready, click on the ‘Save’ button. TweetTwain will update the statistics at regular intervals. You can view the status of your campaign at the Campaign tab.

Double-click a campaign to view the campaign details. If you have not yet published your tweet, click on the ‘Publish’ button. You can export tweets or user details, print a report or even select a winner randomly.

Twitter Reach: Direct viewers of your tweet

How many Re-Tweeted: Re-Tweet count

How many Hashtag tweets? Number of tweets with the campaign Hashtag within the start and end date.

How many clicked the link? Link click count

New followers: New follower count within the date range

Virality: Followers of people who re-tweeted or used the hashtag in their tweet.

Most Influential Viewers:

Details of users who have most number of followers, who re-tweeted or mentioned your hashtag in their tweet.

Reports and Statistics: 1. Export Hashtag Tweets: Click to export all tweets mentioning your hashtag in to a Comma

Separated File (CSV) which falls within the campaign start date and end-date.

2. Export/Print: Click to generate a campaign report in PDF format. You can print the campaign details from this PDF.

3. Export Re-Tweeted Users List: Click to export details of all users who re-tweeted your tweet.

4. Link Statistics: Click to view the statistics of your link.

You can view the link click count, referrers, locations and many more.

5. Select a Random Winner: At the end of the campaign you can select a random winner by clicking this button. Last generated winner will be saved in the database and can be viewed later.

6. Refresh: Click this button if you want to manually refresh the campaign data. Note that it may take a long time to complete this process.

Importing Tweets to TweetTwain

You can import unlimited number of tweets in to TweetTwain and can be scheduled to publish at your specified date and time. Prepare a comma separated file (CSV) in the below format:

Tweet Screen Name Date and Time(YYYY/MM/DD HH:MM) Sample file given below: My sample tweet 1,myscreenname1, 2011/01/01 08:30 My sample tweet 2,myscreenname2, 2011/02/01 08:30 My sample tweet 3,myscreenname2, 2011/02/01 14:30 My sample tweet 4,myscreenname3, 2011/03/01 08:30 My sample tweet 5,myscreenname3, 2011/03/01 09:30 Save this file as TweetImportSample.csv. Go to Tools->Import Tweets, select the above file and click on Ok. Go to the Tweet Queue tab, all the imported tweets will be listed in the queue.

Tip: You can delete multiple tweets from the queue by selecting multiple rows and pressing Delete key. You can clear the tweet queue by selecting Tools->Clear Tweet Queue

Exporting Tweets

Go to Tools-Export Tweet Queue to export all pending tweets to a Comma Separated file (CSV). A sample exported sheet shown below: Message,Account,Publish Time,Delete?, My sample tweet 1,myscreenname1,2011/01/01 08:30,false, My sample tweet 2,myscreenname2,2011/02/01 08:30,false, My sample tweet 3,myscreenname2,2011/02/01 14:30,false, My sample tweet 5,myscreenname3,2011/03/01 09:30,false, You can export the archived tweets by selecting Tools->Export Tweet Archive.

Analyzing the Links

All your links published via TweetTwain will be tracked and can be monitored to measure your performance. Go to Link Analysis tab and select your account.

Clicks: Total number of clicks via your link Global Clicks: Total number of clicks via global links Double-click to view the link report including:

1. Link click location 2. Referral websites 3. Time based click report 4. Twitter conversations

Tip: URLs shortened from outside TweetTwain will not be available for ‘Link Analysis’

Auto-Tweets: Auto-Generate and Publish Tweets

TweetTwain is capable of publishing tweets at regular intervals based on your keyword. Go to Auto Tweet tab and select your account. Enter your keyword and click on Add.

You can change the frequency of the tweets by changing the automation settings under Settings->Options->Automation tab.

Warning: Make sure you set proper keyword and monitor the tweets being posted by TweetTwain for couple of days. Keywords not related to your account niche may result in loosing hard earned followers.

Shorten Multiple URLs

Go to Tools->Shorten Url or click on the toolbar button to open Shorten URL window. Enter your long URLs to be shortened in the text box separated by new line and click on ‘Shorten Url’. The shortened URLs can be copied from the ‘Short Urls’ text box.

Settings

Various settings and their details can be found under this section.

1. Tweet Settings Various settings for Tweet publishing can be found here.

a. Tweet Publish Delay: Duration between tweets published from TweetTwain. This setting

will override all scheduled tweet timings. You can select 1, 2, 5, 10, 30 or 60 and is measured in minutes.

b. Brand Monitor Delay: TweetTwain monitors tweets for brands or keywords at regular intervals. You can select 2, 5, 10, 30, 60, 120, 360 or 720 and is measured in minutes. Change this setting to a higher value to save API calls.

c. Enable New Tweet Alert: Enable or disable new tweet popup on the system tray. Every X minutes, TweetTwain checks for new tweets.

d. Enable Direct Message Alert: Enable or disable DM notifications. Every X minutes, TweetTwain checks for new messages.

e. Alert Delay: The duration for which the tray pop-up will be displayed. You can change this setting from the system tray too.

2. Proxy Settings You can add/delete proxies here.

Check Use Proxy to use proxy server to connect to Internet. You can add proxies separated by new line to use Random Proxy.

3. Black List & White List You can add or remove users to black or white lists. Users in blacklist will be excluded from follow and those in white list will not be un-followed during un-follow.

Tip: You can automatically add users to blacklist who has not followed you back by checking the Add to blacklist checkbox while un-following.

4. Theme Settings There are 13 Themes available in TweetTwain. Select your desired theme and click on Apply. Some themes may require restart.

5. API Settings You can use your own API key for Twitter, Facebook and/or Bit.ly. Leave these fields empty if you want to use default API keys with TweetTwain. Please do not enter invalid API keys as TweetTwain may become unusable on doing so.

6. Security You can protect your accounts with a username and password and limit the access to only authorized users. Select a username and password and click on apply. On restart, TweetTwain will ask for your credentials before launch.

Authentication Pop-up:

You can disable authentication by simply removing your username and password.

7. Follow Settings Various settings for Follow/Un-Follow can be found under this tab.

a. Search Limit: Number of users to be searched for. You can set this to 10, 25, 50, 100, 200

or 500. b. Follow Request Delay: Time gap between follow requests. c. Follow only if following count greater than: Followed only if the target user follows at

least X number of people. d. Follow only if profile image exists: Filter based on profile image.

8. Export Settings TweetTwain is capable of exporting tweets real time.

Export Tweet History: All archived tweets will be saved in a comma separated file.

Export Keyword Mentions:

Tweets mentioning your keywords or brands are monitored real time and exported to a comma separated file.

Export Re-Tweets: All re-tweets will be exported to a comma separated file.

Export Mentions: All screen name mentions will be exported to a comma separated file.

Open Data Folder: Click to open the data folder.

Clear Data Folder: Click to delete all export files.

Warning: Keep monitoring your data folder as the storage size may go up depends on your Twitter usage.

9. Automation Settings This setting controls your automated Tweets, Re-Tweets and follow-request frequency.

Low: Default setting, ideal for beginners. Sends less number of tweets, auto-replies and follow requests. Medium: Ideal setting for regular use. Sends moderate number of tweets, auto-replies and follow requests. High: Sends large number of automated tweets, auto-replies and follow requests. Warning: Make sure you monitor your account for couple of days after changing this setting. Sending too many tweets, auto-replies and follow requests may result in your account being suspended by Twitter.

10. System Tray Settings Right-click on the bird icon to view the tray menu.

About: Shows the system and application information

Show: Shows the TweetTwain window if hidden

Hide: Hides the TweetTwain window

Show New Tweets: New tweets will be displayed as per the settings

Show Direct Messages: Shows new direct messages

Always on top: Keeps TweetTwain window on top of all other windows

Exit: Closes TweetTwain

Un-installing TweetTwain

Step 1: Windows: Go to Control Panel->Add or Remove Programs->Select TweetTwain from the program list and click on Remove.

Linux: Go to Preferences->Java Control Panel-> View files. Select TweetTwain from the list and click on Delete.

Mac: Click Macintosh HD > Applications > Utilities > Java > Java Plug-in Settings -> View files. Select TweetTwain from the list and click on Delete.

Step 2: Delete TweetTwain folder from your user home directory.

System Path Variable

Microsoft Windows NT <root>\WINNT\Profiles\<username>

%UserProfile% Microsoft Windows 2000, XP and 2003

<root>\Documents and Settings\<username>

Microsoft Windows Vista and 7 <root>\Users\<username>

Unix-Based [1] <root>/home/<username>

$HOME and ~/

Unix-Derived

/var/users/name

/u01/name

/usr/name

/user/name

/users/name

Linux (FHS) /home/<username>

AT&T Unix (original version) <root>/usr/<username> $HOME

Mac OS X /Users/<username> $HOME and ~/

Support

Feel free to contact us for any help or support. We appreciate your comments and suggestions so that we can improve ourselves. Website: http://www.tweettwain.com Email: [email protected] Twitter: @tweettwain Support Ticket: http://www.tweettwain.com/ostic