Installation procedure:

  1. Click this link and complete the online registration form
  2. Save the Chorus_Setup file to your local disk. Ensure you are logged into Windows using an account with administrator access. Right click on the setup file and select “Run as Administrator” to start the installation process. For full functionality it is recommended that you install Chorus to a folder that has no spaces in its path (e.g. “C:\Chorus”, not “C:\Program Files\Chorus”)
  3. Scroll down this page and download the latest release of both TCDE and TweetVis. Copy both files to your Chorus folder and rename them to TCDE.exe and TweetVis.exe respectively (i.e. replace the existing executables).
  4. Download and install a set of programs called GraphViz. The recommended version (v2.38) can be downloaded here. Just extract the bin folder from this zip file and save it to your preferred location (e.g. “C:\Graphviz”). You should then input the full path to this folder (e.g. “C:\Graphviz\bin”)  in the Set Paths box on the Tweetvis Start tab.
  5. The final step is to read the user guides which can found here.

User Guides

User guides are not included in the main installer. The latest guides can be found here


Users of Windows 8/10 (and possibly some Windows 7 users) might find that their first attempt to run Chorus after installation is met with errors reporting files (dll, ocx) not being registered. On our test PC, this seems to be easily resolved by right clicking each of the program icons (Tweetvis and TCDE) in turn and selecting “Run as Administrator”. You should find that you only need to do this once for each program and that both will run properly from thereon with the usual double-click. If the problem persists, you should go into the program icon properties (right-click -> Properties), select the “Compatability” tab and check the “Run this program as an administrator” box.

Some users have also reported problems with sentiment scores defaulting to zero. This is usually because Java has not been installed on their computer. Java is not always installed by default on a new PC. To download the Java Runtime (JRE) go to and follow the instructions for installation.

Updates and release history

The latest version of TV is 1.8.7 and the latest version of TCDE is 1.4.0. These are likely to be newer than the versions included in the installer package. You can check your versions by checking the About menu in TCDE and the title of the main TV window. Links to all versions (exe only) are shown below. To update, just delete the old file and copy the new file. To ensure any short-cuts remain operational, you should edit the file name to remove the version number e.g. Tweetvis1.8.7.exe -> Tweetvis.exe.

  • 20/01/21 TCDE 1.4.0b – Small update to Tweetcatcher which will now  wait and either retry or fail gracefully (without data loss) in the event of a network connection problem.
  • 28/02/20 TCDE 1.4.0a – This revision of TCDE has been updated to support full length tweets using the extended tweet_mode parameter provided by the API. Please try this as a direct replacement for your existing TCDE and be sure to let us know if anything isn’t working correctly by emailing
  • 26/06/19 TCDE 1.3.2 – Some minor bug fixes to Tweetcatcher.
  • 28/09/17 Tweetvis 1.8.7 – this is maintenance release which fixes several bugs relating to data file loading and pre-processing. Please replace any older versions with this one.
  • 14/12/15TCDE 1.3.1 – this is a maintenance release which fixes several bugs including timelines not going back the the specified date, strange behaviour when pasting items to the user list, crashes when clicking on a empty history menu, profile data not being retrieved when adding a single user, crashes when attempting to filter an empty tweets table, various status reporting errors.
  • 28/08/15 TCDE 1.3.0 – this release incorporates many bug-fixes, new functions and usability improvements. Problems with tweet truncation, non-UK date formats and Unicode characters have been addressed. Many new features available to extract user lists, navigate and filter tweet content and manage data collection projects. See the release post for more details.
  • 06/11/14 Tweetvis 1.8.5 – this new release contains some small but useful updates, mainly to do with the Cluster Explorer. A new function for node scaling creates a more balanced, legible view. Edges between nodes are now coloured grey to create a less cluttered/dense image without loss of information. The word map now offers finer control over the label filter and also the facility to manually increase/decrease the size of nodes. The menu bar has been reorganised such that main timeline functions come first, followed by the term timeline. The user now has has a choice of visual encodings by which to represent the term timeline. There is also improved semantic clustering of nodes in the interval and tweet cluster views.
  • 22/10/14 TCDE 1.2.5 (beta) – this latest release contains numerous bug fixes and new features. Fixed the problem where Search no longer works after previous retrieval terminated at historical limit. Time to next quota reset (shown in status bar) is now shown in local (correct) time. Retweets can now be automatically removed via the Actions menu. The user list in User Timelines can now be populated automatically with followers/friends of a specific user (see User List menu). These functions output a more comprehensive user table (including friend/follower/status counts, location, language etc.) to the clipboard which can be processed in Excel to produce filtered lists that can be pasted back into TCD for timeline download. Failed requests, which can occur on high volume sessions and would truncate the timeline, can now be seamlessly re-sent/resumed. There is now an option to set Search language (defaults to English – en) in the Settings menu. Cancelling a retrieval is no longer handled by a button, but via the Actions menu. This is currently a beta release and so may still contain bugs. Please let me know if you find any.
  • 7/1/14 TCDE 1.2.4 (stable) – fixed bug where attempting to open a file caused the application to close. Also tidied up the UI layout slightly and added tool-tip help descriptions to UI controls.
  • 31/12/13 TCDE 1.2.3 – security update to prevent user’s consumer secret being read and/or copied from the About box. For checking purposes, user can briefly view the first few characters of the secret by clicking the Show button, but it is no longer possible to select/copy the whole string from this box.
  • 15/11/13 TCDE 1.2.2 – fixes problems with duplicates being retrieved when updating. Added functions to Actions menu to convert date-time field to Excel and SPSS compatible formats (and back again). List for User Timeline retrieval can now comprise either userid (numerical) or screenname (string) values. 
  • 29/10/13 Tweetvis 1.8.3 – fixes various bugs, including out-of-bounds errors sometimes occurring during indexing and computation of word term visualisation.
  • 04/10/13 Tweetvis 1.8.1 – corrects a bug where TV would fail on start-up with an Error 380 code.
  • Tweetvis 1.8.0 – the original TV release version

Leave a Reply