Main Page

Jmol is an open-source viewer for three-dimensional chemical structures, with features for chemicals, crystals, materials and biomolecules.

JSmol, a fully functional HTML5-only non-Java implementation of Jmol, is now available. Performance may be a little slower than Java, but it is amazingly fast for JavaScript. JSmol/HTML5 runs in all tested current-release browsers, including Firefox, Chrome, Opera, MSIE(9+), and Safari on Apple MacOS and iOS (iPad and iPhone). The initial download footprint is 2 MB (uncompressed) or 0.5 MB (gzipped). See JSmol for more details.

Features include reading a variety of file types, including PyMOL session files and output from quantum chemistry programs, file writing (including JPG, PNG, PNGJ (PNG+ZIP), and ZIP formats), and animation of multi-frame files and computed normal modes from quantum programs, surfaces, translucency, full Jmol scripting, and localization in 40+ languages.

The recommended way to cite Jmol is:

Jmol: an open-source Java viewer for chemical structures in 3D. http://www.jmol.org/

JSmol: an open-source HTML5 viewer for chemical structures in 3D. http://wiki.jmol.org/index.php/JSmol#JSmol

Remember to always use uppercase 'J', uppercase 'S', lowercase 'mol' (explanation).

If you prefer, a list of articles that describe Jmol can be found in the Jmol Literature section.

This is the homepage for the Jmol Community Wiki. Here the community of users can discuss everything that has to do with Jmol and JSmol. You are welcome to browse around and to add new pages, extra information, comments, questions, links to useful examples of Jmol use or Jmol scripting, or whatever else you think is relevant.

More official, general and static information about Jmol is available in the Jmol web site. (But content there is currently quite outdated)

---

Pages on this Wiki

About Jmol and JSmol License (terms of use) J(S)mol videos J(S)mol events Jmol/JSmol Community Community & users Communities: Crystal · Protein · Quantum Chemistry · Solid State · Folding@home List of users & their pages Jmol / JSmol Applications Websites Using J(S)mol J(S)mol in the Classroom Journals Using J(S)mol J(S)mol Literature Articles Using J(S)mol Books Using J(S)mol Wikis Using J(S)mol Blogs Using J(S)mol CMS Using J(S)mol (Moodle and others) Course Management Systems, Learning Management Systems, Virtual Learning Environments, e-Learning Platforms Applications Embedding Jmol Distributions Including Jmol Blue Obelisk

Installing Jmol / JSmol Get the files from SourceForge. Support and operating systems. Users: how to install Jmol application for local, standalone use. Web page authors: how to install Jmol objects (Jmol / JSmol) embedded within your web pages. Installing and Enabling Java (Proteopedia wiki). Has step by step instructions for both Windows and Mac OS X, and for the 5 most popular web browsers. Increasing java memory for the applet. Web site administrators: How to install the application on a web server to be delivered using Java Web Start. How to configure a wiki so that it uses the Jmol applet. Developers: compile the latest Jmol source code via subversion access. Running Jmol / JSmol Jmol as a standalone application. J(S)mol as a web applet or HTML5 object. compatibility with JavaScript frameworks or libraries. J(S)mol embedded in wikis or blogs. Borrowed JSmol, or running JSmol without your own server. Running Jmol using Java Web Start. JSmol in a Jupyter notebook. Jmol in an Android tablet. Troubleshooting. Jmol / JSmol Tutorials A list of Jmol / JSmol Tutorials written by users. Using the mouse (English · Español · Français · Japanese). Scripting quickstart: rendering options · selecting atoms. How to create surfaces and isosurfaces, including cavities, pockets and tunnels. Displaying shapes, polyhedra, orbitals, dipoles, distances, forces and vibrations. Creating movies. Customizing Jmol: macros · menus. Web pages without writing code by using the Jmol "Export to Web" function.

Jmol/JSmol Development Getting Involved in J(S)mol evolution Release Procedures Important! Use the Jmol Coding Style Developing J(S)mol with Eclipse Internationalisation (status) ProgrammeerZomer / SummerOfCode MultiUser Jmol Developer mailing list (mirror) Jmol + JSmol Documentation Description of files in Jmol+JSmol distribution File formats read or written by Jmol The Jmol scripting interface Scripting as a programming language Complete reference of scripting commands: at St Olaf (primary site) at Jena3D (mirror) Loading models directly from databases Mouse manual Default colors used by Jmol Atom sets predefined in Jmol Support for bond orders · isotopes · stereochemistry · hydrogen bonds Jmol as editor Multi-touch support Copying and pasting state scripts between applets. Backward compatibility (changes of behavior across versions) Features added since version 10 Users mailing list (and a mirror)

Contributors

AngelHerraez, NicolasVervelle, Pimpim, EricMartz, Hansonr, JmolTest