olomol Manual PDF for printing Open olomol ENCS

1 Introduction

This manual shows you how to do what you need when drawing chemistry: draw a molecule or a mechanism with curved arrows, arrange it neatly, and get it into Word, PowerPoint or Inkscape. The chapters follow tasks rather than buttons, so you can go straight to the one you need. If you are new to the program, start with the short Quick start. If you would like to know how it works inside, see the appendix (appendix A).

Names of buttons and menus are written like this and match exactly what you see on the screen when the program is in English. Keys look like this: Ctrl+Z. On a Mac, use Cmd instead of Ctrl.

1.1 What olomol is

olomol is a free chemistry drawing program that runs entirely in your web browser. It was made for teaching, as a replacement for ChemSketch. It draws structures, reaction schemes and mechanisms with lone pairs and curved arrows, and it exports clean pictures for lab reports, theses and presentations.

1.2 Opening

The first visit takes a little longer, and a bar shows how much is left. The chemistry libraries are downloaded only when they are first needed (you may see Loading the chemistry engine (RDKit)…). After that they stay on your computer, and the program works without the internet too.

1.3 The window

  1. Top bar, in groups: the drawing’s name and Autosaved, new drawing , open , save , Export | undo and redo | Redraw, Turn in 3D | Align, flips , Horizontal / vertical | ring flip and turning a chair | zoom, and Show . In a narrow window, the groups that don’t fit go under at the end of the bar. With two drawings or more, the tabs are under it (section 8.2).
  2. Drawing tools. A small triangle in a button’s corner means it has more variants: rest the pointer on the button, click the triangle, or click the chosen tool again. At the bottom, opens the Objects panel (section 2.9).
  3. Bottom bar: elements, the periodic table , rings, Templates and the search bar (section 3.5).
  1. Panel with the properties of whatever is selected (section 2.15).
  2. Hints for the chosen tool. The ? key shows all keyboard shortcuts.
  3. Reporting a problem (section 10.3) and settings : the look of the drawing, the language, the theme and debug mode (chapter 9).

1.4 Help and examples

Rest the pointer on any button and a tooltip tells you all it does, along with its shortcut. The hint line above the bottom bar changes with the chosen tool, so it is worth a glance whenever a tool surprises you. Where the top bar has room, its buttons have words as well; in a narrower window they drop them, Turn in 3D’s first.

A right click on the canvas opens a menu of what can be done with what is under the pointer: cut, copy, paste, delete, Redraw, Turn in 3D, the flips, a bond made horizontal or vertical, Abbreviate, One compound, Group… A right click on a molecule selects it first, as a double click does. On the empty canvas the menu has paste, select all, the view and Show. Each item does what its button or key does, and the key is beside it.

Fig. 1: The right-click menu of a molecule

The round button at the bottom right opens Help, the quickest way to see how something is done. It holds about thirty finished drawings, shown as small pictures. Tags such as Mechanisms, Stereochemistry, Texts or Files and tabs narrow the list down.

Fig. 2: Help: pointing at a curved arrow says how it is drawn, and its button lights up in the left bar

Above the tags, Examples in action opens the about page in a new tab, with five short videos of olomol at work: a mechanism, a reaction scheme, a molecule built in steps and partly redrawn, a complex turned in 3D, and a Haworth projection of glucose made a chair, flipped and turned in 3D.

The header of the Help window has the Quick start (PDF), this Manual on the web and, beside it, PDF for printing (the Czech ones when the program is in Czech), What’s new with the changes in each version, Keyboard shortcuts, Report a problem or an idea (section 10.3, also the bug at the top right) and About, with the credits and licences. What’s new and About are also under the version in the bottom left corner.

1.5 The drawing saves itself

You need not worry about losing your drawing. The browser remembers it by itself, a moment after each change, so you can close the window or turn off the computer and it will be waiting when you come back. The mark beside the drawing’s name shows this: Autosaving… just after a change, then Autosaved.

Every drawing you have open is kept this way, so all of them are back the next time you open olomol, each in its tab (section 8.2). This is in this browser on this computer. To move a drawing to another computer or to send it to someone, save it as a file with Save (Ctrl+S, chapter 8). A file is also the safest home for work that matters to you, because it stays even if the browser’s data are cleared.

Earlier versions. While you draw, the browser also keeps earlier versions of the drawing, a few minutes apart. Click the mark (Autosaved), or Open → Earlier versions of this drawing…, and a window shows them as pictures, the newest first; Bring back puts one on the canvas, and Ctrl+Z returns to the drawing you had. Closing the drawing forgets its earlier versions.

The mark warns you in two cases. Not autosaved means this browser can’t autosave, as in a private window or when its storage is full: save your drawing to a file before you close it. Another tab means olomol is open in a second tab that has autosaved its own drawing since. Next time, the one changed last comes back, so save this one if you want to be sure of it. A drawing open in one window of olomol stays in that window: a second window doesn’t open it too, so the two never write over each other.

The button starts a new drawing in a new tab, and the drawing you had stays in its own. The empty canvas shows a faint example, a different one of four each time. Point at a part of it to learn how it is drawn, and its button lights up in red.

At the top left, next to the logo, is the drawing’s name. A new drawing has none yet (New drawing in grey); its files are offered under drawing- with the date and time, so they do not overwrite each other. Click the name to rename the drawing; saved files are named after it. With two drawings or more, the name is on the drawing’s tab, and a double click there renames it.

1.6 Moving and zooming

To zoom, use Ctrl + wheel or the magnifiers at the top. The percentage between them returns to 100 %. The button shows the whole drawing; with something selected, it centres the selection and zooms in until it fills the window. To move the canvas, use the wheel (with Shift for sideways), drag with the space bar held down, or drag with the middle mouse button.

2 Drawing structures

2.1 Bonds and atoms

Everything starts with the single bond , which is already chosen when the program opens.

The other kinds of bonds are among the tool’s variants (in the picture, from the left): single, double, triple, wedge, hashed wedge, wavy, coordination, hydrogen and partial bond. Clicking a double bond with the double bond tool moves its second line to the other side or to the middle. Clicking a wedge with the wedge tool turns it round.

You can also work from the keyboard without switching tools. Point at a bond and press 1, 2 or 3. Pressing 1 again over a single bond makes it a wedge, then a hashed wedge, then both from the other end, and then a plain bond again. Shift+1 goes through them backwards. With bonds selected, 1, 2 or 3 makes all of them single, double or triple at once (with the pointer over the selection or over empty space).

2.2 Chains and rings

The chain tool (Z) draws a zigzag chain: drag from an atom or from the canvas. While you drag, it shows how many bonds it adds; with Shift the zigzag starts the other way.

Rings are in the bottom bar (benzene and 3- to 8-membered rings) and among the variants of the ring tool on the left. Before you click, a see-through preview shows what will happen:

2.3 Elements, the periodic table and group labels

The bottom bar has the most common elements, each in its own colour so you find them quickly. Pick one, and then:

The element keys are quicker: C N O S P F H I, with L for Cl and B for Br. What a key does depends on where the pointer is.

This way you can draw with heteroatoms straight away, instead of drawing a carbon skeleton and rewriting it afterwards.

The button after the elements opens the Periodic table. Its elements are coloured by group (Alkali metals, Halogens, Noble gases…) and carry group and period numbers.

Group labels and abbreviations are in Templates → Abbreviations and attach like functional groups (section 3.2):

With an atom selected, you can also type an abbreviation or a placeholder into the Element field of the panel. An isotope is written with its mass number (13C, 18O), and deuterium and tritium as D and T, or 2H and 3H. A symbol is taken as written (Cl, Na) or all in small letters (cl, na); CO or NI is refused rather than read as cobalt or nickel, since two capitals are two atoms.

Draw out in the panel draws the group an abbreviation stands for (Ph as a benzene ring), and Abbreviate does the opposite for a selected group. A selection with no abbreviation as a whole gets one for the groups in it that have one (CH2N(CH3)2 becomes CH2NMe2), and a CH3 selected on its own becomes Me. A wedge on the bond to the group stays, so the stereochemistry does not change. An abbreviation stands for a group on one bond, so it takes no second one: draw it out first to bond to its atoms. Charged groups have abbreviations too, with the charge on the label: SO3− (a sulfonate), CO2− or COO− (a carboxylate), OPO32− and OPO3H− (phosphates) and PO32− drawn out, the charge sits on an O, where it belongs.

2.4 Charges, radicals and hydrogens

The charge tool on the left has four kinds: positive , negative and the partial charges δ+ and δ− . Click an atom, and click again to raise the charge (or lower it, with the negative one); a partial charge clicked again goes. + and − choose the positive and the negative one.

The unpaired electron is a variant of the lone pairs tool . Click an atom for one electron, again for two side by side (a singlet), and again for none. Two on separate sides (a triplet), three or four are in the panel’s Unpaired row; on an atom without bonds its lone pairs show with them, as a Lewis symbol (·N̈·).

dotsbars

Fig. 6: Lewis symbols of B, C, N, O and Cl, in dots and in bars (Settings → Lone pairs)

Over an atom you can also press + or − for a charge and . for an unpaired electron. With atoms selected, + and − change the charge of all of them.

An atom with more bonds than it can have gets a red dashed ring, which shows only on screen and never in pictures. The panel then says what is wrong, for example Si can’t have 6 bonds. Usually a charge is missing; for SiF62− see section 3.4.

Hydrogens are worked out from the bonds and the charge (CH3, NH2, OH). To set another number, use the Hydrogens row of the panel. Draw the H draws the hydrogens of the selected atoms as atoms of their own, which you need when a curved arrow goes to or from a hydrogen. Hide drawn H hides them again.

Chain ends are written as CH3 by default. The Carbons switch in the panel (CH₃, line or All C) changes this for the selected carbons: the whole molecule, or just one end. All C writes every carbon (CH3, CH2, CH), for those who do not yet read a corner as a carbon. The default for new drawings is in Settings. A charged carbon is written (C+) unless it is set to line: then only its charge is drawn, at the corner, as a carbocation or a carbanion often is in a mechanism.

2.5 Stereochemistry

The wedge points towards you and the hashed wedge away from you. Both are among the bond tool’s variants. A wedge starts at the atom you drag from, so its narrow end is at the stereocentre. The wavy bond marks an undefined configuration.

To show R/S and E/Z labels (Λ and Δ for complexes), tick R/S, E/Z, Λ/Δ in the panel, for the whole selected molecule or just the selected atoms and bonds. RDKit computes them, and they also go into exported pictures and olomol’s files.

When a bond joins the wide ends of two wedges it is drawn bold, as is customary (the bridge of a morphinan, the front edge of a Haworth formula). Any single bond can be drawn bold on purpose too, a bond forming in a scheme or one you want to point at: select it and choose bold bond (▬) in the panel’s Stereo row. An atom’s label can be bold as well: Label → B in the panel.

2.6 Special bonds

The bond tool’s variants also include three bonds that do not count like ordinary ones. The key D chooses the first of them, and each further press the next (over a bond, it turns that bond into them):

A wedge or a hashed wedge gives a coordination bond depth, with its narrow end at the metal, and it stays a coordination bond, so the donor gets no extra bond. Redraw and Turn in 3D then keep the mirror image (Λ or Δ) you drew: Redraw does not offer drawings that would lose it, and Turn in 3D warns at a view that would. For an octahedral complex with two or three chelates (cis-[CoCl2(en)2]+, [Co(en)3]3+), R/S, E/Z, Λ/Δ writes (Λ) or (Δ) beside the metal. If you prefer, Settings can draw these arrows as plain lines.

Fig. 7: [Co(en)3]3+ drawn with wedges; R/S, E/Z, Λ/Δ writes (Λ) or (Δ) beside the metal

These bonds are kept in olomol’s files (.olom), KET files and pictures, but not in molfile, SMILES and similar files (section 10.2).

2.7 Selecting, moving, rotating and deleting

The Select tool (V, or Esc) does the following:

To delete, use the eraser (E), which works by clicking or with a box. Delete or Delete in the panel removes the selection. With nothing selected, Delete removes whatever is under the pointer.

Every step can be undone, so feel free to try things: Ctrl+Z undoes and Ctrl+Shift+Z redoes.

2.8 One compound

A salt such as K2SiF6 is three separate particles (K+, K+ and SiF62−). Select them all and click One compound in the panel. An invisible link joins them, so they move, align and go into a grid as one molecule, and the panel shows one formula (F6K2Si).

The links show while the compound is selected, or all the time when Links in Settings is set to shown. Separate separates the particles again. Links are not written to molfile and SMILES.

2.9 Groups and the Objects panel

A group holds things together for selecting and moving, without making them one compound: a molecule with its number under it, the two halves of a scheme, an exercise’s answer you want to move aside. Select two things or more (molecules, arrows, + signs, texts) and press Ctrl+G groups can go into larger groups too. Ctrl+Shift+G takes a group apart, one level.

A plain click still selects an atom or a molecule, so a group never gets in the way of drawing. Ctrl+click selects the group, and another Ctrl+click the group round it; Ctrl+drag moves it, and Ctrl+drag of a box takes the whole groups of what it touches. Align moves groups as wholes, and SVG pictures keep them as groups, for Inkscape.

The Objects panel , at the bottom of the tool bar, lists the drawing’s things and groups. A click on a row selects it (with Shift or Ctrl, adds it), the pointer on a row lights it up in the drawing, and the arrow before a group unfolds it. A double click on a group names it. A row dragged onto a group goes into it, and onto the strip at the bottom out of every group. The buttons at the top group and ungroup what is selected. The right-click menu has Group, Ungroup and Select its group too.

Fig. 8: The LDH scheme from Help as one group, named

2.10 Copying and pasting

Ctrl+C, Ctrl+X and Ctrl+V work as they do elsewhere. A pasted copy follows the pointer, see-through, until a click puts it down, and Esc cancels.

You can paste from elsewhere too: a SMILES, InChI or molfile copied from a web page or another program is drawn straight away with Ctrl+V. A double bond whose E or Z the SMILES leaves open gets a wavy bond beside it.

2.11 Text

Choose the text tool (T), click and type. What you type stays exactly as written, so the numbers in a DOI or a name are left alone. A bar over the text holds everything for formatting it:

Fig. 9: The bar over a text, after Formula turned CO32- into a formula

Enter finishes the text and Shift+Enter starts a new line. A copied text reaches other programs as plain words, so a DOI pastes straight into the browser.

2.12 Reaction arrows

Choose the reaction arrow (X). A click puts down an arrow of standard length, and dragging draws your own (Shift: at any angle). Its variants are equilibrium , resonance , retrosynthetic , multi-step , crossed (a reaction that does not go), the equals sign (the same thing drawn another way, a chair = its Haworth projection; Align reaction scheme spaces it like an arrow) and the dipole arrow , which moves with its molecule. To change a selected arrow’s length, use Length in the panel (in bond lengths) or drag its end.

For an equilibrium that lies to one side, select the equilibrium arrow and click the button in the panel’s Favours row: each click moves it on, from even to the products’ side (the lower harpoon shorter) and to the reactants’ side (the upper one shorter).

Fig. 10: Top, an equilibrium that favours the products, the crossed arrow and the equals sign. Below, thioredoxin reduced: 2 e− and 2 H+ come in on the upper harpoon’s arc and leave on the lower one’s on the way back

The tool puts a plus sign between reactants.

2.13 Anchors

Anchors keep a text or a reagent with whatever it belongs to, so you never have to move things one by one.

Fig. 11: A reaction scheme with compound numbers on the anchors under the molecules

On a molecule. Every molecule has four places for text: below, above, left and right. Drag a text towards a molecule and the anchors show as boxes, with the nearest one highlighted. Release, and the text stays there: it now moves and aligns with the molecule. Several texts on one anchor stack up, and dragging one to another place changes the order. This is how you put a compound number under a molecule or a count (2 NaOH) to its left. In the panel, the arrow buttons ↓ ↑ ← → choose the anchor and free frees the text; dragging it away from the molecule frees it too. A text you type right under, over or beside a molecule goes on that anchor at once.

On a reaction arrow. An arrow has anchors above and below. Drag a text (conditions) or a whole molecule (a reagent) onto it and it moves with the arrow, as does a text typed right over or under it; drag within the row to reorder. Beside a turned or upright arrow they stand one under the other, close to it, as over and under a horizontal one. In the panel you can put + or − before a molecule on an arrow (added, leaving). A double click on an arrow selects it with everything on it.

2.14 Side arcs on reaction arrows

A side arc shows something joining or leaving a reaction on the way, as NAD+ → NADH does.

Fig. 12: Lactate dehydrogenase, with NADH coming in and NAD+ leaving on side arcs
  1. Choose the arrow tool. A small circle appears in the middle of each reaction arrow.
  2. Drag out of the circle for an outgoing arc, or from the canvas to the circle for an incoming one, above or below the arrow.
  3. Drag a text or a molecule onto the end of the arc. The arrow lengthens itself to fit, and shortens again if you take it away.

A further arc snaps to the length of the first; drag on to make it longer. To change an arc afterwards:

If you have set an arrow’s length by dragging its end, the arcs leave that length alone, though Align reaction scheme does change it.

On an equilibrium arrow each of its two harpoons has its own arcs: an arc above it meets the upper harpoon and goes its way, an arc below meets the lower one and goes back. So the reduction of thioredoxin takes in 2 e− and 2 H+ above and gives them off below on the way back.

2.15 The panel on the right

The panel shows the properties of whatever is selected and lets you change them.

For a whole molecule it shows the formula (with the Info button, section 6.3), Carbons, IUPAC numbering, R/S, E/Z, Λ/Δ, Aromatize and Kekulé, Brackets, lone pairs, Draw the H, Colour and Highlight. For several molecules it adds One compound.

For one atom or part of a molecule, an Atom section appears: Element, Number, Charge (− and + by one; also δ− and δ+), Unpaired electrons, Lone pairs, Label (normal or bold) and Hydrogens. Under the lone pairs it says how many the atom has.

For a bond it shows Order, Kind, Stereo (with a bold bond among them) and, for a double bond, 2nd line: Next moves the second line on, to the middle, one side or the other, and Auto gives it back to the program.

At the bottom there is always Delete and how many things are selected.

3 Templates and structures from names

Templates in the bottom bar (or Shift+T) opens a collection of ready structures. On the left, under the search, are its groups: Rings, Functional groups, Abbreviations, Compounds, Conformations and projections, Complexes, Amino acids, Sugars and nucleobases and Reagents and solvents. The large ones are split further (Rings into aromatic, heteroaromatic, alicyclic and saturated heterocycles; Conformations and projections into chairs and boats, Newman, Haworth and Fischer projections): a group shows all of it under headings, a subgroup only its own. Next time it opens where you were last.

A click picks a template. A see-through preview then follows the pointer, and another click puts it down, as often as you like. Esc stops.

Fig. 14: Templates, chairs and Newman projections

3.1 Searching

Type part of a name into Search…, in English or Czech (acid, glucose, chair). An amino acid is also found by its code, which is on its card (Phe or F). When no template matches, the field draws a SMILES or looks up a name, as the search bar does (section 3.5).

With a question mark in front, the search lists the templates that have a certain part in them, whatever they are called. Capitals do not matter.

This is handy in teaching: ?ester shows all the esters among the templates at once.

Fig. 15: Searching the templates with a question mark: ?ester

3.2 Functional groups attach

The templates in Functional groups have a point of attachment. Pick a group and click an atom of your molecule: the group bonds to it, turned away from the atom’s other bonds. Dragging from the atom aims the group. With Shift the atom becomes the group’s first atom (COOH on pentane’s end carbon gives pentanoic acid). A click on the empty canvas puts the group down on its own, on R.

A group with an abbreviation (Ph, Boc, OMe…) has a small button with that label on its card. It puts the group in as one atom with that label.

Fig. 16: Functional groups, with their abbreviations at the top right of the cards

3.3 Conformations and projections

Fig. 17: An E2 on cyclohexane seen along C1–C2 and C5–C4: the Br and the H taken are trans-diaxial

3.4 Complexes

The Complexes group has the general shapes of coordination compounds: Linear, Trigonal planar, Tetrahedral, Square planar, Trigonal bipyramidal, Square pyramidal and Octahedral. A general atom M sits in the middle with ligands L round it, and wedges give depth. Replace M and L like any atom: click with an element from the bottom bar, press a key over the atom, or use the panel’s Element field, where you can also type NH3, PPh3 or Cl.

A complex ion’s charge belongs to an atom. The program counts bonds and lone pairs from the atoms’ charges, and a charge written on brackets is just text. Take hexafluorosilicate, [SiF6]2−, as an example:

  1. Put down an Octahedral complex, then change M to Si and all L to F (select them and type F into Element).
  2. Select Si and set Charge in the panel to 2−, or press − twice over the atom. Si with six bonds is now fine and the red ring goes.
  3. For the bracket notation, click the ion with the Brackets tool. Si already carries the charge, so do not write it on the brackets, or the picture shows it twice.
  4. Add the K+ ions and join the whole salt with One compound (section 2.8).

There is another way, closer to the bonding picture: four plain Si–F bonds, and two fluorides F− attached by coordination bonds from F to Si. A dative bond does not count among Si’s bonds, so Si stays neutral and the two F− carry the charges.

Fig. 18: Cobalt(II), octahedral (pink) and tetrahedral (blue): charges on the metal, brackets round each complex

To see any complex in space, use Turn in 3D (section 5.2), also a square planar one such as cisplatin drawn as a cross.

3.5 The search bar: structures, templates and actions

The field at the right end of the bottom bar (/ puts the cursor in it) understands what you type in several ways, and a list above it shows what it found, the best next to the field. ↑ and ↓ choose, Enter does it, Esc leaves.

Fig. 19: A SMILES drawn as you type

A SMILES, InChI or CID comes first in the list; words find what olomol has first and PubChem last, so Enter never sends a word to PubChem that a template or an action matches.

When a SMILES has a mistake, the program says what and where, for example Atom 2 (N) has 4 bonds, more than a neutral N can have; with a charge it can have one more: [N+]. When the mistake is a charge outside its brackets (N+ for [N+]), it offers the corrected SMILES: Draw … instead.

A SMILES or InChI copied from elsewhere can simply be pasted onto the canvas with Ctrl+V you do not need the search bar for that.

A halogen with more bonds is drawn as written: Cl(=O)(=O)(=O)[O-] as perchlorate with Cl=O double bonds (not Cl3+ with four O−) and Cl=O as H–Cl=O. RDKit itself rejects such notation, so it gives no InChI or R/S for them.

Fig. 20: chair: templates and actions

4 Mechanisms

In olomol, lone pairs and curved arrows are part of the drawing, not pictures laid on top. They belong to their atoms and bonds, so when you move, rotate or change a molecule they redraw themselves, even while you drag.

Fig. 21: Friedel–Crafts acylation of benzene in two steps, with the resonance structures of the σ-complex

4.1 Lone pairs and unpaired electrons

Choose lone pairs (:) and click an atom, or drag a box over several atoms. If atoms are already selected, pressing the tool’s button or : shows the pairs on all of them (again: hides them). In the panel the same thing is the Lone pairs switch: hidden / shown.

How many pairs an atom has follows from the chemistry: valence electrons minus charge, bonds, hydrogens and unpaired electrons. That is why the nitrogen of pyrrole has none and that of pyridine one. Add a charge or a bond and the count updates itself. Pairs are drawn as dots; Settings can switch them to bars (Bars (Lewis)).

4.2 Curved arrows and fishhooks

Choose the curved arrow (A) for an electron pair, or the fishhook among its variants (Shift+A) for one electron. Then:

  1. Start where the electrons come from: a bond, an atom with a lone pair, or for a fishhook an atom with an unpaired electron (the fishhook starts at that electron).
  2. Drag to where they go: an atom, a bond, or the dot of a new bond (see below), and release.

Instead of dragging, you can click the start and then the end. The tool stays on, so you can draw arrow after arrow. The program works out the path itself: it avoids labels, bonds, lone pairs and other arrows, and starts on the right side.

Arrows to a new bond. When the electrons make a new bond, the arrow can end between the two atoms, where the bond forms. While you drag a fishhook, or a curved arrow with Shift held (it can also be pressed in the middle of the drag), faint dashed lines lead from the electrons to every atom within five bond lengths that a new bond could go to, each with a dot in its middle. The lines in the pointer’s direction are stronger. Drop the arrow on a dot and it ends at the new bond; drop it on an atom and it ends on the atom. This is how you draw hydrogen abstraction by a chlorine radical: a fishhook from Cl• and one from the H–C bond meet at the new Cl–H bond, and the other fishhook from the H–C bond goes to the carbon. Two radicals combining, or a nucleophile making a new bond, are drawn the same way.

Fig. 22: A fishhook from the H–C bond dragged onto the dot of the new Cl–H bond, where the fishhook from Cl• already ends

It also checks the chemistry. It refuses an arrow from an atom that has no electrons to give and tells you why, for example This C has no lone pair or unpaired electron, so the electrons can’t come from it. Start on a bond or another atom.

The colour of new arrows (red, say) is set in Settings → New arrows.

4.3 When an arrow does not look right

Fig. 23: A selected curved arrow and its panel

4.4 Orbitals

Orbitals are among the variants of the tool below the lone pairs: a p orbital , a hybrid orbital (a lone pair, σ*) and an s orbital the fourth variant, the overlap line , only draws dashed lines, dragged from one orbital to an orbital of another molecule. Click an atom to put one on it. A p orbital stands upright, a hybrid points away from the bonds, and dragging from the atom points it that way at once. Orbitals lie behind the bonds and labels, so the drawing stays readable.

On an atom with a label (O, N, Br) the lobes start outside the letters, and written hydrogens and the charge keep out of their way (NH beside the orbital, HO− with its minus over the O). In Turn in 3D (section 5.2) the p orbitals stand upright to the molecule’s plane as you see it, on the side you drew them on. After Use this view they stay so, and a new p orbital on such an atom gets the same direction.

Fig. 24: Left, the diene’s HOMO and the ethylene’s LUMO in a Diels–Alder reaction: the lobes sized by the coefficients, dashed lines joining lobes of one phase. Right, an SN2: the arrow from the hydroxide’s lone pair into the σ* of the C–Br bond

4.5 Resonance structures, transition states and brackets

Fig. 25: SN2: a transition state with partial bonds, partial charges and brackets with ‡

Resonance structures are separated by the resonance arrow , a variant of the reaction arrow.

Brackets (K): drag a box, or click a molecule. The Brackets button in the panel puts them round the selected atoms. Brackets round a whole molecule suit a transition state or a complex ion, and the panel adds ‡, a charge or anything you type at the top right. Brackets round part of a chain mark a polymer’s repeating unit: they cross the bonds leaving it and get n. Shape switches between square and round.

Transition states use the partial bonds and δ charges among the variants of the bond and charge tools. A δ+ or δ− that a curved arrow would cross moves to another side of its atom by itself. Redraw turns an SN2 transition state sketched by hand into the textbook picture: both partial bonds in a line, and the other three bonds with wedges as you sketched them.

4.6 Aromatic rings

Aromatize in the panel draws a circle in aromatic rings, solid, or dashed if you choose that in Settings → Aromatic. Charged groups that look the same in all resonance structures (COO−, NO2, SO3−, guanidinium) are drawn delocalised with δ charges. With nothing selected, this applies to all molecules. Kekulé brings back single and double bonds.

Under the circle the single and double bonds remain, so the formula, lone pairs and files do not change, and other programs get an ordinary Kekulé structure. That is also why Kekulé brings back exactly the bonds that were there.

When you change a structure so that an aromatic ring or a delocalised group no longer makes sense (you delete a ring atom, or drag an acetate oxygen onto another atom), the program returns it to a Kekulé structure by itself.

5 Editing and arranging

5.1 Redraw

When a molecule looks muddled, perhaps after pasting a SMILES, select it and click Redraw . The program offers several drawings made by different methods, next to your Current drawing, and you click the one you like. Ctrl+Z undoes the choice.

The drawings are ranked. Those without crossing bonds or overlapping atoms, and with even bonds and angles, come first, and only the best few are shown. They are ranked once, when the quick methods are done; drawings from the slower ones (Indigo’s clean-up, the 3D views) come a few seconds later and are added after them, so no drawing moves while you look. Show all drawings brings in the rest and Show only the best hides them again. A note under a drawing warns when bonds cross or atoms overlap in it.

Every drawing is checked: one that would change the molecule, its stereochemistry for example, is never offered. Redraw changes how a molecule looks, never what it is. Each drawing of a whole molecule is lined up with the page, turned by up to 15° so that most of its bonds lie at multiples of 30°, as a molecule pasted as SMILES is (a view of a 3D model keeps the view chosen for it).

Fig. 26: Quinine: your current drawing, and the best of the drawings on offer

Drawings from a 3D model. Some drawings come from a 3D model of the molecule, turned and projected onto the page with wedges for depth. They are offered where they are the right picture: for cages and bridged rings (adamantane, norbornane, tropane), metal complexes, molecules with an expanded octet and SN2 transition states. Any other molecule Turn in 3D shows in 3D. A large molecule such as taxol can take ten seconds or so, but the page does not freeze while you wait.

Molecules with one central atom with an expanded octet, or with five or more electron pairs round it (PCl5, SF6, SF4, ClF3, XeF4, ClO4−, SO42−), get their VSEPR shape, with room for the lone pairs. Sulfate is drawn as in a textbook, with the S=O double bonds in the plane of the page and O− as a wedge and a hashed wedge. This part is still experimental (section 10.2).

5.2 Turn in 3D

Sometimes a molecule reads best from one particular side. Select one molecule and click the cube next to Redraw. The program builds a 3D model, which takes a moment for a large molecule, and shows it just as it will be drawn, with the back paler so that you can see the depth.

as pastedin the window, turned by handafter Use this view

Fig. 27: Bornyl salicylate: as pasted, its bridge lies across the ring; turned by hand, the bornane looks as it does in a textbook

every hydrogenH: small hydrogens

Fig. 28: The stick model of N-acetyl-β-D-glucosamine, turned as in its Haworth projection: every hydrogen, and with H the hydrogens small, so that the skeleton shows

Groups written as shorthands (Ph, OMe, NHAc, OBz, also PPh3 on a metal) are drawn out atom by atom in the stick model, so that the molecule’s real shape shows. A group’s carbons, hydrogens and bonds have a colour of their own, explained under the model. Oxygen, nitrogen and the other elements keep their usual colours, so you see at once what the group contains: the nitrogen and the carbonyl oxygen of NHAc, both oxygens of a benzoate (OBz). Draw out groups (G) is on to start with; switched off, it shows each group as one ball with its shorthand, for when the model with every atom is crowded. The window remembers both, G and H, until the tab is closed.

drawn with a shorthandthe group drawn outG: the group as its shorthand

Fig. 29: Paracetamol drawn with the shorthand NHAc, and its stick model

The wedges are chosen so that R/S and E/Z stay as you drew them, and the 3D model itself is checked against your drawing. The model also has the drawing’s conformation: a chair (from the templates, or drawn by hand and recognised) gives that chair (an axial OH stays axial, even where the other chair is more stable), cyclohexane in a Newman projection that chair, and a Newman projection of a chain the dihedral drawn, an eclipsed one too. A diene or an enone drawn s-cis (for a Diels–Alder) stays s-cis, though s-trans is more stable. If no such conformation can be found, the window says so and shows another. Sometimes a view cannot be drawn clearly: its wedges would not say the right R/S, or a bond points almost straight at you. The window then says so, and the button becomes Use it anyway: turn the molecule a little further, or use the view as it is.

Complexes work too. The whole complex is optimised by a force field (UFF), so each ligand keeps its proper shape, chelating ligands such as EDTA wrap round the metal and porphyrins stay flat, and where two bonds cross, the one behind is broken. If the program has no 3D model for a molecule, it tells you why.

Fig. 30: EDTA round Ca2+, built from a flat drawing

5.3 Redrawing only a part

Often most of a molecule is just as you want it and only one part is a mess: a side chain, or a ring squeezed in. Select only that part, with a box, the lasso or Shift+click, and click Redraw.

The window then opens with a section of its own, Only the selected part, the rest where it is. In these drawings nothing outside your selection moves. Depending on the molecule you may see:

This is also how you get just one part of a molecule in 3D: turn the whole molecule (section 5.2), then clean up the part you want flat. Bornyl salicylate below was made that way. The bornane stays as it was turned, while the salicylate, its ring seen at a slant after the turn, is flat again.

Below, Whole molecules offers the usual drawings of the whole thing, should you prefer them. The example Redrawing a part: the rest stays as drawn in Help shows the difference on one molecule.

Fig. 31: Bornyl salicylate, turned in 3D (section 5.2), with only its salicylate selected: the window, and the drawing picked. The bornane has not moved

5.4 Align and grid

Select several molecules, and arrows and texts too if you like, and open Align:

Molecules joined by a curved arrow move together. A text on an anchor always goes with its molecule, and free texts align on their own.

5.5 Flipping and straightening

6 Atom numbering and the Info card

6.1 IUPAC numbering

Select a molecule and tick IUPAC numbering in the panel. The parent chain or ring is numbered by the IUPAC rules (2013 recommendations), and the numbers are worked out again after every change: add Cl to the other end of hexane and C1 moves there. The panel says which rule decided, for example Numbered so that the alcohol (OH) group gets the lowest number: 2, not 4.

The program knows how to choose the parent chain or ring: by the senior principal group (acid > ester > acyl halide > amide > nitrile > aldehyde > ketone > alcohol > thiol > amine), a ring before a chain, then the longest chain with the most multiple bonds and substituents.

It gives the lowest locants to ring heteroatoms, the principal group, multiple bonds (double before triple) and substituents, and finally goes by alphabetical order. Only the parent is numbered, as in a name.

6.2 Your own numbers

Fused, bridged and spiro rings (naphthalene, steroids) have numberings of their own that the program does not work out. For them, and for assigning NMR signals, use the atom number tool , a variant of the text tool. Click atoms in the order you want them numbered; clicking again removes a number.

To change one atom’s number, use the panel’s Number field. Remove own numbers deletes them all. Numbers are kept in olomol’s files, links and pictures.

6.3 The Info card

Select a molecule and click Info next to the formula in the panel. A card opens beside the panel with the numbers a lab report or experimental section needs:

Click a row to copy it. You get only the formula, ion and number, with no words, so it fits a report in any language: for example C9H8O4 [M+H]+ 181.0495 or C9H8O4: C 60.00, H 4.48. Then paste it into your text.

Everything on the card is computed on your computer. The card closes when you select another molecule or click the empty canvas.

6.4 Finding a compound on PubChem

PubChem page on the Info card opens the compound’s page on PubChem. It is the only thing on the card that sends anything out: the molecule’s InChIKey, by which PubChem finds the compound, and its SMILES too if PubChem has no exact match.

What you draw is not always exactly what PubChem has. You may have left a stereocentre undefined, or drawn an isotope. Then, instead of guessing, olomol shows a page of cards with PubChem’s picture, name and number for each candidate. Click a card to go to that compound. The heading says how they differ:

Fig. 38: Alanine drawn without stereochemistry: PubChem has DL-alanine, and also L- and D-alanine

If PubChem has nothing at all, the page says so and offers Search PubChem.

7 Colours and highlighting

7.1 Colour

Colour changes lines and letters. Select atoms, bonds, arrows or text and click a colour under Colour in the panel; the crossed-out circle is Default colour. Or use the tool at the bottom left, with ten colours among its variants, and click or box what you want to colour.

The rainbow circle after the colours (More colours, or a colour code) opens a larger choice: a row Used last, a grid Colours and a field for a colour code (#cc0055, #c05, rgb(204, 0, 85) or a name like teal; Enter uses it). The circle next to the field opens the system’s colour picker. The program remembers the colours you use and offers them among the tool’s and panel’s colours too.

When Atom colours in Settings is set to Black, the elements are drawn in black but your own colours stay, so red arrows on black structures stay red.

7.2 Highlighting and filled rings

Highlighting is a soft coloured background behind atoms and bonds, as RDKit draws it. It marks a group, a reaction centre or the common part of several molecules.

Use the highlighter at the very bottom left, with eight colours. Click atoms and bonds or box them; a second click takes the highlight off. The panel does the same under Highlight, and here too the rainbow circle offers more light colours.

A click inside a ring fills it with colour. Round written atoms (O, N, CH2) a round cut-out remains, so the colour does not cover the letters.

With the select tool , a click into a filled ring selects the ring, a double click the whole molecule, and dragging moves it. A smaller highlight always lies over a larger one (the orange difference over the blue common part).

Fig. 39: A filled ring, a highlighted ester and the acid in red

A fill goes when you break the ring by deleting a ring atom or bond. Otherwise you can remove it with the highlighter’s No highlight variant (click inside the ring), with the eraser (click inside the ring), or with No highlight in the panel when all the ring’s atoms are selected.

7.3 Example: what molecules have in common

Fig. 40: Catecholamines and related drugs: the common part in blue, salbutamol’s main difference in orange, the groups on nitrogen in purple

L-DOPA, dopamine, noradrenaline and adrenaline are made in the body one from another; isoprenaline and salbutamol are drugs. The common part, a phenol with a C–C–N chain, is highlighted in blue and turned the same way in every molecule. Salbutamol, an asthma drug, has its main difference highlighted in orange: CH2OH in place of one OH, so the enzyme COMT does not break it down and it acts for hours, not minutes. The groups on nitrogen are painted purple with the paint tool: the bigger the group, the more the compound acts on β-receptors.

To make a picture like this:

  1. Draw the first molecule, copy it (Ctrl+C, Ctrl+V) and edit the copy. The common part stays turned the same way everywhere, which molecules pasted from SMILES would not do.
  2. Select everything, enter 3 Columns in Align and click Arrange in a grid.
  3. Select the common part (drag a box, Shift+click) and click the blue Highlight in the panel. Do the same with orange for the difference.
  4. Colour the groups on nitrogen with the tool or with Colour in the panel.

8 Files, tabs, export and links

The way out of olomol depends on what you want to do next:

You want to…Use
keep working on a drawing laterSave (Ctrl+S): an olomol drawing (.olom), with everything in it
put it into Word, PowerPoint or Google DocsCopy as picture (Ctrl+Shift+C), then Ctrl+V there
print it, or make a PDF of itExport → PDF / Print…
go on editing it in InkscapeSVG
send it to a colleague or studentsCopy link, or the .olom file
show it in a lectureShow (section 8.3)
open it in KetcherStructure file: KET
open it in ChemDraw or another chemistry programStructure file: Molfile, SDF, SMILES or InChI
start a calculation from itStructure file: XYZ

8.1 Save and open

Save (Ctrl+S) stores the drawing as an olomol drawing, a .olom file. It opens here again with everything in it: lone pairs, curved arrows, colours, highlights, numbers, groups and the drawing’s style. For your own work it is the best choice. (Its name stands for Olomol Layout Object Model; section A.4 says more.)

As in a word processor, a drawing knows its file. In Chrome and Edge, Ctrl+S writes it back into that file without asking (the browser asks once per visit whether olomol may), and Ctrl+Shift+S (Save as) asks for a new name and folder. A dot on the save button, and on the drawing’s tab, means changes that are not in the file yet. A file another program wrote (KET, CDXML, a molfile) is never written over: Ctrl+S then asks where to save the drawing as .olom. If the file has changed since olomol read it (in another program or another tab), olomol asks before writing over it. Firefox and Safari can’t write into files, so they download them: the first time under a name you give, then again under that name, into the downloads folder.

Open (Ctrl+O) reads olomol drawings (.olom), KET, molfile, SDF, SMILES, RXN, CDXML and CDX (ChemDraw), CML and XYZ. A picture exported from olomol (SVG or PNG) carries the drawing inside it, so it opens again as the drawing, not as a picture. Once you have opened files, Open first lists the recent files, and Open a file from this computer… below them. Files can also be dropped onto the window, and the installed app (section 10.1) opens .olom files from the file manager.

A drawing (.olom, KET, a reaction, CDXML) opens in a tab of its own (section 8.2). A file of molecules only (molfile, SDF, SMILES, XYZ) goes into the drawing you have, like a template: click where it should go, or it lands where you dropped it. From ChemDraw, abbreviations (OMe, OTBS, Et) stay labels, the hydrogens written on an atom stay as written, and an attachment point (the squiggle across a bond) becomes an R. A reaction from an RXN file is lined up as Align reaction scheme does, its reagents on the arrow. An XYZ file from a quantum chemistry program has no bonds, so the program adds them from the distances between atoms, works out bond orders and stereochemistry, and draws the molecule in 2D.

8.2 Several drawings: tabs

Fig. 41: Three drawings open: an exercise and its solution opened from a link, and the drawing there was

Each drawing opens in a tab of its own, with its own undo, file and view, so an exercise and its solution, or a scheme and the molecules for it, sit side by side. The tabs show under the top bar once there are two drawings; the drawing’s name is then on its tab.

All open drawings are autosaved and come back the next time you open olomol (section 1.5). The example An exercise and its solution: tabs and Show in Help shows it all on one exercise.

8.3 Show: drawings full screen

Show , the last button of the top bar, puts the open drawings on the whole screen, without bars and panels, each fitted to the screen: the thing for a lecture or a seminar. →, ↓, Space or Page Down (what a presentation clicker sends) shows the next drawing, ←, ↑ or Page Up the one before, Home and End the first and the last. While the mouse moves, a small bar at the bottom shows the drawing’s number and name with back and next. Esc returns to drawing, every drawing as it was. Nothing can be changed meanwhile; the wheel still zooms.

Put each step in a tab of its own, an exercise first and its solution after it, and Show goes through them in order.

8.4 Exporting pictures and files

The Export menu in the top bar offers:

With something selected, Only the selection is ticked and only the selection is exported. Untick it to export the whole drawing.

SVG and PNG pictures from olomol carry the drawing inside them, unseen, so Open or dropping the picture on the window brings back the drawing itself. A program that edits the picture may drop it, and a picture copied to the clipboard has none.

Structure files carry atoms, positions, charges, isotopes, radicals and wedges in standard formats. Reading them back has been tested in olomol, RDKit and Indigo, not in other programs. Lone pairs, curved arrows, brackets, partial bonds and colours are kept only in olomol’s own files, links and pictures. KET keeps the most of them for Ketcher: abbreviations as its groups, and Haworth and Fischer projections with their stereochemistry as wedges.

An XYZ file holds 3D coordinates with all hydrogens. It is a starting geometry for calculations (Gaussian, ORCA and the like), optimised by a force field only, not by quantum chemistry. A metal complex is built as in Turn in 3D, optimised as a whole by the universal force field (UFF) on its coordination polyhedron; UFF makes metal–ligand bonds somewhat shorter than they are (Zn–N in ZnTPP 1.95 Å instead of 2.04 Å). A complex Turn in 3D can’t build (ferrocene) isn’t written, and the program says why. The coordinates are worked out in the background: a panel shows that it is working while you keep drawing, and Save XYZ file saves them when they are ready, for the drawing as it was when you asked. The suggested file name is the molecule’s InChIKey, so several structures from one drawing don’t overwrite each other. Check the warning about stereocentres with no R/S drawn: the file then holds just one of the possible stereoisomers.

8.5 Into Word, PowerPoint and Google Docs

Select what you want to take over, or nothing for the whole drawing. Press Ctrl+Shift+C, or choose Export → Copy as picture, and then Ctrl+V in Word, PowerPoint or Google Docs.

SVG is the sharpest in print: Word and PowerPoint insert it (Insert → Pictures) and it does not blur when enlarged. For a journal, choose its style first (Settings → Style: ACS, RSC or your own, chapter 9), and pictures come out at the size it asks for.

8.6 Links

Export → Copy link makes a link that holds the whole drawing, after the # sign, which the browser does not send to the server. Whoever opens it sees your drawing, and their own comes back with Ctrl+Z. Some chat programs cut long links short; if that happens, send the .olom file.

A link with a structure. A link can also say which structure to draw, written by hand, in a worksheet or by a chatbot: olomol.org/#smiles=CCO draws ethanol, #name=caffeine looks the name up in PubChem, and #inchi=… and #cid=2244 work too. &title=… names the drawing, and several structures open each in a tab of its own, in order: #title=Exercise&smiles=C=CC.Br&title=Solution&smiles=CC(Br)C is an exercise with its solution behind it, ready for Show. A reaction SMILES (reactants>reagents>products) is drawn as a reaction. The installed app has no address bar: paste such a link into the search bar (section 3.5). Chatbots learn how to write these links from olomol.org/llms.txt.

9 Settings and keyboard shortcuts

9.1 The look of the drawing, language and window

The look changes most with how charges, lone pairs and atom colours are drawn. On the right is the same glycine in the default look, and with circled charges, lone pairs as bars (Lewis) and black atoms. The style, the charges and the lone pairs belong to the drawing and are kept in its file; the other settings apply to all drawings. All of them show in exported pictures.

default
⊕ ⊖, bars, black

Settings ( at the top right):

Drawing

Window

A style of your own. Custom… opens the Drawing style window for the sizes a journal or your group asks for, in points: Bond length, Lines, Bold bonds, wedges, Hash spacing, Margin round labels, Labels and texts and the Font, sans (Arial) or serif (Times). Start from fills in ACS 1996 or RSC to change from. A molecule beside them is drawn at true size as you type; Use gives the drawing that style. The example A journal’s look: ACS, RSC or a style of your own in Help shows one drawing in each.

9.2 Keyboard shortcuts

The ? key or Keyboard shortcuts in Help (section 1.4) shows them too. Letters and digits do different things depending on what is under the pointer: an atom, a bond, or empty space.

Over an atom

C N O S P F H Ichanges the element
L BCl, Br
+ −charge
.unpaired electron (again: two side by side, then none)
:lone pairs on/off
Deldeletes it

Over a bond

1 2 3single, double, triple
1 againwedge, hashed wedge, both from the other end, plain
Shift+1the same, backwards
Ddative bond, again hydrogen bond, again partial bond
Deldeletes the bond

With a selection (pointer over it or over empty space)

+ −the charge of every selected atom
1 2 3every selected bond single, double, triple
:the selected atoms’ lone pairs on/off

In Turn in 3D

Arrow keysturn it (Shift: in the plane of the page)
Sstick model, and back
Gin the stick model: draw out groups
Hin the stick model: small hydrogens
EnterUse this view
Escclose the window

Writing text

Enter Escfinish
Shift+Enternew line
Ctrl+, Ctrl+.subscript, superscript
Ctrl+B Ctrl+Ibold, italic

Tools (pointer over empty space)

V select
E eraser
Ndraw with nitrogen (likewise O, S, P, F, H, I, L = Cl, B = Br; C: carbon again)
1 single bond (again: wedge, again: hashed wedge)
2 double bond
3 triple bond
Z chain (zigzag)
R benzene (again: the next ring, 3- to 8-membered)
55-membered ring
66-membered ring
+ positive charge
− negative charge
. unpaired electron
: lone pairs
A curved arrow (electron pair)
Shift+A fishhook (one electron)
Shift+TTemplates
X reaction arrow
T text
K brackets
D dative bond, again hydrogen bond, again partial bond

Anywhere

Esccancel; again: the Select tool; again: nothing selected; again: box or lasso
Ctrl+Z Ctrl+Shift+Z Ctrl+Yundo, redo
Ctrl+C Ctrl+X Ctrl+Vcopy, cut, paste (SMILES and molfile too)
Ctrl+Shift+Ccopy as picture (PNG), for Word, PowerPoint, Docs
Ctrl+Aselect all
Ctrl+G Ctrl+Shift+Ggroup the selection, take a group apart (one level)
Ctrl+clicka group (again: the group round it); Ctrl+drag moves it, Ctrl+drag of a box takes whole groups
Deldelete the selection
Arrow keysmove the selection (Shift: further)
Ctrl+S Ctrl+Osave, open
Ctrl+Shift+Ssave as another file
Ctrl+Tab Ctrl+Shift+Tabthe next drawing, the one before (in the installed app)
Ctrl+wheelzoom
space+dragmove the canvas
/the search bar: a name, SMILES, InChI or what you want to do
?this overview

In Show

→ ↓ Space Page Downthe next drawing
← ↑ Page Upthe one before
Home Endthe first, the last
Escback to drawing

10 Installing, limitations and reporting problems

10.1 Installing as an app and working offline

After the first visit olomol works without the internet too, because the browser keeps all its files. Offline, only the PubChem look-ups do not work.

Installed as an app, it has its own window and an icon on the desktop or in the Start menu, and it opens at once:

10.2 Known limitations

olomol is a testing version. This is what it cannot do yet, or can do only in part:

10.3 Problems and ideas

Every message is welcome, even about a small thing. Click the bug at the top right (or Report a problem or an idea in Help). A window opens with a table of what helps to find a fault: the program’s version, the browser, the system, the window size and, if you leave With the drawing (a link that holds it whole, so I can see what you saw) ticked, a link to the drawing.

Fig. 46: The window for reporting a problem
  1. Click Write the e-mail. A new e-mail to bugs@olomol.org opens with a few questions that are enough to answer: what you did (briefly is fine), what happened and what you expected. The table is already in it.
  2. A link to a drawing is too long for an e-mail, so with the drawing, click Copy the table and paste the table (Ctrl+V) at the end of the e-mail.
  3. A screenshot or the drawing’s .olom file helps too.

Nothing is sent from here: you see the e-mail and send it yourself. If no e-mail opens after the click (you use webmail only, say), write to the address by hand and paste the table all the same. The program’s version is also at the bottom left and in About.

A How olomol is built

This appendix is for those who want to know what is under the bonnet: computing teachers, school network administrators, developers and curious chemists. You do not need it to use the program.

A.1 The big picture

olomol is a static web page: HTML, JavaScript and WebAssembly, nothing more. It needs no application server, database or accounts. Any web space with https (a school server, GitHub Pages) is enough, and everything else runs in the user’s browser. Its own code is about 33,000 lines of JavaScript.

Screen · src/ui
bars, tabs, panel, menus, dialogs, the search bar, the Info card (React 19)Editor · src/editor
tools, selection, undo and redo, view, mouse and keysArranging · src/arrange
align, space evenly, grid, reaction schemeLayout · src/layout
layout methods, ring templates, checking, 3DDrawing · src/model
atoms, bonds, reaction and curved arrows, texts, brackets, fills: plain data, the copy for undo is structuredCloneChemistry · src/chem
hydrogens and lone pairs, formula and masses, R/S, IUPAC numbering, templatesRendering · src/render
the scene: labels, bonds, electrons, arrow rules; canvas and SVGFiles · src/io
.olom, KET, molfile, conversions, links, PubChemRDKit.js, megane-rdkit
SMILES, InChI, layout, CIP (R/S, E/Z), canonical SMILES; 3D structures (ETKDG, MMFF94s)Indigo (own thread)
RXN, CDXML, CDX, SDF, CML, Ketcher’s layoutOpenChemLib
3D structures where RDKit makes none, the MMFF94s+ force fieldBrowser
IndexedDB (drawings, earlier versions, recent files) · localStorage (settings) · service worker (offline) · clipboard

Fig. 47: The program’s layers. The top three rows are its own code (folders in src/); the green row are WebAssembly libraries, downloaded only when first needed.

A.2 What each part does

FolderWhat is in it
src/modelThe drawing as data. Coordinates are in bond lengths, the y axis points down as on screen. graph.js: molecules (connected parts), smallest rings.
src/chemChemistry computed by its own code: hydrogens and lone pairs (valence.js), formula and masses, R/S labels, IUPAC numbering (numbering.js), templates, chairs and projections, delocalised groups (COO−, NO2).
src/renderAfter every change the scene is computed once: where labels go, how bonds look, where lone pairs sit and which way curved arrows run. The canvas, the SVG export and finding what is under the pointer all use it. The pictures in this manual are exports of that same scene.
src/editorThe editor and tools: selection, dragging, bonds, rings, templates, history (200 steps), keys.
src/arrange, src/layoutAligning and new layouts: several methods (RDKit, CoordGen, Indigo, RDKit’s ring system templates, 3D from RDKit or OpenChemLib, metal complexes by UFF), each drawing of a whole molecule turned onto the 30° grid.
src/ioFiles: olomol’s own .olom and KET (reading and writing), molfile V2000/V3000, conversions through RDKit and Indigo, XYZ, the drawing inside pictures, links, PubChem, printing.
src/uiThe screen in React: bars, tabs, panel, menus, dialogs, the search bar, Show, the Info card.
src/i18nLanguages. The key is the English text, cs.js and de.js are translation tables; a test reports missing texts.

A.3 Rules that are not from the libraries

A.4 Data and files

A.5 What leaves the computer

WhenWhat, and where to
Looking up a name or CIDonly the typed text, to PubChem PUG REST (pubchem.ncbi.nlm.nih.gov)
PubChem pagethe molecule’s InChIKey (or the typed SMILES or InChI), to PubChem; if PubChem has no exact match, its SMILES too
Loading the pagean ordinary request to the server olomol is on; libraries, fonts and icons are part of the page, nothing is fetched from elsewhere
Anything elsenothing: no analytics, no cookies, no accounts

A.6 Offline and installing

The build (npm run build) makes a service worker (scripts/pwa.mjs) that stores all the page’s files in the browser’s cache on the first visit. The page itself (index.html) comes from the network when it can, so a new version shows at the next load; the other files have a fingerprint of their content in their names and can therefore come from the cache. A manifest and icons make the site an installable app (PWA).

A.7 Development and tests

The program is developed in Node.js 24 with Vite:

npm run devthe development server at http://localhost:5173/
npm testunit tests: chemistry against RDKit, reading and writing files, complete translations
npm run checkthe browser check (Chrome through Playwright): drawing, arrows, files, keys; in topics (scripts/check/), --only drawing runs one, --jobs 3 three at a time
npm run buildbuilds the static site into dist/
node scripts/manual-shots.mjsthe pictures of this manual from the running program (--en: in English); typeset with Typst

The examples in the manual are real drawings of the program, not redrawn pictures. The script builds them from SMILES and checks every molecule through RDKit before saving, stereochemistry included.

A.8 Licence and credits

olomol is free to use under the MIT License: it may be used, shared and changed, also in other programs, as long as the copyright and licence notice stays with it. The program uses RDKit (BSD-3-Clause, including the ring system templates © Schrödinger and its universal force field, UFF, ported to JavaScript), Indigo by EPAM Systems (Apache 2.0), megane-rdkit (BSD-3-Clause; RDKit’s 3D structures as WebAssembly), OpenChemLib (BSD-3-Clause) and React (MIT). KET is the format of Ketcher (EPAM Systems, Apache 2.0); no Ketcher code is in the program. Compound data on request come from PubChem (National Library of Medicine, USA). All licence texts open from the About olomol window (About under the version at the bottom left). The code was written with substantial help from Claude, a model by Anthropic.

How to cite

If olomol helped with a publication, a thesis or teaching materials, cite it with the version you used. The About olomol window has the citation: copy it as text, BibTeX, RIS or CSL JSON, or save it as a .bib, .ris or .json file for a reference manager (Zotero, Mendeley, EndNote, Citavi, LaTeX). It gives olomol’s DOI on Zenodo, which stands for all its versions, and the number of the version you use.