Mol* Linker is a powerful browser extension for structural biologists, bioinformaticians, and developers. It instantly injects Mol* (Mol*) viewing capabilities directly into GitHub and GitLab, powered by the MolViewSpec (MVS) architecture.
- Native Integration: Automatically detects
.pdb,.cif,.mmcif, and.grofiles on GitHub and GitLab and injects a 1-click Mol* viewing badge. - Mol* Linker Studio: A fully-featured Options dashboard to configure default representations, colors, and sizes for proteins, nucleic acids, ligands, and ions.
- Turing-Complete Rule Engine: Create dynamic highlighting rules to target specific chains, residue ranges, or atoms.
- Cinematic Control: Inject custom camera coordinates, background canvas colors, hovering tooltips, and floating labels directly into the Mol* scene.
- Exportable Templates: Save your lab's preferred viewing configurations as
.jsonfiles and share them with colleagues. - Cross-Browser: Built on Manifest V3, fully compatible with Google Chrome, Microsoft Edge, Brave, and Mozilla Firefox.
- Visit the [Chrome Web Store link] (Note: Add link after publishing).
- Click Add to Chrome.
- Visit the Firefox Add-ons link.
- Click Add to Firefox.
- Clone this repository:
git clone https://github.com/MartinBaGar/molstar_linker.gitor simply grab the latest release. - Chrome: Go to
chrome://extensions/, enable Developer mode, and click Load unpacked. Select the cloned folder. - Firefox: Go to
about:debugging#/runtime/this-firefox, click Load Temporary Add-on, and select themanifest.jsonfile.
Click the extension icon in your browser toolbar to quickly swap between built-in presets (e.g., "Protein Surface + Spacefill Ligands") or your own custom templates.
Right-click the extension icon and select Options (or click "Open Advanced Studio" in the popup) to access the full rule builder.
- Global Targets: Set the baseline style for standard molecular classes.
- Custom Rules: Use the "Simple" mode to visually target specific chains/residues, or use "Expert" mode to write raw MVS JSON for ultimate control.
- Scene Settings: Modify the canvas background color and default camera focus.
This extension acts as a graphical builder for MolViewSpec (MVS), a standardized JSON schema for describing molecular scenes.
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
This project is licensed under the MIT License.
- Make demo videos and screenshots
- Add example files
- Add link to wiki in the popup and studio page
- Add Chrome link when published
- Add for RCSB files from the drop down menu, there as currently not detected.
- Add possibility to open local file using in Mol* Linnker and its presets
- Allow use of cutom host of Mol* instance ?
