The Iconfactory

Twitterrific for iPhone and iPad

Twitterrific for iPhone and iPad

Universal - runs on iPhone and iPad! Available separately for the Mac.

Media Upload

Setup

Overview

Twitterrific offers several built-in choices for uploading photos and video to attach to your tweets. There are many other services than the ones that are provided by default. You can setup one of these services as long as it fulfills the requirements listed below.

An example

The first step is to determine the Media Service URL Endpoint that is used to upload the image. Many services have documentation that provide that information. For example, Gdzl.la is a service that lets you upload images to your Flickr stream. Here's how you'd set it up:

  1. Open http://gdzl.la in your web browser.
  2. Provide your username and password for your Twitter account. You should use the same ones you entered into Twitterrific. Click "Authenticate".
  3. The next step is to allow Gdzl.la to access your Flickr account. Click "Authorize" and the "Allow" after visting the Flickr page. Some services don't require this step.
  4. You'll now see "https://gdzl.la/go" displayed as the URL endpoint. Make note of it, because you'll need to use it to setup Twitterrific.

Now that the service is setup, you need to configure Twitterrific:

  1. Launch the application and tap on the Compose button in the upper-right corner of the screen. In the window that appears, tap on the camera icon and select "Change Upload Service".
  2. At the bottom of the list that's displayed, you'll see "Other...". Tap that and you see a text field where you can specify the "Media Service URL Endpoint". Enter "https://gdz.la/go" and then tap outside the popover window to dismiss it.
  3. To upload your photo, tap on the camera icon again and select "Choose From Library". Select the image that you'd like to use and it will be uploaded to Flickr using Gdzl.la.

Services

Here are some other services that have been tested and are known to work correctly with Twitterrific:

  • Gdzl.la is a service that lets upload pictures to your Flickr stream.
  • Stepcase (English or Chinese) is a service that's popular in China.

Requirements

Twitterrific uses OAuth Echo to post the image or video to the site using the Media Site URL Endpoint configuration value entered above. Along with the image, the following parameters are sent in a POST:

  • source — The string "twitterrific".
  • message — The text entered by the user before uploading the photo. It may be an empty string.
  • username — The user's screen name.
  • media — JPEG image data or MP4 video data. The Content-Type is either "image/jpeg" or "video/mp4".

In addition, the HTTP header includes two fields for OAuth Echo:

  • X-Verify-Credentials-Authorization — An OAuth Authentication header in the following format. The XXX parameters are URL encoded:

    OAuth realm="http://api.twitter.com/", oauth_consumer_key="XXX", oauth_signature_method="XXX", oauth_token="XXX", oauth_timestamp="XXX", oauth_nonce="XXX", oauth_version="XXX", oauth_signature="XXX"
  • X-Auth-Service-Provider — The Twitter API endpoint used to verify the user's credentials: https://api.twitter.com/1/account/verify_credentials.json.

URL Schemes

URL schemes can be used by other applications to communicate with Twitterrific. The following resources are supported:

Current account

The last account used in Twitterrific will be used to perform the operations specified in the URL.

Open the application:

twitterrific://
twitterrific://current

Open the application with the selected view:

twitterrific:///tweets
twitterrific:///mentions
twitterrific:///messages
twitterrific:///favorites
twitterrific:///search?q=escapedString

twitterrific://current/tweets
twitterrific://current/mentions
twitterrific://current/messages
twitterrific://current/favorites
twitterrific://current/search?q=escapedString

Open the application and begin composing message:

twitterrific:///post?message=escapedString
twitterrific://current/post?message=escapedString

Selected account

The specified account will be used to perform the operations specified in the URL. If the "screen_name" doesn't appear in the account list, the current account will be substituted.

Open the application:

twitterrific://account/screen_name

Open the application with the selected view:

twitterrific://account/screen_name/tweets
twitterrific://account/screen_name/mentions
twitterrific://account/screen_name/messages
twitterrific://account/screen_name/favorites
twitterrific://account/screen_name/search?q=escapedString

Open the application and begin composing message:

twitterrific://account/screen_name/post?message=escapedString