Twitli:
Twitter client for Android phones

Version 1.3 Help pages

Tip: click user name for @reply, DM and other options.

Photo settings

Twitli can upload your pictures to your Flickr or Google Photo account, then tweet the url. You check "upload pictures to flickr" or "upload pictures to Google Photo". In the menu, there is an option "take picture". Selecting that menu item makes Twitli show the camera. You take a picture, then Twitli takes the picture and uploads it. The resulting url is appended to the comment you typed with the picture and tweeted to Twitter. In Flickr, photo's are put in your drop box, in Google Photo, Twitli creates its own album in which it puts your photos.

The first time you upload a picture, Flickr or Google will ask you to authorize Twitli for uploading photos.
back to top

Authorize Twitli for your Flickr account

In order to upload your pics to Flickr, Flickr needs to know that you allow Twitli to do so. When uploading your first photo, Twitli sends a request to Flickr and points you to the Flickr website. Flickr asks you to log in (unless you are already logged in) and asks you to press "OK, I'll allow it".
When you reset your phone in a way that Twitli has lost its data, or when you have uninstalled and reinstalled Twitli, Twitli needs to get a new authentication key. This means that after a hard reset of your phone or after reinstallation of Twitli, you may be directed to Flickr authorization again. Probably, Flickr will remember that it has already authorized Twitli so it will not show the "OK, I'll allow it" button, but rather it will tell you that authorization is ok. You then go back to Twitli and continue uploading your photo, which Twitli will then tweet. You just log in to your account, then press the blue button marked "OK, I'll allow it". Flickr will remember your decision. Twitli will be authorized to upload to your account by a code obtained from Flickr. Whenever you want to cancel this authorization, you go to your Flickr account, select the "extending Flickr" and remove Twitli from the list.

If you withdraw authorization for Twitli with Flickr but you don't uncheck the "upload pictures" checkbox in Twitli, Twitli will ask for authorization again the next time you try to upload a photo. Uncheck the box if you don't want to upload. If you don't upload the pictures, you cannot take pictures using Twitli, you have to use the camera in your phone in the normal way.
back to top

Google Photo authentication

In Google, authentication works slightly differently. You need to supply your Google user name - that is, including the gmail.com part - to Twitli, which then logs into your account. Twitli obtains an authentication key from Google, which it can use to upload subsequent photos. back to top

Translation

Twitli uses Google translation to translate tweets in your language - or any language that Google translation supports. Switch on "Use translation" in the UI settings menu to use translation. By default, English is set as the language tweets will be translated to. In the UI settings menu you can change the language to any language that Google supports. When translating, Twitli will first detect the language of a tweet, then translate it if it is not your language - or not the language that you have selected tweets should be translated to. Please realize that if you get a lot of tweets in foreign languages, loading tweets will take some time because of the translation process. In that case, it's best to set the number of tweets that are loaded to a low value. You can fine tune the translation process in "advanced language settings". Also, in the user menu - which you get by clicking a friend name - you can set the language for that particular friend. This will save time because Twitli doesn't have to detect the language.
back to top

Advanced language settings

If you are bilingual or even multilingual, you probably want to see tweets in languages that you know untranslated. In "advanced language settings" you can select additional languages that Twitli will not translate. If your native language is Chinese, but you also speak Japanese and Spanish, the main language will be set to Chinese, while Japanese and Spanish will be selected in "select additional languages". All tweets will be translated to Chinese, except tweets in Japanese and Spanish - and tweets in Chinese of course. Presumably, the remaining tweets that need to be translated will be few.

Google detects the language of a tweet, and it provides a confidentiality factor. The more certain Google is about the language, the higher the confidence factor. By default, Twitli will assume that a tweet is in a particular language if the confidence factor is 0.1 or higher. This means that languages of most tweets is diagnosed correctly. Twitli will also attempt to set the default language for a user. Knowing in what language a user tweets makes the translation process faster because it eliminates the language detection phase. Twitli will set language for a user if the confidence factor for a particular tweet is 0.5 or higher.
You can experiment with these settings, although we recommend to keep the default settings. A confidence factor ranges from 0 to 1.0.
back to top

Account settings

In "Set Twitter credentials" you specify your userid and password for Twitter. Twitli needs these in order to log into your Twitter account and download timelines and upload your tweets.
back to top

Auto refresh

Twitli can automatically refresh the timeline on your screen every three minutes. Check the "auto refresh" checkbox in "settings".
back to top

Timeline

Under "Timeline" you select which messages you want to see: your friends timeline, your direct messages or @replies sent to you.

If you want to see the tweets from a particular person, you click that persons name on the screen and select "view thispersons messages". If auto-refresh is on, Twitli will reload the current timeline, that is, it will reload the @replies, direct mesages or statuses, whichever is displayed. You will notice that switching between direct messages and one of the other screens is almost instantaneous. This is because Twitli always loads direct messages at the same time it loads the timeline. If a new DM has come in, Twitli will notify you by displaying "DM!" in the title bar.
back to top

Follow

This menu option gives you a list of all twitters that are mentioned in the timeline on your screen. To follow one of these, just select one and Twitli sends a "Follow" message to Twitter. You can follow one person each time you select "follow". To stop following, select "stop following" in the user menu.
back to top

Back channels

In Settings, you can specify one or more channels you want to tweet to. Twitli keeps appending these channels to your tweets until you specify other channels or no channels. In an @reply, the channel will not be used.
back to top

User menu

When you click on a user's name, a menu is shown. The first line is the users name, if provided by the user. The next options are "send reply to user" and "send direct message". With these you send an @reply or direct message to this user. Don't include their screen name, Twitli automatically prepends the screen name to the @reply.
"Stop following" will cause you to stop following this person.

If translation is switched on, you will see an additional option in the user menu: "language settings". Here you can set the language for that user. The current language for this user is displayed below the user name. This language was set by you or detected by Google. By selecting "let google detect language" you reset the language for this user, making Twitli set the language again by using Google language detection. Alternatively, you can switch off translation for this user.
back to top

User interface settings

You can set the number of tweets on your page, ranging from 3 to 200 - which is the maximum number Twitter allows. Reloading 200 tweets does take time, so don't set this to more than 30 unless you specifically want to see all those tweets. You can select if you want to see pics in portrait view. Not showing pics makes room for more tweets on your screen.
back to top

Exiting Twitli

Twitli does not have an "Exit" button. You should exit Twitli by using the back button of your phone. If you use that button while the Twitli screen is displayed, Twitli will exit, leaving a notification icon in your status bar. Clicking the icon will re-open Twitli. The icon does not necessarily mean that Twitli is running in the background or is using memory. When you close Twitli, it closes. You can check this by re-opening Twitli using the icon: if Twitli needs a couple of seconds to load your tweets, it was not in memory. Only if you "exit" Twitli by opening a link from a tweet, Twitli will remain active while displaying the notification icon in the status bar. When you click the icon, Twitli will re-open and load the timeline instantly. If you want to fully exit Twitli, close the screen, then use "remove notifications" to remove the icon.

The reason for not having an exit button is the following. The Android operating system organizes the applications in your phone. It unloads an application when another application needs to become active and it restores an application that was active before, when an application is closed. Using the standard exit or back button will cause Android to properly stop an application and close its databases and other resources.
back to top

Map

Use the scroll wheel to zoom in or out.
The map shows you - as a red and black dot - and all tweeps that are in your currently displayed timeline. Tap the map if more than one tweep is in one location. Tweep locations are refreshed not more often than once per minute. This means that when you leave the map and click "Show map" within one minute after the previous time, you'll get the same map, fast.
back to top