Skip to content

denysdovhan/voxel-viewer

Repository files navigation

Voxel Viewer logo

Voxel Viewer

GitHub Build GitHub Sponsors Buy Me A Coffee Twitter

Note

Web-based viewer for CBCT (Cone Beam Computed Tomography) volumes and scan folders (supports Sirona GALILEOS, DICOM, OneVolume)

Problem

When I visit my dentist, they often send me 3D renderings of my dental scans to my email. The problem is these scans are usually in a format that can only be opened with specific software, usually only for Windows PCs.

I wanted to be able to view these scans on my Mac, or on my phone/tablet in the browser.

Dental and maxillofacial CT exports often arrive as vendor-specific folder structures. I used Codex to reverse-engineer these formats and build a simple web-based viewer for them.

Voxel Viewer solves that by opening supported study folders directly in the browser, parsing them locally, building the volume off the main thread, and rendering linked MPR slices alongside a 3D preview.

Features

Warning

This app is a side-project build for fun and learning. This is not a medical-grade software, and it should not be used for diagnostic purposes.

I built this project over a weekend to view my dental scans. So far it supports the following features:

  • 📁 Open scan folders directly in the browser (File System Access API)
  • 🗃️ Supports popular MRP fomats (Sirona GALILEOS, OneVolume, DICOM)
    • GALILEOS folders with *_vol_0 and *_vol_0_###
    • OneVolume exports with native CT_0.vol
    • DICOM slice folders with .dcm files
  • 🧊 3 axial slices (axial, sagittal, coronal) with linked crosshairs
  • 🦷 Renders 3D model with intersecting plains
  • 📱 PWA-ready, so you can install it on your phone or tablet

Demo

Here is a short demo of what this viewer in action:

demo.mp4

Usage

App Repository
📱 denysdovhan.com/voxel-viewer 👨‍💻 denysdovhan/voxel-viewer
QR code for app QR code for repository

Sponsorship

Your generosity will help me maintain and develop more projects like this one.

Tech Overview

Overall, this is a web-based app built with the following technologies:

  • React, TypeScript - main framework and language
  • Vite - build tool
  • Tailwind - styling
  • Three.js - 3D rendering
  • Web Workers - background processing
  • fflate - compression, unzipping

Contributing

Clone the repository, install dependencies, and start the development server:

npm install
npm run dev

License

MIT © Denys Dovhan