Installation
CView releases may provide ready-to-install packages. Check the release assets for your platform; package availability can vary by release.
Tip
New to software installation? Just pick your operating system below and follow the pictures-and-clicks instructions. It’s as easy as installing any app!
Windows 10 / 11
Step-by-Step Installation
-
Download the installer
- Go to: CView Releases
- Click on:
cview-installer.exe(19.8 MB) - The file will download to your Downloads folder
-
Run the installer
- Find
cview-installer.exein your Downloads folder - Double-click it to start installation
- Find
-
Handle the security warning (if it appears)
- Windows might show: “Windows protected your PC”
- Click “More info”
- Then click “Run anyway”
Note
The installer is not code-signed, so Windows SmartScreen shows it as coming from an “Unknown publisher”. This is expected for small open-source projects: a signing certificate costs money, and the free programmes for open-source software are limited to large projects. CView is built from its public source code by GitHub Actions; each release lists a
cview-installer.exe.sha256checksum you can compare against (Get-FileHash cview-installer.exein PowerShell). Download it only from the official Releases page. -
Follow the installation wizard
- Click “Next” through the steps
- Choose install location (default is fine)
- Wait for installation to complete (takes ~30 seconds)
-
Launch CView
- Find “CView” in your Start Menu
- Or double-click the desktop shortcut (if you chose to create one)
That’s it! CView is now installed and ready to use.
macOS (Intel & Apple Silicon)
Step-by-Step Installation
-
Download the disk image
- Go to: CView Releases
- Click on:
cview-macos.dmg(15.9 MB) - The file will download to your Downloads folder
-
Open the DMG file
- Find
cview-macos.dmgin Downloads - Double-click to open it
- A new window will appear showing the CView icon
- Find
-
Install CView
- Drag the CView icon into the Applications folder icon
- Wait for the copy to complete (a few seconds)
-
First launch security step
When you first open CView from Applications, macOS will block it because it’s not from the App Store.
Option A: Right-click method (easiest)
- Find CView in your Applications folder
- Right-click (or Control-click) on CView
- Select “Open” from the menu
- Click “Open” again in the warning dialog
Option B: Terminal command (if right-click doesn’t work)
- Open Terminal (Applications → Utilities → Terminal)
- Type:
xattr -cr /Applications/CView.app - Press Enter
- Now open CView normally
-
Launch CView
- Find CView in Applications or use Spotlight (⌘ + Space, type “CView”)
- After the first launch, it will open normally like any Mac app
Important
The security step is only needed once. After that, CView opens normally.
Linux
File to download: cview.flatpak (1.11 MB)
CView for Linux ships as a Flatpak, which works on all Linux distributions.
One-time setup (if you haven’t used Flatpak before):
# Ubuntu/Debian
sudo apt install flatpak
# Fedora (already included)
# Nothing needed!
# Arch
sudo pacman -S flatpak
# openSUSE
sudo zypper install flatpak
Install CView:
# Download
wget https://github.com/mavensgroup/cview/releases/latest/download/cview.flatpak
# Install (no sudo needed with --user)
flatpak install --user cview.flatpak
# Run CView
flatpak run org.mavensgroup.cview
CView will also appear in your applications menu.
Note
Flatpak runs apps in a secure sandbox. Your files are accessible, but CView is isolated from the rest of your system.
Quick Reference Table
| Operating System | File to Download | Size | Installation Method |
|---|---|---|---|
| Windows 10/11 | cview-installer.exe | 19.8 MB | Run installer, click “Next” |
| macOS (Intel/M1/M2/M3) | cview-macos.dmg | 15.9 MB | Drag to Applications |
| Linux (any distribution) | cview.flatpak | 1.11 MB | flatpak install |
Download from: https://github.com/mavensgroup/cview/releases/latest
Build from Source (Advanced Users)
If you want the latest development version or prefer to compile yourself, you can build CView from source.
Prerequisites
You need:
- Rust (1.75 or newer)
- GTK4 development libraries
- Git
Install Dependencies
Ubuntu / Debian
# Install GTK4 development headers and build tools
sudo apt update
sudo apt install build-essential libgtk-4-dev libadwaita-1-dev git
# Install Rust (if not already installed)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
Fedora / RHEL
# Install GTK4 and build tools
sudo dnf install gcc gtk4-devel libadwaita-devel git
# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
Arch Linux
# Install dependencies
sudo pacman -S base-devel gtk4 libadwaita git rust
# Rust is now installed
macOS
# Install Homebrew if you don't have it
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install dependencies
brew install rust gtk4 libadwaita git
Windows (MSYS2)
- Install MSYS2 from msys2.org
- Open “MSYS2 MinGW 64-bit” terminal
- Run:
pacman -S mingw-w64-x86_64-gtk4 mingw-w64-x86_64-rust mingw-w64-x86_64-gcc git
- Add
C:\msys64\mingw64\binto your Windows PATH
Compile and Run
# Clone the repository
git clone https://github.com/mavensgroup/cview.git
cd cview
# Build and run (release mode for best performance)
cargo run --release
First compilation takes 5-10 minutes as Rust downloads and compiles all dependencies. Subsequent builds are much faster.
Install System-Wide (Optional)
# This installs the binary to ~/.cargo/bin/cview
cargo install --path .
# Make sure ~/.cargo/bin is in your PATH
# Add this to your ~/.bashrc or ~/.zshrc:
export PATH="$HOME/.cargo/bin:$PATH"
# Now you can run CView from anywhere
cview
Troubleshooting
macOS: “CView is damaged and can’t be opened”
This means the quarantine flag is still set. Remove it:
xattr -cr /Applications/CView.app
Then try opening CView again.
Windows: “VCRUNTIME140.dll is missing”
Install the Visual C++ Redistributable:
- Download from: Microsoft’s official site
- Install and restart
Build from source fails: “gtk4 not found”
Make sure you installed the development packages (with -dev or -devel suffix), not just the runtime libraries.
# Ubuntu/Debian - WRONG
sudo apt install gtk4
# Ubuntu/Debian - CORRECT
sudo apt install libgtk-4-dev libadwaita-1-dev
Flatpak: “No remote refs found”
Make sure Flathub is added:
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
Still Having Issues?
- Check the GitHub Issues page
- Open a new issue with:
- Your operating system and version
- The exact error message
- What you’ve already tried
- We’ll help you get CView running!
Verifying Your Installation
After installation, launch CView and try:
- Click File → Open
- Load a sample structure (we include examples in the repository)
- If you see atoms and can rotate the structure → Success!
Welcome to CView! Check out the User Guide to get started.