ILO Radiograph Suite

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

Distribution Infographic

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 distribution is approximately 1.4 GB. 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, drag-and-drop tool to push DICOM patient files directly to the doctor's screen over the local network (or remotely from anywhere using Tailscale).

Download Package (.zip)

(Extract and open the Pusher_Distribution folder)

Unified Distribution

For All-in-One setups. Contains both applications. Running the startup script presents an interactive menu to choose your role.

Download Package (.zip)

(Extract and open the Unified_Distribution folder)

What is ILO Radiography?

The International Labour Organization (ILO) International Classification of Radiographs of Pneumoconioses is a standard system for classifying chest radiographs (X-rays) for pneumoconiosis (dust-induced lung diseases like silicosis, coal worker's pneumoconiosis, and asbestosis).

Its purpose is to provide a standardized, reproducible way to record the presence and severity of lung abnormalities, which is crucial for epidemiological research, screening, and medical surveillance of workers exposed to hazardous dusts. This software suite provides a digital side-by-side viewer of standard ILO reference images alongside patient DICOM files to assist physicians in grading these conditions.

How to Run (Windows, Mac, Linux)

Prerequisite: You must have Node.js installed on your computer.

Windows:

  1. Extract the downloaded ZIP folder completely.
  2. Double-click the .bat file (e.g., start_viewer_windows.bat).
  3. The script will automatically install dependencies on its first run, boot the server, and open your web browser.

Mac / Linux:

  1. Open a terminal and navigate to the extracted folder.
  2. Make the script executable: chmod +x start_mac_linux.sh (or the equivalent script name).
  3. Run the script: ./start_mac_linux.sh

How to Use the Viewer App

  1. Launch the Viewer using the instructions above. (Opens at http://localhost:3000).
  2. Fill out the Reporting Wizard on the left side of the screen.
  3. Click "POP OUT DUAL VIEWER PANEL" to open the side-by-side image viewer in a new window.
  4. Load a patient DICOM file (via Upload button, PACS, or pushed from the Technician).
  5. Compare the patient's X-ray against the ILO Standard Reference Images.
  6. Generate and save your final PDF report.

How to Use the Pusher App

  1. Launch the Pusher using the instructions above. (Opens at http://localhost:3002).
  2. Find the IP Address of the doctor's computer (where the Viewer App is running).
    • Windows: Open Command Prompt and type ipconfig (look for IPv4 Address).
    • Mac: Open Terminal and type ifconfig | grep inet, or check System Settings > Network.
    • Linux: Open Terminal and type ip a or hostname -I.
  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.
  5. The image will instantly appear on the doctor's screen!

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 (e.g., 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% Local & Offline: Operates completely inside your local network.
  • No Telemetry & No Cloud Storage: No data ever leaves your computer or is sent to third parties.
  • Data Security: Compliant with local setups as long as your hardware is secured.

Why This Suite is Novel

Updates and Versioning

Current Version: 1.0.0

You are currently on the official updates page! (You can always return here by clicking the "Updates" button in the Viewer App footer).

How to check for updates: Compare the "Current Version" listed above with the version number shown in your Viewer App's footer. If this page shows a newer version, download the latest .zip package for your distribution from the Download Your Distribution section above.

How to Install an Update:

  1. Download the new .zip package from GitHub and extract it to a new folder.
  2. Do not overwrite the old folder immediately.
  3. Since the software runs locally, your patient history and doctor profile are saved in your browser's localStorage. They will automatically carry over as long as you open the new version in the same browser on the same computer.
  4. Once you have verified the new version works, you can safely delete the old folder.