CBCTScope User Manual v2.1.1 Research use only. Not a medical device. Open the viewer

CBCTScope User Manual

A complete, local-first CBCT and 2D radiograph viewer, built by a board-certified oral and maxillofacial radiologist.

It can also be driven by an AI agent over MCP, under one rule: the agent moves the camera, the human reads.

Software version 2.1.1
Manual revision November 2026
Author Dr. Reza Motaghi, oral and maxillofacial radiologist
Project page https://github.com/rezamotaghi/cbctscope
Contact https://rezamotaghi.com/contact

Intended use

CBCTScope is research software for visualizing and navigating cone-beam CT volumes and 2D dental radiographs on the user's own computer. It is intended for research, education, and methodological work such as multi-reader studies.

CBCTScope is not a medical device. It produces no findings, no measurements-as-conclusions, and no diagnoses, in the interface or over the AI-agent connection. Do not use it for clinical decision-making. Density values in CBCT are approximate by nature; every number the software reports is raw geometry or raw density, and its interpretation is the reader's alone.

How to read this manual

  • Bold text names an element you can see in the interface, such as the Open button.
  • Code text is something you type, or a key you press, such as npm run demo or R.
  • A blockquote marked Note adds context; one marked Caution prevents a mistake.

Chapters 1 to 7 cover the application as a whole: installing it, the screen, opening images, display, measuring, and exporting. Chapter 8 introduces the eight reading modes; each mode then has its own guide written from clinical reading practice. Chapters 9 to 12 cover AI-agent control, data handling, troubleshooting, and the keyboard and mouse reference.

License and citation

CBCTScope is free software under the AGPL-3.0-or-later license. If you use it in research, please cite it: the citation record is the CITATION.cff file in the repository (the viewer's Help menu, Cite this software, shows it as a reference line and a BibTeX entry), and the archived releases carry DOI 10.5281/zenodo.21431452.