Install ReShiki
ReShiki includes the drawing and chemistry tools. You do not need to install Python, RDKit, or uv. There is no chemistry download or environment setup on first launch. See what changed in 0.9.
1. Download and open
Section titled “1. Download and open”Download the latest stable release, recommended for everyday work. Choose the package for your computer below.
Original ReShiki code and documentation are licensed under MIT OR Apache-2.0,
at your option. Commercial use, including workplace use, is permitted.
Third-party components and code adaptations retain their respective terms.
See the license scope
and third-party notices.
Downloaded apps include these texts in their Licenses directory
(ReShiki.app/Contents/Resources/Licenses on macOS).
| Your computer | Download ends in | Install |
|---|---|---|
| Apple Silicon Mac | macos-arm64.dmg |
Open, then drag ReShiki to Applications |
| Intel Mac | macos-x64.dmg |
Open, then drag ReShiki to Applications |
| Windows x64 | windows-x64-setup.exe |
Run setup, then open ReShiki from Start |
| Windows ARM | windows-arm64-setup.exe |
Run setup, then open ReShiki from Start |
| Linux x64 | linux-x64.tar.gz |
Extract, then run reshiki |
| Linux ARM | linux-arm64.tar.gz |
Extract, then run reshiki |
Windows setup installs for your account. Mac downloads are signed and notarized. Windows downloads are not code-signed yet, so Windows may warn before running setup. Portable ZIP downloads are also available. Keep a portable download’s extracted contents together.
Read the Code signing policy and privacy policy.
To uninstall on Windows, open Settings → Apps, select ReShiki, and choose Uninstall. Uninstalling removes the installed application and its shortcuts; it preserves your drawings, preferences, and recovery drafts. For a portable download, remove the extracted application folder when you no longer need it.
Upgrading from an earlier version? Open your existing .reshiki and .moruno drawings normally. Templates, assistant preferences, and recovery drafts are copied on first launch; the originals stay in place. New drawings use .rsk.
Starting with 0.9.0, Mac supports Apple Silicon and Intel on macOS 14+. Windows requires Windows 10/11 on x64 or Windows 11 on ARM64. Linux builds target Ubuntu 22.04+ on x64 and 24.04+ on ARM.
On Linux (x64 and ARM) and Apple Silicon Macs, you can build ReShiki from source with Nix:
nix run github:Ameyanagi/ReShikinix profile install github:Ameyanagi/ReShikiUpdate with nix profile upgrade; the in-app updater only replaces downloaded releases. On Linux outside NixOS, ReShiki needs your system’s GPU driver; if it reports that no graphics adapter was found, start it through nixGL. On a Mac, the package contains ReShiki.app and the reshiki command: nix-darwin and home-manager add the app to your Applications folder; with nix profile install, find it in ~/.nix-profile/Applications. The DMG remains the signed, notarized Mac app.
Linux desktop launchers
Section titled “Linux desktop launchers”ReShiki identifies its Wayland and X11 windows as reshiki. If you create a
launcher for a self-built or portable app, name it reshiki.desktop and set
StartupWMClass=reshiki so the desktop can group its windows with the launcher.
Its Icon entry must name an installed icon. The Nix package installs a matching
launcher and icon.
File compatibility
Section titled “File compatibility”ReShiki 0.14.0 saves most drawings in document version 30, which ReShiki 0.13.1 opens. A drawing with a custom reaction-label gap, ORTEP settings, a 3D model generated in 0.14.0 or an amino-acid residue collapsed with two attachment points uses versions 31–34, which 0.13.1 cannot open. ReShiki 0.13.0 and earlier cannot open any version 30 drawing. Older versions ask you to update. Older drawings still open in 0.14.0. If you share files with someone using an earlier version, keep a copy saved by that version before saving in 0.14.0. See file compatibility.
Try it in your browser
Section titled “Try it in your browser”Open the browser preview to try ReShiki without installing it. Drawing runs in the browser, and your files stay on your computer. The editor’s JavaScript and WebAssembly have an estimated first download of 9 MB compressed (gzip -9). The naming worker loads on demand; Japanese, Korean or Chinese text may also download a font from jsDelivr; see the privacy policy.
The browser preview is not the full app. Use the desktop app whenever you can. In the browser:
- Naming and NMR prediction work, but there is no assistant, printing, or Office and LibreOffice integration. 3D models work, but the page pauses while one is computed.
- Copy puts a picture and SMILES on the clipboard, and Paste takes ReShiki drawings, chemical text and pictures, but not PDF, CDX or ChemDraw’s own clipboard data; see Clipboard. Settings, templates and recovery drafts stay in the browser’s storage for this site.
- Shortcuts are the desktop app’s, with ⌘ on a Mac, except New, Close tab and switching tabs, which the browser keeps: use Alt+N, Alt+W and Alt+] / Alt+[ (⌃N, ⌃W and ⌃] / ⌃[ on a Mac). Long cleanups or imports pause the page.
Nightly builds
Section titled “Nightly builds”Nightly builds are optional prereleases for testing upcoming changes from main. For everyday work, use the latest stable release.
To try a nightly, open GitHub Releases, choose a release named Nightly with the Pre-release label, and use its operating-system and architecture download table. New nightlies include signed, notarized macOS DMG/ZIP downloads, Windows setup/ZIP downloads, and Linux tar.gz archives. Windows and Linux packages remain unsigned.
Installers replace the existing ReShiki installation. To retain Stable, choose a portable archive and extract it into a separate folder, keeping its contents together. Use copies of drawings when testing. Older nightlies may offer only unsigned portable archives; the release notes identify the available packages.
The all-releases page includes stable releases and nightlies; a newer nightly can appear above stable. The Latest label and the stable download links identify the stable release.
2. Start drawing
Section titled “2. Start drawing”
New drawings start with a blank canvas. Drawing, imports, molecular properties, and chemistry checks work offline from the first launch. The optional assistant needs a Codex connection and internet access. Follow Set up Codex to install it, sign in, and learn how the assistant uses it.
Updates
Section titled “Updates”The channel selector is included in ReShiki 0.10.0. If you use 0.9.1 or earlier, update to the latest stable release first.
Click ReShiki at the top left → Check for updates. Choose Stable (the default) or Nightly in the update window. ReShiki remembers your choice and checks that channel once a day; turn off Check automatically here if you prefer. Changing channels starts a fresh check without turning automatic checks back on.
On Stable, when an update is available, save your drawings and choose Update and restart. ReShiki downloads the matching release, verifies its checksum (and the developer signature on macOS), installs it, and reopens every saved tab in its original order, with the previously front tab in front again. Installation waits for unsaved drawings, pending atom-label edits, assistant drafts and unfinished text/image input to be resolved. Clear the assistant input or attachment when finished with it. If a download or verification fails, the running app stays in place. Release notes opens the release page. Automatic checks never install an update without your click.
On Nightly, choose Download nightly ↗ to download the DMG or Windows setup for your operating system and architecture when available. Older nightlies fall back to ZIP; Linux uses tar.gz. Installation remains manual. Release notes opens the selected build’s table with both installer and portable options, notes and checksums. Nightlies do not use the automatic stable installer. Older app versions label this button Download portable ↗ and always choose an archive.
Switching channels offers the latest release in the chosen channel even when its version number is lower. This lets stable users try a nightly with the same base version, and nightly users return to the latest stable release. Within a channel, only newer versions are offered.