Frequently Asked Questions

Why do I need this app? Aren't there already great Twitter clients?

Tweet Keeper is not a Twitter client like the official Twitter client, TweetBot, Twitteriffic, or any of the other excellent Twitter clients for iPhone. Tweet Keeper's purpose is to permanently save tweets for specific accounts. It focuses on saving tweets for fast searching and archiving. These are not functions that Twitter.com supports, or third-party clients.

Can't I search for tweets on Twitter.com?

No, Twitter's search function doesn't allow searching the timelines of a user's full history.

What exactly do you mean by "tweet?"

In Tweet Keeper, "tweet" refers to the status update posted by a particular account. This includes replies and retweets. It does not include mentions, or media the tweet links to, such as images, video, or URLs.

Do I have to launch Tweet Keeper to save the tweets, or can it happen automatically in the background?

Apple doesn't permit apps like Tweet Keeper to perform automatic downloads in the background, so you need to periodically launch Tweet Keeper to update the accounts.

How do I export the saved tweets?

Tap the account in the Account view to load the tweets for that particular account. When the tweets for that account have loaded, tap the "action" button (in the lower right) and select "Export Saved Tweets". Select to export them in plain text, spreadsheet, or JSON format. The exported data can then be emailed, printed, or opened in /transferred to another app on your iPhone that can open files of the TXT or ZIP file type.

What export formats are supported?

Currently, saved tweets can be exported as plain text, as a spreadsheet, or as a JavaScript Object Notation (JSON) archive. These formats are open standards. Plain text is easily readable on all platforms and is a safe format for long-term storage as well as a format that's easy to use in other programs. JSON is an open standard, also stored as human-readable plain text, but suitable for data interchange with other programs.

Exporting as plain text includes the tweet's text, date, location (if geo tagged), and optionally the link to the tweet's source on Twitter. Exporting in spreadsheet format produces a tab-delimited text file that can be imported into spreadsheet programs, such as Microsoft Excel and Apple's Numbers. The archive of JSON data is a single zip archive with each tweet saved as a text file in the "raw" JSON format. This is the exact and complete data that is returned from Twitter and is meant to be parsed by another program. More information is on Twitter's Developer API documentation.

Tweet Keeper only downloaded 3200 of my tweets. Why not all of them?

At this time, Twitter only allows downloading the most recent 3200 tweets. After those 3200 tweets are saved on your device, new tweets will be added to your local archive and there is no limit. Note that Twitter counts retweets, replies, and deleted tweets in this total.

Why didn't Tweet Keeper download 3200 tweets even though Twitter says I have more than that?

When downloading the history for an account for the first time, sometimes the Twitter network can be unreliable and sends incorrect response data. The best thing to do is to delete your account, and add it again. This will trigger downloading your history again. Note that you should get approximately 3200 tweets (or the total that Twitter states). Twitter sometimes counts deleted counts in that total, so the exact number may vary. If you still have problems downloading the history, Twitter may be experiencing network difficulties so try re-adding the account later.

Is there a limit to how many accounts that I can add?

Yes, eight. Tweet Keeper currently limits the number of accounts to eight to optimize performance and abide by the Twitter Terms of Service. Tweet Keeper is designed for personal use to backup your own tweets and/or the tweets from a select group of users.

Are the images and videos of tweets also saved?

No, Tweet Keeper saves the status updates ("tweets") only from users' timelines. Status updates don't actually contain images or videos, but only links to the them. Tweet Keeper saves only the tweets. You can click on any saved tweet to see more detail, including fetching online content, such as images, videos, and links.

Why do I have to click to see the conversation and/or images related to a tweet instead of having everything in one view?

Tweet Keeper tries to make it clear what is actually saved on your iPhone and what is stored online. Including saved and online content in the same view blurs this distinction.

Why don't I see the correct profile image?

If a user's profile image, user name, or screen name has changed, you can force Tweet Keeper to update the account settings by clicking in Settings --> Advanced --> Refresh Account Information. This will refresh the account information for all accounts.

Can I open saved tweets in another app on my iPhone?

At this time, Tweet Keeper supports opening any saved tweet in TweetBot and the official iOS Twitter client, as well as mobile Safari. Not all Twitter clients have a URL scheme that supports opening a specific tweet ID which Tweet Keeper requires in order to support.

When searching, are all tweets searched, or just those currently visible in the table view?

All tweets saved to the device for the selected account are searched, not just those that are visible.

Something weird happened. I don't see some tweets that were saved before or the status count is wrong.

Sometimes Tweet Keeper's database can get corrupted if it was processing tweets and the app is forced to quit (intentionally or not). Rest assured that the original saved tweet on the device is not altered. You can force Tweet Keeper to rebuild its database by selecting Settings --> Advanced --> Rebuild Tweets Database. Note that this may take considerable time if you have a large amount of tweets saved to the device.

How can I backup my tweets in Tweet Keeper in case my iPhone is stolen or stops working?

Enable iCloud or sync your iPhone with iTunes. See Apple's article on Optimizing your iOS backup experience to ensure your iPhone's data is backed up and can be restored.

When viewing tweets with images, why are they sometimes listed under "Media" and sometimes under "URLs"?

Photos and videos using Twitter's official image service are listed under "Media". Other services are listed under "URLs".

Can I put my tweets in Dropbox?

Yes. First make sure you have the Dropbox app installed on your iPhone. Then, just export the data as either plain text or JSON. After exporting plain text, tap the "Preview, Open, Print..." button to open a preview, and then tap the Action button in the top-right and select "Open in Dropbox". After exporting an archive of raw JSON, tap the "Open in..." button and select "Dropbox".

Will there be an iPad app?

There is now! v2.0 and above is a universal app, so the same app will run on your iPhone and iPad.

I keep getting an Error message that I may have reached my hourly Twitter limit. Why?

Twitter limits how many requests a user can make per hour. This message is usually displayed when the limit is reached. Occasionally, this message may be shown if there is another issue on Twitter's end. In very rare circumstances, if this error is repeatedly displayed and accessing Twitter through other clients works, restarting your device should solve the problem.

I added a private account and nothing happened. I just see an error symbol. Why?

For protected (private) accounts, you can save your own tweets, or those from an account of which you are an approved follower. To save the tweets of a protected account, Tweet Keeper must use an account stored in your iPhone's Twitter Settings. First, make sure the account is listed in your iPhone's Twitter Accounts (located in the Settings app). Also, make sure you grant Tweet Keeper access to your Twitter Accounts if you are prompted. Finally, after making sure of the above, try hitting the update button in the lower-left of the main Accounts page of Tweet Keeper. If you still get the error symbol, tap on it (the actual symbol), which should bring up a list of Twitter accounts on your phone, and select your account.

Something else?

Didn’t find what you need? Please email tweetkeeper.support@gestell.org.