Jalview development and support is funded by a grant from the UK BBSRC. We are currently seeking renewal of this grant and letters of support are critical to the success of this renewal. If you find Jalview useful, please take a few minutes to write as soon as possible and tell us how you use Jalview and how important it is to your work!

Letters of support, ideally as a PDF on headed paper or as plain text should be sent to: support_jalview@bartongroup.org

  • You need a computer that can run Java 1.6 or later to run the full Jalview application (unfortunately this excludes users with older Macs - sorry). If java is installed, then the 'Launch Jalview Desktop' link at the top should work (if your browser asks you to save the application-x-jnlp file or choose an application to run it with, look for 'Java Web Start', or locate your java installation directory and look for the javaws binary). You can also go to the Install Anywhere Web Installer download area area to get an installer for your platform.
    If you don't have Java 1.6, but do have Java turned on in your browser, you can try the web based version of Jalview - JalviewLite - right now by going to the applets page. The web based version doesn't let you print or access web services, but includes most of Jalview's core functionality.

  • Use the Mouse

     

    Use the cursor keys

     

    Edit Selected Region Only

     

    Press F2 to enter Keyboard Mode

  • Right-click on the consensus histogram and select "Copy consensus sequence".

  • You may be using a keyboard which has visual / audio settings mapped onto the Function keys. You must press the "Fn" key, together with F2 key to toggle Cursor Mode. 

  • Yes, a quick reference PDF for an early release of Jalview 2 is here, but we haven't updated it for a while.

  • Versions of Jalview released before November 2012 did not include any special support for scoring or visualizing nucleotide sequences, although they could read, write and manipulate DNA and RNA sequences, and calculate a consensus.

    Version 2.8 of Jalview was the first release to include special support for nucleic acid sequences, and included a substitution matrix that copes with both RNA and DNA symbols which can be used to calculate trees and principal component analysis plots from alignments. Nucleotide base pair patterns provided as WUSS or VIENNA dot-bracket annotation can also be visualised, and used to calculate base-pair consensus score and sequence logos. Version 2.8 of the Jalview Desktop also included VARNA for interactive exploration of 2D RNA structure. For the latest information about nucleic acid support, see the nucleic acid section of Jalview's help pages.  

  • Because of security restrictions, an applet may not read or write files on the local system. This is to protect you from a malicious applet storing a virus on your computer or deleting all your files. Only the Jalview Desktop can create, print or save images, alignment files and Jalview projects on your computer.

    You can usually send data you have opened in the JalviewLite applet to the Jalview Desktop using the "File -> View In Full Application" menu entry. This will only work if you can launch the java webstart version of the Jalview Dekstop, and in the current version, will not send any additional edits or other changes to the alignment data that you may have made after opening it in JalviewLite.

  • Yes. The Jalview Desktop has a number of command line options, but how you access them depends on the way you want to launch Jalview:

    1. If you use Java Web Start to launch Jalview, then on some versions of Java Webstart you can start up Jalview with a specific file by typing:

    javaws http://www.jalview.org/webstart/jalview.jnlp -open yourFileName

    This is fine for launching the desktop with prepared data, but less useful for batch processing since any console output will be written to the java console.

    2. If you installed the InstallAnywhere version of Jalview you can run the application binary with additional arguments. However any output from the application will be sent to a file called output.txtin the directory where you installed Jalview, rather than to the command's standard output channel.

    3. To use Jalview like a command line program from a terminal, we recommend you use the following command (you could also put this in a shell or batch script).

    java -Djava.ext.dirs=$INSTALL_DIR$/lib -cp $INSTALL_DIR$/jalview.jar jalview.bin.Jalview -open [FILE]

    (where $INSTALL_DIR$ is the InstallAnywhere installation directory or the dist directory created when building Jalview from source) 

    Use -help to list the current set of arguments Jalview supports. The online documentation also includes a list of jalview command line parameters

  • Jalview now exports images and graphics using the same settings as the alignment display window. Just set the font and font size, and the layout style (normal or wrapped) using the View menu.
    If you do want to specify portrait or landscape, you could use the File→Print dialog box, and redirect the output to a file.

  • Full instructions for different operating systems and installations are here. If yours isn't listed, drop us a line at the help address.

  • One of the commonest causes of 'strange behaviour' that our users have reported seems to be Jalview running out of memory. Memory errors can cause some operations to fail silently - with no warning, annotations may disappear from the alignment window, and web service calculations (apparently) never finish.

    You should be able to see something in the error log - see the instructions for bug reporting on how to view this. If you do see 'Out of memory' or 'Cannot allocate stack' or 'HeapAllocationError' type messages, then you might be able to fix it by increasing the memory available to jalview.

  • Firstly, see if you can reproduce the bug. Check Jalview's memory settings (Desktop->Tools->Show Memory usage) to make sure you have at least 50% memory free when testing this. If not, the problem might be because you ran out of memory when using Jalview.

    Then, follow the instructions below to gather essential information regarding the bug:

    • The Jalview desktop includes a Java Console - this is disabled by default, but if you enable it from the Desktop->Tools->Show Java Console menu item, a window will open that will contain the version of jalview and information about your operating system. 
      • The jalview java console can slow down some operations. If it takes too long to reproduce your bug with the console open, then close it and try another way below:
    • If you installed Jalview using Java Webstart, locate and start the program "javaws" or "javaws.exe" on your system. Then click the "Edit" menu, select "Preferences" then click the "Advanced" tab. Make sure you check the "Java Console" option to "Show Console", then click "OK" and restart Jalview. A Java console will be shown when Jalview starts up, and information about any problems should be output to the console window.
    • If you installed Jalview with InstallAnywhere, you will find a text file in the directory in which you installed Jalview called "output.txt" Include this file with any bug report you have.

    Prepare the input data and a description of how the bug is reproduced

    Prepare a copy of the alignment file you are using when you find the bug, and try to describe as fully as possible the steps you took before the bug occurred. If you can reproduce the bug with a simpler data set, then send us that instead!

    Make a bug report !

    If you are familiar with bug tracking systems, then you can register and submit a bug report directly to the Jalview Bug Tracker, otherwise, just send an email to the discussion mailing list describing the problem, and someone will take it from there.

  • Yes! Just remember to include the '-headless' flag on the command line (and if in doubt, also include java -Djava.awt.headless=true to tell Java not to attempt to use the graphics environment)

    The latest version of Jalview should run fine on a server without a graphics environment, but some operations may fail. If you encounter problems, submit a bug report.

  • We have tried to ensure that all files created in earlier versions of Jalview can be read in by later versions. If you have a Jalview format file which no longer loads, please let us know by emailing the file to us. It is possible other people are having the same problem!

  • Some latest versions of Linux fail to install with InstallAnywhere and will generate error messages such as "error while loading shared libraries: libm.so.6: cannot open". The problem can be fixed by modifying the install.bin script, and also the Jalview script.

    cp install.bin install.bak
    cat install.bak | sed "s/export LD_ASSUME_KERNEL/#xport LD_ASSUME_KERNEL/" > install.bin
    sh install.bin

    cp Jalview Jalview.bak
    cat Jalview.bak | sed "s/export LD_ASSUME_KERNEL/#xport LD_ASSUME_KERNEL/" > Jalview
    sh Jalview

  • In the application, open the preferences dialog window (Tools -> Preferences) Open the tab labelled "Output" and then select which file formats to which you do not wish to append "/start-end"

  • This error (and others like it) is raised when an old version of the Jalview Webstart JNLP is being used to launch the latest version of the application (for instance, because you have created your own JNLP file in order to increase the memory available to Jalview).
    To fix, first make sure that you are using the latest version of the Jalview JNLP file (right-click or apple-click to save this link to a file) to launch jalview.

    If you are using the latest version of the JNLP then you need to open the Java Web Start console panel, and flush any application caches and remove any old versions of Jalview listed in the application viewer. To do this:

    1. Locate and open the java console on your system (in your control panel or systems settings, but may also be in the Utilities section of the Applications folder on OSX.
      If you have access to a terminal, you can usually open the console with
      javaws -viewer
    2. Locate any jalview instances in your applications cache and remove them (usually, select the application and hit the delete or 'X' button)

    Once you've cleared the cache, try to run the Jalview JNLP file again.

  • We publish Jalview using our own X.509 certificates. When launching Jalview for the first time, you will be asked if you would like to accept the signing certificate. Certificates are usually signed by the Barton Group (this information is in the technical details panel), and also include an expiry date. If you use a version of Jalview with an expired certificate you will get a 'Signer's certificate has expired' warning, but if you press 'OK' or 'Accept', you should still be able to launch Jalview.

  • The OSX InstallAnywhere version of Jalview is downloaded as a ZIP archive (install.zip) which is normally unpacked automatically to create an application called 'install' that you can run. If nothing happens when you double click the application, then there are a few things that could go wrong.

    Installer doesn't launch because it was unpacked with a third-party archive tool

    If you have chosen an alternative archive program for OSX to use to unpack ZIP files, then it probably didn't set the executable permissions for the application after it unpacked it. The easiest solution is to right or option click the install.zip that you downloaded, and choose 'Open with -> Archive Utility (10.X)' (where X is the numeric version of OSX that you are running); this will create a new 'install' application (probably called 'install 2') that you can now launch.

    If using a different archiver doesn't work, or you are working from the console, then you need to delve into the installer's application directory. Open the console, cd to the directory where the install application is located (probably ~/Downloads), and type:

      chmod u+x install.app/Contents/MacOS/install
      open install.app
    

    Permissions problems result in an error shown in the OSX Console window that reads something like

    ([0x0-0x6a86a8].install[25620]) posix_spawn("/Users/jimp/install.app/Contents/MacOS/install", ...): Permission denied

    If you see anything else, paste it into the search box on http://issues.jalview.org to see if it has been reported.

    Related bugs in the Jalview Issue Database: JAL-746.