Main Window

The main window is mostly comprised of the tweets list, filters list, the toolbar, and a menu; this is where most of the time is spent directly working with the tweets.

  • Menu
  • The menu contains all functionality separated into categories, typically along the top of the window.

    • File
    • General file-related features.

      • Backup & Restore
      • The entire Twitter Delitter configuration - or parts of it, selectively - can be backed-up to a file for safe-keeping. The back-up is highly compressed and could take a few seconds to complete if you have a particularly large set of tweets. Restoring a back-up will restore everything and require a restart of TD to complete.

      • Export Shown As
      • Select any sub-items will save the visible tweets to a file in the format specified.

      • Exit
      • Exits Twitter Delitter, causing any in-progress actions to cease. This will also exit TD even if system tray support is enabled; to minimise to the tray, simply minimise the main window.

    • Tools
    • Extra features.

      • Tweet Score
      • Opens the Tweet Score window so you can view, edit, and create new Score Rulesets to score your tweet archive according to certain critera. See the Tweet Score section for more information.

      • eBooks
      • Opens the eBooks window so you can generate tweets based on your tweet history, and create entirely new tweets. See the eBooks section for more information.

      • Options
      • Opens the Settings window so you can customise certain aspects of Twitter Delitter. See the Options section for more information.

    • Twitter
    • Features relating to the Twitter service.

      • Login / Logout
      • You will need to allow Twitter Delitter access to your Twitter feed so it can delete any tweets that you have queued. Twitter and Twitter Delitter itself uses a method called OAuth to access your feed so that applications (such as Twitter Delitter) do not see your password but instead are issued a token that you can revoke at any time.

        This Login button will change depending on if Twitter Delitter is authorised to access your account; the button will change to Log Out, and clicking it will cause Twitter Delitter to log you out from the Twitter site.

        Either prompts Twitter Delitter to log into your Twitter account or log out of it if it's already logged in. To be able to log in, you will need to have granted TD access to your account via the Authenticate window (accessed via this Login menu item).

        Information

        The very first time you go to log in, you'll be presented with the Authenticate window which'll guide you through the required steps of granting Twitter Delitter access to your account.

      • Purge Credentials
      • If you've already granted TD access to your Twitter account but would like to revoke said access, then selecting this item will ask you to confirm that you would like to entirely purge your Twitter credentials. Please note that you'll need to go into Twitter itself to revoke the actual access token that TD uses.

      • User Information
      • If you're currently logged in, this will display some information regarding your Twitter account. Please note that the User Information section is currently incomplete.

      • Import Twitter Data
      • Before Twitter Delitter can display your tweets, you will need to import them into the application. This can be done by going to your Twitter account and downloading your tweet archive. Once downloaded to your computer (you will receive an email from Twitter containing a link to it), use the the window that opened when clicking on this toolbar button to import it.

    • View
    • Fings wot u view, innit.

      • Rate Limit
      • Opens the Rate Limit window which shows information on Twitter's rate limiting. When an application interacts with the Twitter site, it has certain limits imposed upon it just in case said application uses a lot of Twitter's resources. These limits come in the form of rate limiting of various abilities, such as how many times the application fetch a user's account details or perform a search (note: all searches within Twitter Delitter are performed locally; Twitter itself is not used for searching your tweet archive).

        You can generally ignore rate limiting while using Twitter Delitter; this view is mainly available for the author for testing purposes and for anyone that should be interested in such technical details.

      • Queue
      • Displays the Queue window which is used for performing the actual deleting of any tweets that have been queued for, er, deletion.

      • Log
      • Displays the application log for diagnosing problems or if you're, like, interested in that kinda thing, da dig?

    • Help
    • Twitter Delitter documentation, application information, and various relevant website links.

      • Online
      • Links to various relevant resources that you may require or find interesting.

      • Documentation
      • Launches the system's web-browser to view the online Twitter Delitter documentation. Hint: Hello!

      • Check for Update
      • Performs an update check to see if there is an updated version of Twitter Delitter available.

        Information

        A simple web-request is performed and only your IP address is temporarily recorded as a side-effect of the way websites work. Other than your IP as stated, no identifiying information is sent other than the version number Twitter Delitter so it can be compared.

      • About
      • Displays application information and relevant links.

    • Search
    • Allows you to enter text to search for within the available tweets. Regular Expressions are supported. Clear the text to show all tweets again.

      If the Settings - Tweets - Remember search queries ... option is enabled, then any entered search queries will be added to the Search drop-down menu for later recall.

      Tip

      The search text is remembered across sessions and is so applied at next application startup. Press Ctrl+F to activate the search textbox.

  • ToolBar
  • The ToolBar contains commonly-used functionality.

    • Add Checkmarked Tweets to Deletion Queue
    • Any tweets with a checkmark next to them will be added to the Queue for deletion.

      The Queue can be opened by either pressing Ctrl+Q, selecting Queue... from the Tools menu, or by clicking on the Queued link at the bottom-right of the window.

      The Queue and tweet deletion isn't support within the Free edition of Twitter Delitter.

    • Tweet Score
    • Opens the Tweet Score window; the same as clicking on the Tools - Tweet Score menu item, above.

      Warning

      The Tweet Score window does not need to be opened in order to score your tweets; simply click on the drop-down arrow and select the Ruleset to run against the tweets. The Tweet Score window contains the actual text used for scoring a wide range of tweets and contains language that will offend.

      • Reset Scores Before Run
      • When a Ruleset is about to be run, enabling this option will clear all tweets' scores back to zero. This prevents Rulesets compounding each others' scores and protentially be misleading.

      • Hide Unscored Tweets
      • After a Ruleset has been run, enabling this option will cause Twitter Delitter to hide any tweets that have a score of 0 (zero) as zero-scored tweets have typically not been affected by a Ruleset. To get back to the normal view, click on the Leave Score View button on the right of the ToolBar when it appears.

        Zero-Scoring Tweets

        A tweet with a score of zero does not always mean that it scored zero after a Ruleset run; Rulesets can contains Rules that either increment or decrement a tweet's score. If a tweet's score is incremented, then it could be decremented back to zero and thus would make it look like it wasn't affected by the Ruleset when in actual fact it was.

      • View Matched Results
      • Opens a window that shows the currenly selected tweet's Rule matches. This helps Ruleset authors know which Rule a tweet was affected by; helpful when a match has occurred when it possibly shouldn't have.

        Matched Results Viewer

        The viewer will be completely redesigned in a future version of Twitter Delitter to provide further in-depth features for debugging Rulesets. A task is available in Tracker.BootBlock.co.uk for the status of this change.

      • Run RuleSet...
      • Runs the specified Ruleset against your tweet archive, scoring each tweet based on specific criteria within that Ruleset. For example, running the Swearing Ruleset will score tweets higher based on their "swear word" content.

  • Filters
  • The Filters list is generated in realtime when your tweets archive has been loaded. Various filters are created based on the data within the archive, such as Twitter clients used for posting tweets, the years tweets were posted in, and more. They are then listed in the Filters list and can be toggled by placing a checkmark next to them.

    The Search Tweets... textbox at the top-right of the window can also be used for filtering; please be aware that it is case-sensitive.

  • Tweets
  • The Tweets list contains all of the tweets that were found within the imported tweet archive, minus any tweets that were removed via purging (purging a tweet removes it from the Tweets list entirely but keeps it on your live twitter feed), deleting via the Queue, and the current filtering options.

    Placing a checkmark next to a tweet and clicking on the Add Checkmarked Tweets to Deletion Queue button will add all checkmarked tweets to the Queue and colourise them in red as well as striking-through the text to highlight that it is queued for deletion.

    You can also right-click on tweets and select Add to Queue and that will only add the tweets that are highlighted, and not checkmarked. Right-clicking on any tweets that are already in the Queue will then change the menu item to Remove from Queue instead.

Keyboard Shortcuts

Unless stated otherwise, these keyboard shortcuts are global to the entire window; pressing them regardless of which control is active will cause them to trigger.

  • Ctrl+F
  • Activates the Search textbox at the top-right of the window.

  • F1, Help
  • Displays this page of the online documentation.

  • PrintScreen, Snapshot, F12
  • Creates a screenshot of the window and copies it to the clipboard. A system beep can be heard if the copy was successful.