Skip to content

User Manual

Jump to bottom
Hiromichi Yokoyama edited this page Aug 4, 2026 · 11 revisions

MoleditPy User Manual

Table of Contents

1. Introduction

MoleditPy is a molecular editing software developed in Python. Through an intuitive interface, it allows for the drawing and editing of molecular structures in 2D, as well as the generation, display, and editing of 3D structures.

Main Features:

  • 2D Molecular Editing: Add, delete, or modify atoms and bonds; create structures using templates. Also supports user templates, allowing users to save and use their own specified structures.
  • 3D Structure Generation: Generate 3D coordinates from 2D structures and perform structure optimization using RDKit or Open Babel (optional).
  • 3D Molecular Display: Display 3D molecules in multiple styles, including Ball & Stick, CPK (Space-filling), Wireframe, and Stick.
  • File Operations: Save and load projects in a proprietary format (.pmeprj). Supports import and export of standard chemical file formats (MOL, SDF, XYZ) and SMILES, InChI strings. Exported files can be used for DFT calculations. Also supports exporting as images (PNG/SVG) or 3D models (STL, OBJ) for 3D printing. See File Formats and Import/Export for the full format reference.
  • Molecular Analysis: Display basic molecular properties such as SMILES, InChI, Molecular Formula, Molecular Weight, LogP, and TPSA.
  • 3D Measurement: Measure distances between atoms, angles between three atoms, and dihedral angles between four atoms in the 3D view.
  • 3D Editing: Translate the entire molecule, planarize selected atoms, align to specific axes, adjust bond lengths, angles, and dihedral angles, and create mirror images.
  • Customization: Configure 2D and 3D display settings such as background color, lighting, and detailed display styles.
  • Plugin System: Extend functionality with Python scripts. Place custom scripts in ~/.moleditpy/plugins to add new features to the "Plugin" menu — see Using Plugins and Official Plugins.

2. Installation and Launch

The recommended way to install MoleditPy on any OS is via moleditpy-installer, which installs the correct package for your platform and can set up a desktop/menu shortcut and the .pmeprj file association:

pip install moleditpy-installer
moleditpy-installer

See the per-OS guides for full details and alternatives (Conda-based install, Docker):

Launch:

moleditpy

(Note: The first launch may take some time while libraries like RDKit are initialized.)

For all command-line flags (--safe, --install-plugin, --version, opening a file at startup, etc.), see Command-Line Options.

3. Screen Layout

The MoleditPy main window is primarily composed of the following elements:

  1. Menu Bar: Contains functions for file operations, editing, viewing, analysis, 3D editing, plugins, settings, and help.
  2. Main Toolbar: Provides basic tools for selecting atom/bond drawing modes, setting charges/radicals, and changing 3D display styles.
  3. Template Toolbar: Contains buttons for selecting templates such as ring structures.
  4. 2D Edit View: The main canvas for drawing and editing molecular structures. You can add and edit atoms and bonds using mouse operations.
  5. 3D View: Displays the 3D structure of the generated or loaded molecule. You can rotate, zoom, and pan with the mouse. 3D measurement and editing are also performed in this view.
  6. Splitter: The boundary line between the 2D view and the 3D view. You can drag it to resize the display area of each view. You can also quickly switch split ratios via View > Panel Layout (or Ctrl+1, 2, 3), or hide the 2D panel entirely with Ctrl+H.
  7. Status Bar: Displays the current operating mode, messages, and the molecular formula/atom count being calculated.

4. Basic Operations (2D Edit View)

In the 2D Edit View, you create and edit molecular structures using the mouse, toolbar, and keyboard shortcuts.

4.1. Selecting a Drawing Mode

Select a drawing mode by clicking a button on the main toolbar or pressing the corresponding keyboard shortcut.

  • Select (Space): Mode for selecting and moving atoms or bonds.
  • Atom buttons (C, H, N, O, etc.): Mode for adding the corresponding element's atom. Click to place an atom; drag to add an atom and a bond.
  • Bond buttons (Single bond, Double bond, etc.): Mode for adding or changing the corresponding type of bond. Drag between atoms to create a bond; click an existing bond to change its type.
  • Charge buttons (+/-): Mode for increasing or decreasing the charge on an atom by clicking it. Right-click to reset the charge to 0.
  • Radical button (Radical): Mode for toggling the number of radical electrons on an atom (0 -> 1 -> 2 -> 0) by clicking it. Right-click to reset to 0.
  • Template buttons (Benzene ring, etc.): Mode for adding a template structure by clicking on the canvas. It can also snap to and merge with existing atoms or bonds.

4.2. Atom and Bond Operations

  • Adding an Atom:
    1. Select the desired element button from the toolbar (e.g., 'C').
    2. Click anywhere on the canvas to place an atom of that element.
  • Adding a Bond:
    1. Select the desired bond button from the toolbar (e.g., Single bond).
    2. Press the mouse button on Atom A, drag to Atom B, and release to create a bond between A and B.
    3. Start dragging in an empty area and release on Atom A to create a new atom (default Carbon) at the start point, bonded to Atom A.
    4. Start dragging on Atom A and release in an empty area to create a new atom (default Carbon) at the release point, bonded to Atom A.
  • Selecting Atoms/Bonds:
    1. Select 'Select' mode from the toolbar.
    2. Click an atom or bond to select it (Shift + Click for multiple selections).
    3. Drag in an empty area of the canvas to make a rectangular selection.
  • Moving:
    1. In 'Select' mode, drag the selected atom or bond. When an atom is moved, its connected bonds follow.
  • Deleting:
    1. In 'Select' mode or any drawing mode (except template, charge, or radical), right-click the atom or bond you want to delete.
    2. In 'Select' mode, select items and press the Delete or Backspace key.
  • Changing an Element:
    1. Select the button for the element you want to change to from the toolbar.
    2. Click an existing atom to change its element.
    3. Alternatively, hover the mouse cursor over an atom and press the keyboard shortcut (e.g., 'N' for Nitrogen).
  • Changing Bond Order:
    1. Select the button for the bond type you want to change to from the toolbar.
    2. Click an existing bond to change its type.
    3. Alternatively, in 'Select' mode, select a bond and press a keyboard shortcut (e.g., '2' for a double bond).
  • Setting Stereo Bonds (Wedge/Dash):
    1. Select the Wedge (solid) or Dash (dashed) button from the toolbar.
    2. Click an existing single bond to set the stereo display. Click again to reverse the direction.
    3. Alternatively, in 'Select' mode, select a single bond and press 'W' (Wedge) or 'D' (Dash).
  • E/Z Configuration of Double Bonds:
    1. Select the 'Toggle E/Z' button (Z⇌E icon) from the toolbar.
    2. Click an existing double bond to toggle its stereo configuration in the order Z -> E -> (unspecified).
    3. Alternatively, hover the mouse cursor over the bond and press the 'Z' or 'E' key.

4.3. Using Templates

  • Standard Templates: Click a button on the template toolbar (benzene ring, cyclohexane ring, etc.) to select the mode, then click on the canvas to place it. Clicking on an existing atom or bond allows you to merge the structures. Template snapping distance and fusing settings can be adjusted in the Settings menu. Hold down the Alt key to temporarily bypass atom fusing; the template preview will deform to show fusing points visually unless the Alt key is pressed.

  • User Templates:

    1. Click the 'USER' button on the template toolbar or use the menu File > Save 2D as Template... to save the current structure as a template.
    2. Clicking the 'USER' button opens the user template dialog.
    3. Click the template you want to use in the dialog to enter that template's mode. Click on the canvas to place it. The dialog remains open, allowing you to continuously use different templates.

4.4. Undo/Redo

  • Use Edit > Undo (Ctrl+Z) and Redo (Ctrl+Y / Ctrl+Shift+Z) from the menu to undo or redo operations. The undo/redo stack works by serializing the full application state (2D + 3D + constraints) at each step.

4.5. Copy/Cut/Paste

  • In 'Select' mode, select atoms or bonds and execute Edit > Copy (Ctrl+C) or Cut (Ctrl+X) from the menu.
  • Execute Edit > Paste (Ctrl+V) from the menu to paste the clipboard contents at the cursor's position. This supports internal copy & paste within MoleditPy.

4.6. Other Edit/View Functions

  • Clean Up 2D: To tidy up the 2D structure, click the Clean Up 2D button at the bottom left or press Ctrl+J.
  • Rotate 2D...: Select Edit > Rotate 2D... (Ctrl+R) from the menu to open a dialog for rotating the 2D molecule by a specified angle.
  • Add Hydrogens: Select Edit > Add Hydrogens from the menu to explicitly add hydrogen atoms based on RDKit's implicit hydrogen counts.
  • Remove Hydrogens: Select Edit > Remove Hydrogens from the menu to remove all hydrogen atoms.
  • Select All / Clear All: Edit > Select All (Ctrl+A) selects every atom and bond; Edit > Clear All (Ctrl+Shift+C) deletes all atoms and bonds on the canvas.
  • Show Chiral Labels: Check View > Show Chiral Labels from the menu to display R/S labels for chiral centers in the 3D view.

5. 3D Functions

MoleditPy provides functions to generate, display, measure, and edit 3D structures from the drawn 2D structure.

5.1. 2D to 3D Conversion

  1. Draw a molecular structure in the 2D Edit View.
  2. Click the Convert 2D to 3D button in the bottom left, or select Edit > Convert 2D to 3D (Ctrl+K) from the menu.
  3. The calculation begins, and progress is displayed in the status bar. 3D coordinates are generated using RDKit (ETKDGv2 algorithm), and a simple structure optimization is performed using a force field (MMFF94 or UFF).
  4. Upon success, the generated 3D structure is displayed in the 3D View.

(Settings): You can set the priority of libraries (RDKit, Open Babel) used for conversion, or select the "Direct" mode (use 2D coords + add H), from the menu Settings > 3D Conversion. If Open Babel is not installed, related options will be disabled.

Conversion Modes:

  • Fallback Mode (Default): Automatically tries RDKit first, then Open Babel (if available), and finally falls back to Direct Mode.
  • RDKit Mode: Uses RDKit's ETKDGv2 (Experimental-Torsion Knowledge Distance Geometry) algorithm for conformer generation. If the initial embedding fails, it applies bounds matrix triangle smoothing with explicit stereochemistry constraints before trying again.
  • Open Babel Mode: Uses Open Babel's make3D() coordinate generator run in a secure, isolated background subprocess to prevent application hangs or crashes.
  • Direct Mode: Bypasses 3D conformer embedding to retain your exact 2D layout. Atoms are placed on the Z = 0.0 plane, with missing hydrogen atoms added geometrically. Stereochemistry is preserved by adding offset Z-coordinates (Z = ±1.5 Å) to wedge/dash atoms.

See Tips for 2D-to-3D conversion for guidance on choosing between these.

5.2. 3D Structure Optimization

  • With a 3D structure displayed, click the Optimize 3D button in the bottom right, or select Edit > Optimize 3D (Ctrl+L) from the menu.
  • A more detailed structure optimization calculation is performed using the selected force field (MMFF or UFF).
  • If an optimization method fails, an interactive fallback prompt may appear, offering a temporary UFF override.
  • When completed, the optimized structure is redrawn in the 3D view.

(Settings): You can select the force field calculation library and method (RDKit MMFF94/MMFF94s/UFF, Open Babel MMFF94/MMFF94s/UFF/GAFF/Ghemical) from the menu Settings > 3D Optimization Settings.

(Quick select): Right-click the Optimize 3D button to run any available method once, without changing your default selection.

Optimization Methods:

  • RDKit Backend: Supports MMFF94s (spectroscopic/default), MMFF94, and UFF (Universal Force Field). If MMFF94s fails setup due to unsupported elements (such as transition metals), the system automatically falls back to UFF to prevent crashes.
  • Open Babel Backend: Supports MMFF94s, MMFF94, UFF, GAFF (General Amber Force Field), and Ghemical. It performs 100 iterations of Steepest Descent to clear major atomic collisions, followed by Conjugate Gradients minimization.
  • Plugin methods: Installed plugins can add their own optimizers. When present, they appear in Settings > 3D Optimization Settings (selectable as the default) and in the Optimize 3D right-click menu, alongside the built-in force fields.

See Tips for force-field selection in 3D optimization for a comparison of MMFF vs. UFF and when to use each.

5.3. Changing 3D Display Style

You can select the display style from the 3D Style dropdown menu on the right side of the main toolbar.

  • Ball & Stick: Displays atoms as spheres (a scaled-down version of van der Waals radii) and bonds as sticks. This is the standard style.
  • CPK (Space-filling): Displays atoms as space-filling spheres based on their van der Waals radii. Suitable for visualizing the volume and shape of the molecule.
  • Wireframe: Displays only bonds as thin lines. Atoms are not displayed.
  • Stick: Displays bonds as thick sticks and atoms as small spheres.
  • Aromatic Ring: By default, aromatic rings (e.g. benzene) are displayed as single bonds. You can change this to show aromatic circles (torus) or Kekulé structures (alternating double bonds) in Settings.

(Settings): Details for each display style (atom size, bond radius, multiple bond offsets, rendering quality, etc.) can be adjusted from the menu Settings > Settings.... You can also change CPK Colors from Settings > CPK Colors....

5.4. 3D View Operations

  • Rotate: Left mouse button drag.
  • Zoom: Mouse wheel scroll (or Ctrl + Wheel).
  • Pan (Move): Middle mouse button drag, or Shift + Left mouse button drag.
  • Reset View: View > Reset 3D View (Ctrl+Shift+R) from the menu resets the camera position and zoom to their initial state.
  • Redraw 3D Molecule: View > Redraw 3D Molecule from the menu forces a redraw of the 3D structure.

5.5. 3D Measurement Function ("3D Select" Mode)

  1. Click the 3D Select button on the main toolbar to enable selection and measurement.

  2. Click atoms in the 3D view to select them. Selected atoms are displayed with red labels in order (1, 2, 3, 4).

  3. Depending on the number of selected atoms, the following measurements are calculated and displayed in the upper-left corner of the 3D view:

    • 2 atoms selected: Distance between atoms (Å)
    • 3 atoms selected: Distance (1-2) and Angle (1-2-3) (°)
    • 4 atoms selected: Distance (1-2), Angle (1-2-3), and Dihedral Angle (1-2-3-4) (°)

  4. Clicking anywhere other than an atom, or clicking the 3D Select button again to exit the mode will clear the selection and measurements.

5.6. 3D Editing Function ("3D Drag" Mode / Alt Key)

You can directly edit the atomic coordinates of the 3D structure. Turn on the 3D Drag button on the main toolbar, or perform operations while holding down the Alt key.

  • Atom Drag: In 3D Drag mode, clicking and dragging an atom allows you to move it in 3D space. The position is confirmed when you release the mouse button.

See Tips for 3D editing for advice on making conformational changes stick after optimization.

5.7. Other 3D Editing Functions (Menu 3D Edit)

These functions are available from the menu when a 3D structure is displayed. Many open a dedicated dialog where you can select atoms or input parameters.

  • Translation...: Translates the entire molecule or a selected group of atoms. You can specify translation using relative coordinates (shift amount) or absolute coordinate mode to move the selection to an exact position in 3D space. An option to translate only the selected atoms is also available.

  • Move Selected Atoms...: Translates or rotates only the selected atoms. You can input numeric translation values (dX, dY, dZ in Å) and rotation angles (around X/Y/Z in degrees) around the selected atoms' centroid, or interactively drag the selected atoms in the 3D view (left-drag to translate, right-drag to rotate).

  • Move Group...: Allows for the selection and manipulation of connected molecular fragments (groups).

    • Selection: In the 3D view, left-click an atom to select its entire connected group (highlighted in yellow). Ctrl + left-click allows for adding/removing groups from the selection.
    • Interactive Move: Left-drag a highlighted atom to move all selected groups.
    • Interactive Rotate: Right-drag a highlighted atom to rotate all selected groups around their combined center of mass.
    • Numeric Input: Use the dialog to apply precise translation (Å) or rotation (degrees) to all selected groups.

  • Align to > Axis > (X/Y/Z)-axis...: Rotates and moves the entire molecule so that the line connecting two selected atoms aligns with the specified coordinate axis (X, Y, or Z) (the first atom is placed at the origin, the second on the axis).

  • Align to > Plane > (XY/XZ/YZ)-plane...: Rotates the entire molecule so that the plane containing three or more selected atoms becomes parallel to the specified coordinate plane (XY, XZ, or YZ).

  • Mirror...: Creates a mirror image of the entire molecule with respect to a specified plane (XY, XZ, YZ).

  • Adjust Bond Length...: Changes the distance between two selected atoms to a specified value. You can choose to fix one atom (or its connected group) or move both. Includes an interactive slider for real-time adjustments.

  • Adjust Angle...: Changes the angle formed by three selected atoms (1-2-3) to a specified value. You can choose to rotate the atom 3 side (or its connected group) or rotate both arms equally. Includes an interactive slider for real-time adjustments.

  • Adjust Dihedral Angle...: Changes the dihedral angle formed by four selected atoms (1-2-3-4) to a specified value. You can choose to rotate the atom 4 side (or its connected group) or rotate both groups equally. Includes an interactive slider for real-time adjustments.

  • Planarize...: Calculates the best-fit plane for three or more selected atoms and projects those atoms onto that plane.

5.8. Constrained Optimization

This is an advanced feature that performs a molecular structure optimization (force field calculation) while keeping the values of specific atomic distances, angles, or dihedral angles fixed (constrained).

  • Adding Constraints:
    1. Select 3D Edit > Constrained Optimization... to open the dialog.
    2. In the 3D view, click 2 atoms (for distance), 3 atoms (for angle), or 4 atoms (for dihedral) to select them. The selected atoms are highlighted with yellow labels (A1, A2...).
    3. Press the "Add Constraint" button (e.g., "Add Distance Constraint"), and the current structural value will be added to the table.
  • Editing and Deleting Constraints:
    • Edit: Double-click (or select and press Enter) the "Value" column in the table to edit the constraint value directly.
    • Delete: Select the constraint row(s) you wish to remove in the table and press the "Remove Selected" button or the Delete / Backspace key.
    • Verify: Selecting a row in the table highlights the corresponding atoms in the 3D view in cyan.
  • Running the Optimization:
    1. Select the desired force field (MMFF94s, MMFF94, or UFF) from the "Force Field" dropdown. (The default value is loaded from the Settings menu.)
    2. Press the "Optimize" button (or the Enter key) to run the optimization while preserving all constraints listed in the table.

5.9. Displaying Atom Information

From the menu View > 3D Atom Info Display, you can select the information to be displayed above each atom in the 3D view.

  • Show Index: Displays the internal RDKit atom index.
  • Show Original ID: Displays the original ID assigned in the 2D editor.
  • Show XYZ Index: Displays the index within the imported XYZ file.
  • Show Coordinates (X,Y,Z): Displays the 3D coordinates of each atom.
  • Show Element Symbol: Displays the element symbol for each atom.
  • Index Base: A submenu to switch the starting index (0-based / 1-based) for the displayed indices.

Selecting the same menu item again will turn off the display.

6. File Operations

Perform various file operations from the File menu in the menu bar. See File Formats and Import/Export for the complete list of supported formats and their import/export details.

6.1. Project Files (.pmeprj)

  • New (Ctrl+N): Clears all current work and starts a new session. A confirmation dialog will appear if there are unsaved changes.
  • Open Project... (Ctrl+O): Opens a previously saved project file (.pmeprj or .pmeraw).
  • Save Project (Ctrl+S): Overwrites the current project file with the current work (2D structure, generated 3D structure, etc.). If no file name is set, the "Save As" dialog will open. .pmeprj (JSON format) is the recommended format.
  • Save Project As... (Ctrl+Shift+S): Saves the current work as a project file (.pmeprj) with a new name or location.

6.2. Import

  • Import > MOL/SDF File...: Loads a MOL or SDF file and displays it as a 2D structure. Even if the file contains 3D coordinates, 2D coordinates will be recalculated (stereochemistry is preserved). The imported molecule is automatically appended to the current canvas without overwriting existing structures.
  • Import > SMILES...: Opens a dialog to input a SMILES string and displays the input molecule as a 2D structure. The imported molecule is automatically appended to the current canvas.
  • Import > InChI...: Opens a dialog to input an InChI string and displays the input molecule as a 2D structure. The imported molecule is automatically appended to the current canvas.
  • Import > 3D MOL/SDF (3D View Only)...: Loads a MOL/SDF file with 3D coordinates and displays it in the 3D view only (the 2D editor is cleared). This enters 3D viewer mode.
  • Import > 3D XYZ (3D View Only)...: Loads an XYZ file and displays it in the 3D view only (the 2D editor is cleared). Bonds are estimated based on interatomic distances. This enters 3D viewer mode.

6.3. Export

  • Export > PME Raw Format...: Saves project data in the legacy binary format (.pmeraw). This format uses Python pickle — only open .pmeraw files you created yourself.
  • Export > 2D Formats > MOL File...: Saves the current 2D structure as a MOL file.
  • Export > 2D Formats > PNG Image...: Saves the current 2D Edit View content as a PNG image file. You can choose whether to make the background transparent.
  • Export > 2D Formats > SVG Image...: Saves the current 2D Edit View content as an SVG vector image file. You can choose whether to make the background transparent.
  • Export > 3D Formats > MOL File...: Saves the currently displayed 3D structure as a MOL file with 3D coordinates.
  • Export > 3D Formats > XYZ File...: Saves the currently displayed 3D structure as an XYZ file.
  • Export > 3D Formats > PNG Image...: Saves the current 3D View content as a PNG image file. You can choose whether to make the background transparent.
  • Export > 3D Formats > STL File...: Saves the current 3D model as an STL file (no color, e.g., for 3D printing).
  • Export > 3D Formats > OBJ/MTL (with colors)...: Saves the current 3D model as an OBJ file and an MTL file (with color information).

7. Molecular Analysis

Selecting Analysis > Show Analysis... from the menu will open a dialog that calculates and displays the basic properties of the molecule currently displayed in the 3D view (excluding those from XYZ files).

Example of displayed information:

  • SMILES String
  • InChI String / InChIKey
  • Molecular Formula
  • Molecular Weight
  • Exact Mass
  • Heavy Atom Count
  • Number of Rings
  • LogP (Octanol-water partition coefficient)
  • TPSA (Topological Polar Surface Area)
  • Number of Hydrogen Bond Donors/Acceptors

You can copy each value to the clipboard using the Copy button next to it.

8. Settings

You can configure various 2D and 3D display settings via Settings > Settings... in the menu. Click Apply to reflect changes immediately, or OK to apply and close the dialog. Reset Current Tab / Reset All revert settings to their defaults (also available from Settings > Reset All Settings in the menu bar). Settings persist across launches (stored under your user config directory).

2D Settings Tab:

Setting Default
2D canvas background color #FFFFFF
Bond color #222222
Bond width 2.0
Double/Triple bond spacing 3.5
Bond cap style (Round/Flat/Square) Round
Wedge bond width 6.0
Dash count 8
Atom label font size 20
Atom font family Arial
Atom font bold / italic / underline Bold on, italic/underline off
Use bond color for atom labels Off
Template snapping distance (px) 14.0
Bond (drag) snapping distance (px) 14.0
Enable atom fusing for templates On
Template fusing distance (px) 7.0

Scene (3D) Tab:

Setting Default
Background color #919191
Show/hide 3D axes Shown
Lighting enabled On
Light intensity 1.0
Specular (shininess) / Specular power 0.20 / 20
Camera projection mode Perspective
Mouse rotation sensitivity 1.0 (window-size independent multiplier)
Real-time 3D drag On — updates the structure continuously while dragging an atom or group; turn off to only apply the move on mouse release. Structures larger than 300 atoms always use release-only updates, since redrawing them every frame would be slower than the drag itself.
Rotate Groups: Follow Mouse Off — when on, right-drag rotation must start on an atom of the group and that atom follows the cursor; when off (default), right-dragging anywhere rotates the group.

Display Style Tabs (Ball & Stick, CPK, Wireframe, Stick):

Style Atom scale Bond radius Resolution Notes
Ball & Stick 1.0 0.1 16 Double/triple bond offset factor 2.0; radius factor 0.8/0.75
CPK 1.0 — 32 Space-filling van der Waals spheres
Wireframe — 0.02 6 Double/triple bond offset factor 3.0; radius factor 0.8/0.75
Stick — 0.15 16 Double/triple bond offset factor 1.5/1.0; radius factor 0.6/0.4

Other Tab:

Setting Default
Skip chemical validity checks on XYZ import Off
Display aromatic rings as Kekulé structures Off
Display aromatic rings as circles (torus) in 3D Off
Aromatic torus thickness factor 0.6

You can also change atom colors via Settings > CPK Colors..., and the default 2D→3D conversion / 3D optimization method via Settings > 3D Conversion and Settings > 3D Optimization Settings (see 5.1 and 5.2).

9. Menu Reference

Quick summary of the menu bar (each menu is also described in context above):

Menu Contents
File New, Open/Save/Save As Project, Save 2D as Template, Import (MOL/SDF, SMILES, InChI, 3D MOL/SDF, 3D XYZ), Export (PME Raw, 2D/3D formats)
Edit Undo/Redo, Cut/Copy/Paste, Add/Remove Hydrogens, Rotate 2D, Clean Up 2D, Convert 2D to 3D, Optimize 3D, Select All, Clear All
View Panel Layout (50:50 / 70:30 / 30:70), Toggle 2D Panel, Reset 3D View, Redraw 3D Molecule, Show Chiral Labels, 3D Atom Info Display (+ Index Base submenu)
Analysis Show Analysis...
3D Edit Translation, Move Selected Atoms, Move Group, Align to (Axis/Plane), Mirror, Adjust Bond Length/Angle/Dihedral Angle, Planarize, Constrained Optimization
Plugin Plugin Manager and one entry per installed plugin's registered menu actions — see Using Plugins
Settings Settings..., CPK Colors..., 3D Conversion, 3D Optimization Settings, Reset All Settings
Help About, GitHub, GitHub Wiki, User Manual

10. Plugin System

MoleditPy supports extending its functionality through Python scripts placed in ~/.moleditpy/plugins, or installed via the Plugin Manager (Plugin > Plugin Manager...). See:

  • Using Plugins — installing, managing, and writing plugins.
  • Official Plugins — the curated plugin collection (ORCA/Gaussian/PySCF input generators, result analyzers, XYZ/Bond/Charge editors, and more), browsable from the Plugin Explorer.

11. Keyboard Shortcuts

See Keyboard Shortcuts for the complete reference table. The most-used shortcuts:

Key Action
Space Select mode / Select All
1 / 2 / 3 Single / Double / Triple bond
W / D Wedge / Dash bond
Ctrl+Z / Ctrl+Y Undo / Redo
Ctrl+J Clean Up 2D
Ctrl+K Convert 2D to 3D
Ctrl+L Optimize 3D
Alt (hold, in 3D view) Temporary 3D Drag mode

12. Version / License

You can check the version information from the Help > About menu, or via moleditpy --version on the command line.

Clone this wiki locally