PulmoView: ILO Radiograph Suite

A comprehensive, fully local web application suite for PulmoView: ILO Radiography System for Pneumoconiosis Classification customised to Indian Context

Version: v2.0.0 | Updated: October 11, 2026

Download Your Distribution

Note on Download Size: The repository contains the standard ILO reference images in both JPEG and DICOM formats to allow for seamless offline classification. Because of this, the total size of the viewer and unified distribution is approximately 800 MB. It may take some time to download depending on your internet connection.

Viewer Distribution

For the Doctor / Medical Interpreter. Includes the full ILO classification suite, reporting wizard, and DICOM viewer. Ready to receive images instantly.

Download Package (.zip)

(Extract and open the Viewer_Distribution folder)

Pusher Distribution

For the X-Ray Technician. A lightweight, simple interface to instantly push DICOM files directly to the doctor's screen over the network.

Download Package (.zip)

(Extract and open the Pusher_Distribution folder)

Unified Distribution

For General Use / Single Machine. Contains both apps. An interactive script lets you choose your role (Viewer or Pusher) on startup.

Download Package (.zip)

(Extract and open the Unified_Distribution folder)

Important Setup Instructions:

  1. After downloading, cut or copy the downloaded .zip file from your Downloads folder.
  2. Paste it into your C: drive (or any separate safe storage space depending on your OS). Why? It is highly undesirable to unzip directly into the Downloads folder because that folder is frequently cleared out. If the software is accidentally deleted, you will lose your local patient data and have to redownload the large package.
  3. Once pasted in the safe location, unzip it (e.g., Right-click the file and select "Extract All").
  4. After extraction, you can safely delete the original .zip file so it doesn't block your storage space.
  5. Windows Smart App Control: If you find that Windows Smart App Control is blocking the app from running, you can safely turn it off. Go to Windows Security > App & browser control > Smart App Control settings, and select Off. (Note: This is required because the app is a locally running server and is not a digitally signed Microsoft Store app).
  6. Light & Dark Theme: The application supports both Dark (default) and Light viewing modes. You can instantly toggle between them at any time by clicking the Sun/Moon icon located on the far right side of the main header.

Desktop Shortcut: Inside the downloaded folder, you can double-click Create_Desktop_Shortcut.vbs to create an easy launch shortcut on your Desktop.

Please read the instructions on this page carefully before using the software.

You can visit the YouTube channel for video demos on PulmoView:

Watch on YouTube

What is ILO Radiography?

The International Labour Organization (ILO) International Classification of Radiographs of Pneumoconioses is the globally accepted standard system for evaluating chest radiographs (PA view X-rays). It provides a systematic, simple, and reproducible framework to detect and classify occupational dust-induced lung diseases—collectively known as pneumoconioses (such as silicosis, coal worker's pneumoconiosis, and asbestosis).

Its primary purpose is to establish a standardized, uniform method to record the presence, type, and severity of parenchymal and pleural lung abnormalities. This meticulous grading is crucial for epidemiological research, workplace health screening, and the ongoing medical surveillance of workers exposed to hazardous respirable dusts.

Statutory Requirements in India: Under the Occupational Safety, Health and Working Conditions (Central) Rules, 2026, Initial Medical Examination and periodic medical surveillance of workers engaged in mining and some other establishments is legally mandatory. The classification of these chest radiographs must adhere strictly to the ILO standard, and the findings must be officially recorded and reported using prescribed statutory formats (such as Form IX). Proper ILO grading is a vital legal requirement for determining worker fitness, evaluating occupational disease compensation claims, and maintaining permanent health registries.

This software suite modernizes the evaluation process by providing an interactive, digital side-by-side viewer of the standard ILO 2022 reference images alongside the patient's DICOM files, while simultaneously auto-generating the legally required physical reports (including the mandatory Form IX) for instant printing and archiving.

Hardware & Configuration Requirements

Computer Requirements

  • Operating System: Windows 10/11, macOS, or Linux.
  • Processor: Modern multi-core processor (Intel Core i5 / AMD Ryzen 5 / Apple M1 or better recommended).
  • Memory (RAM): Minimum 8 GB (16 GB or higher recommended).
  • Storage: At least 2 GB of free disk space.
  • Web Browser: Latest version of Google Chrome or Mozilla Firefox.
  • Internet Connection: Only required for PACS features. Otherwise, fully offline.

Diagnostic Monitor (As per ILO)

  • Type: Flat Panel display terminal.
  • Resolution: Minimum 3 Megapixels (e.g., 2048 × 1536).
  • Luminance: Maximum luminance of at least 250 cd/m².
  • Contrast Ratio: Minimum contrast ratio of 250:1.
  • Calibration: DICOM Part 14 Grayscale Standard Display Function (GSDF).
  • Display Size: Minimum 21 inches diagonal.

Laptop Setup

Laptop Screen Data Entry HDMI/USB-C Medical Monitor Dual Viewer

Desktop Setup

Desktop PC Running App Main Port Standard Monitor Data Entry Splitter/Port 2 Medical Monitor Dual Viewer

How to Run

Prerequisites

  • Node.js: Required to run this application. Download the LTS version.
  • Other Dependencies: Automatically installed on first run.

Browser Note: We highly recommend using Google Chrome or Mozilla Firefox.

Windows

  1. Double-click the .bat file (e.g., start_windows.bat).
  2. The script installs dependencies, boots the server, and opens your browser.
  3. Unified Distribution: Press 1 for Viewer or 2 for Pusher.

Mac / Linux

  1. Open a terminal and run chmod +x start_mac_linux.sh.
  2. Run ./start_mac_linux.sh.
  3. Unified Distribution: Press 1 for Viewer or 2 for Pusher.

How to Use the Viewer App

  1. Be comfortably seated in front of the diagnostic display monitor, 25 cm away.
  2. Launch the Viewer (Opens at http://localhost:3000).
  3. Fill out the Reporting Wizard on the left side of the screen.
  4. Click "POP OUT DUAL VIEWER PANEL" to open the side-by-side image viewer in a new window.
    Note: For optimal workflow, the dual viewer panel should be extended to your secondary diagnostic screen. If using a laptop, connect your secondary monitor directly. If using a desktop, use an HDMI splitter (or secondary display port).

    How to Extend Your Display: Press Windows Key + P (or System Preferences → Displays on Mac) and select "Extend". Drag the popped-out window to the medical monitor.
  5. Load a patient DICOM file (via Upload, PACS, or pushed from the Technician).
  6. Compare the patient's X-ray against the ILO Standard Reference Images and fill the form systematically.
  7. Generate and save your final PDF report.

How to Use the Pusher App

  1. Launch the Pusher (Opens at http://localhost:3002).
  2. Find the IP Address of the doctor's computer.
    • Local Network: Use ipconfig (Windows), ifconfig (Mac), or ip a (Linux). Example: 192.168.1.100
    • Remote Network: Use Tailscale to get a secure IP (e.g. 100.115.92.2).
  3. In the Pusher App, enter the target address:
    http://192.168.1.100:3000/api/dicom-receiver
  4. Drag and drop a patient's .dcm file into the designated area, or upload it directly from any local or external storage drive.
  5. The image will instantly appear on the doctor's screen without them needing to refresh!

How to Use PACS

If your facility uses a PACS server (like Orthanc) with a DICOMweb endpoint enabled:

  1. Open the Viewer App and click the "Connect to PACS" button.
  2. In the "Network Setup" tab, enter your PACS DICOMweb URL
    http://192.168.1.50:8042/dicom-web
  3. Provide a Username and Password if required.
  4. Go to the "Query / Retrieve" tab.
  5. Enter the Patient Name or ID and click Search.
  6. Click on any study to instantly fetch and render the DICOM files!

Privacy & Data Confidentiality

  • 100% Locally run inside your own computer & Offline: (internet/LAN connection only require if PACS system is used).
  • No Telemetry & No Cloud Storage: No data leaves your computer.
  • Data Security: Compliant with local setups as long as hardware is secured.

Updates and Versioning

Current Version: v2.0.0

You are currently on the official updates page! Compare this version with the one shown in your Viewer App's footer.

What's New in v2.0.0:

  • Dynamic Skip-Pattern Workflow: Marking "No" in Section 2A jumps to 3A; "No" in 3A (or 3C) jumps to 4A; "No" in 4A jumps directly to Section 5.
  • Synchronized Abbreviated PDF Reporting: Pleural abnormality selection precisely matches between entry form and printed PDF; selecting "No" avoids redundant zero marks.
  • Overall Assessment Validation: Requires explanatory clinical comments if an X-ray is deemed abnormal when individual sub-sections are negative.
  • Optimized Action Navigation: Standardized ALL-CAPS footer buttons and refined report completion controls.

How to Install an Update:

  1. Download the new .zip package and extract it to a new folder.
  2. Do not overwrite the old folder immediately.
  3. Your patient history and doctor profile are saved in your browser's localStorage. They automatically carry over as long as you use the same browser.
  4. Once verified, safely delete the old folder.

Why This Suite is Novel

  • Zero Server Configuration: Direct DICOM pushing without heavy backend installations.
  • Integrated Standard Viewing: Seamless side-by-side comparison against digital ILO standards.
  • Interactive Reporting: Fill forms and generate PDFs in one workflow.

License & Acknowledgments

Copyright & Free Use

Copyright © 2026 Dr. Arkaprabha Sau. All Rights Reserved.

Available free of charge under the PULMOVIEW Free Use and Attribution License v1.0. Users may use, copy, distribute, modify, and integrate the software for lawful purposes. No license fee is required.

Attribution — Required (CC BY 4.0)

This software is licensed under terms aligned with the Creative Commons Attribution 4.0 International (CC BY 4.0) license. Users must acknowledge the developer when PULMOVIEW is used, distributed, or modified.

PULMOVIEW was developed by Dr. Arkaprabha Sau, MBBS, MD (Gold Medalist), DPH, Dip. Geriatric Medicine, CCEBDM, Ph.D. (Computer Science and Engineering: AI & ML in Healthcare).

Medical Disclaimer

PULMOVIEW is a software tool and does not replace professional medical judgment, clinical examination, diagnostic procedures, or applicable regulatory requirements. Users are responsible for evaluating suitability.