Main Page

Jmol is an open-source Java viewer for three-dimensional chemical structures, with features for chemicals, crystals, materials and biomolecules. Features include reading a variety of file types and output from quantum chemistry programs, and animation of multi-frame files and computed normal modes from quantum programs.

New! JSmol, a fully functional HTML5-only non-Java implementation of Jmol, is now available. Performance is slower than Java, but amazingly fast for JavaScript. Surfaces, translucency, file reading (including PyMOL session files), file writing (including JPG, PNG, PNGJ (PNG+ZIP), and ZIP formats), full Jmol scripting, and language localization in 40+ languages. This implementation runs in all tested current-release browsers, including Firefox, Chrome, Opera, MSIE(9+), and Safari on Apple MacOS and iOS (iPad and iPhone). Initial download footprint is 2 MB (uncompressed) or 0.5 MB (gzipped). See the JSmol page for more details.

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://www.jmol.org/

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 Jmol user community can discuss everything that has to do with Jmol. 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.

Please post any and all comments about how we can best organize this forum in the Discussion Page (see link on the top of the page). Your contributions to the Jmol community are greatly appreciated! (Timothy Driscoll)

---

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