Release Notes - VUE 3.0

VUE is a desktop concept and content mapping application. It enables users to graphically represent relationships among ideas, images, digital assets, and documents. These items can be located locally or remotely.

What's new in 3.0?
  • Data discovery and exploration tools
  • Data clustering
  • New image handling architecture
  • SEASR integration
  • Zotero integration
  • VUE applet
  • Layers
  • Additional Resource Plug-ins such as YouTube and NewYork Times Archives
  • Map-Based Searching
  • Semi-automatic mapping (supports CSV files and basic clustering)
  • VUE is now available with complete translations for French, Portuguese, Greek and Italian, and partial translations for Bulgarian, Chinese, German, Hungarian, Russian and Spanish.
  • Searches can be saved
  • Imporved multi-monitor presentation and full screen support.

Installation Instructions

For Microsoft Windows
The current VUE distribution for Microsoft Windows is provided as a Nullsoft installer. Earlier versions (pre-2.3.1) of VUE were created by Installanywhere. We recommend that you uninstall the earlier version of VUE and then simply run the new installer executable to install VUE. If you encounter any problems please post it on the : VUE Forum

For Mac OS-X
The VUE distribution for OS-X is provided as an application bundle. After downloading and extracting the zip file, simply drag to your applications folder to install VUE.

Beginning with VUE 3 we now have two builds for Mac OSX, we've added a Java 6 build of VUE for Leopard (10.5) and Snow Leopard (10.6) which uses a more aggressive heap to better handle large image and data sets. While not necessary for all users, if you're having Out of Memory problems with VUE we recommend you try out this build.

For Linux/Unix

The Linux version of VUE is distributed as a jar file.

Linux users may need to install a different Java runtime package on your system.

Run "java -version" in a terminal window. If it reports that "gij (GNU libgcj) ..."is installed, you are running GNU Java. The GNU Java libraries don't currently offer sufficient graphics support to run VUE. While it's outside the scope of this document to provide instructions for installing Java support on Linux/Unix, Sun Microsystems makes Java runtime environments freely available on its website:

The /Library/OsidProviders directory doesn't exist by default on Linux/Unix systems; you will need to create this directory and set its permissions. This directory supports the "Enhanced Data Sources" feature. If you won't use this feature, you don't need to create the directory.

The ability to make these changes to your system requires system access privileges that you may not have. The following instructions presume you have root access to your system.
1. Open the terminal application
2. enter this command to create the directory:
sudo mkdir -p -m 775 /Library
sudo chown user:group /Library

* The system will probably prompt you for the root password

If you are running a VUE 1.5 version, we recommend flushing your installed data sources before installing the VUE 2.2 release. See the topic in Troubleshooting below for instructions.


Known Issues & Tips

If you encounter problems with VUE, please inform us by posting them to our forums section. You can also email us directly at, though we recommend the forums because more people will see the issue, increasing the pool of potential responders. Posting issues to the forums also builds the body of information available to the VUE user community.

  • VUE 2.2 files are not yet fully compatible with earlier versions of VUE. This most directly impacts the positioning of "grouped" objects. It is recommended that changes made to older maps with VUE 2.2 be saved under a new file name.
  • Images acquired from online resources cannot be viewed reliably without Internet connectivity.
  • Due to a known JVM 1.5 bug some dual-monitor configurations result in crashes within VUE
  • Configuration information for resources may get corrupted. You can change it by double clicking the resource.
  • Dropping an image onto an existing image within the Slide Viewer will result in the creation of a nested node. If you would like only to add the resource -- the image alone -- drop the image adjacent to existing slide resources.
  • Use the Save As > VPK (VUE Package) option for sharing VUE maps along with embedded, local files.
  • Based on user feedback the VUE menus have changed to facilitate access to all VUE tools and windows.


Some problems with loading resources can be solved by removing and reinstalling your resources.

Instructions for Removing Installed Resources
Installed resources and their configuration are stored in two locations in your local file system. The names of these directories differ depending on your operating system.

For Windows
Following these steps will delete all your resources and their associated configuration information. You will have to re-enter access keys and passwords just as you did when you first added the resources.

Step 1: Removing resources
Individual resources are stored under the C:\Library\OsidProviders directory.

Delete the C:\Library\OsidProviders directory.

Step 2: Removing configuration information
Configuration information is stored in the vue_2 directory in your home directory, usually C:\Documents and Settings\<YourUsername>\vue_2.

Delete these files in your C:\Documents and Settings\<YourUsername>\vue_2 directory:



For OS-X
Following these steps will delete all your resources and their associated configuration information. You will have to re-enter access keys and passwords just as you did when you first added the resources.

Step 1: Removing resources
Resources are stored under the /Library/OsidProviders directory.

Navigate to and delete the /Library/OsidProviders directory. (Mac users can find this folder in their Finder under Macintosh HD)

Step 2: Removing configuration information 
Configuration information is stored in your ~/.vue_2 directory. Since the directory name begins with a period, you will have to open the Terminal application to delete these files. (The Finder doesn't display items that start with a period.)

Open the Terminal application by opening Finder and navigating to Applications/Utilities.

Double click Terminal to open the application.

In the Terminal, type each of these commands, following each by pressing the "return" key.

rm ~/.vue_2/InstalledDatasources.xml
rm ~/.vue_2/Datasources.xml

For Linux
If you have problems installing resources or saving preferences, you may need to run VUE with the sudo command: If you installed with the .bin installer: sudo ./vue otherwise: sudo java -jar VUE.jar


Please post your comments on VUE 3.0 on the VUE Forum or send them to

Feb 3, 2010 / VUE 3.0

Release Notes - vue - Version 3.0 Final (November 2009) since 12/15 beta release

VUE-1663 Curved links shouldn't draw lines to their control points when the browse tool is in use.
VUE-1659 pruning adjustments broken after re-opening pruned map
VUE-1656 Seach: LINK > Do not cluster results. Leave where they are.
VUE-1654 Moving a node or link to a different layer doesn't mark the map as modified
VUE-1651 Several search bugs
VUE-1650 Search: not possible to use autozoom on search results
VUE-1649 Search: issues with zoom level
VUE-1647 slide: add node containing an image to slide. Image is squished and added twice. Image label shows up 3 times
VUE-1644 saved search problems
VUE-1638 Implement zoom rules
VUE-1637 RSS feeds no longer display images
VUE-1634 "Delete dataset" confirmation window opens in lower left corner of screen
VUE-1630 Expand / Shrink Selection: Remembers depth of selection when clicking away from selection
VUE-1593 Ontologies Link: Cannot drag link to map. Can only r-click to add to map
VUE-1579 Pruning: Save pruning to map, so it persists between sessions
VUE-1577 Pruning: Allow to turn pruning off, without loosing pruning.
VUE-1498 Layout: as layouts are performed, do not zoom in to fit map
VUE-1493 Layout: combine "Push Out" and "Stretch"
VUE-1490 localization? Text in "Upload to Repository" window is gone
VUE-1489 BROKEN! Menu file > import dataset > choose image folder: nodes are bright green. Should be node default color.
VUE-1483 make data lists: doesn't work with multiple selection
VUE-1456 When the app is resized to be narrow the quick-search field becomes obscured
VUE-1418 Category+Keyword search doesn't work?
VUE-1362 Memory: can't display images in map
VUE-1246 when changing screen resolution, a new map was created
VUE-1240 error when opening rdf file
VUE-1233 Color palette drop down and multiple monitors
VUE-1113 Recluster on map based on keywords
VUE-1067 on print, font looks very different from screen
VUE-885 new functionality + menu item "Undo All Pruning" (to reset map after pruning)
VUE-800 formatting palette default location

Older Release Notes:

VUE 2.3.1 Release Notes
VUE 2.1 Release Notes