Radiopaedia Case PowerPoint Builder

Windows desktop app for building case-based radiology PowerPoints from Radiopaedia.

Add case requests, review the prepared cases and images, then export the approved cases to PowerPoint. The app uses a C# WPF interface with a local Node backend.

What It Builds

For each approved case, the app creates a teaching sequence:

1. Case N
2. radiology image slide
3. diagnosis slide
4. optional teaching-points or Core Review slide

The case intro slide avoids giving away the diagnosis when possible. If clean patient information is available and enabled, it uses minimal age/sex context such as The patient is a 50-year-old female.

Features

• Case requests for named diagnoses, random pulls, or exact Radiopaedia URLs.
• Dropdown filters for modality, anatomy, area, age group, topic focus, and difficulty.
• Random selection that avoids recent, skipped, and rejected cases when possible.
• Review before export, with controls to keep, favorite, skip, reroll, re-pick, replace, remove, or manually choose images.
• Deterministic image-selection rationale in the review window and generated manifest.
• Local Library view for reviewed cases and favorites.
• PowerPoint presets including Fast Preview, Ollama Assisted, Core Review Teaching, and Dark Conference.
• Separate Core Review workflow for review decks without using the Cases view.
• Optional local Ollama image scoring for prepared images as a review aid.
• Random mode searches live Radiopaedia first and avoids cases selected in previous random runs by default.
• Local SQLite cache for Radiopaedia metadata, image candidates, random history, review decisions, and backend diagnostics.
• Persistent local Node backend service with idle health checks.

Documentation

• User Guide
• Decision Logic
• AI Boundaries
• Architecture
• Troubleshooting
• Manual Radiology Smoke Test
• Contributing
• Releasing
• Security And Privacy

Install

Install from GitHub Releases:

1. Open the GitHub Releases page.
2. Download the latest Radiopaedia-Case-PowerPoint-Builder-Setup-v*.exe.
3. Run the installer.
4. Launch Radiopaedia Case PowerPoint Builder from Start or the optional desktop shortcut.

For source-checkout development, build the packaged app under dist\:

dist\Radiopaedia Case PowerPoint Builder\Radiopaedia Case PowerPoint Builder.exe

If the packaged app is missing, build it from the repository root:

.\build-csharp-app.ps1
.\create-desktop-shortcut.ps1

Run from source while developing:

dotnet run --project .\csharp\RadiologyPpt.App\RadiologyPpt.App.csproj

Source-checkout builds expect the packaged executable to stay inside this repository. The app locates backend resources by walking up to the project root and finding src\backend-service.mjs; copying only the .exe elsewhere will not work.

Basic Workflow

1. Add case requests in Cases.
2. Set filters if needed.
3. Choose PowerPoint options or a preset.
4. Click Generate PowerPoint.
5. Review cases and images.
6. Export the approved cases.

There is no success popup after export. Use the left status area, Activity, Open Last PowerPoint, or Open Outputs Folder.

Navigation

• Cases: request grid for diagnoses, random pulls, or Radiopaedia URLs.
• Core Review: generate review PowerPoints and import PDFs, Word .docx documents, PowerPoint .pptx decks, notes, or JSON study material for local practice questions.
• Library: local history of reviewed cases with decision, image count, score, and case path.
• Activity: diagnostics, backend logs, SQLite/cache counts, state folder access, cleanup, and maintenance.

The app keeps main and review windows within the visible Windows work area on launch, including high-DPI/scaled displays.

Review Window

Use the review window to approve cases and adjust images before export.

Core actions include keep, favorite, skip, reroll, re-pick images, replace unchecked images, remove unchecked images, and manual candidate selection. Details shows source metadata, warnings, prompt text, and image-selection rationale.

Keyboard shortcuts: K keep, F favorite, S skip, R reroll, I re-pick, Delete remove unchecked, and Esc cancel.

Local Data

The app writes generated/private data to:

• state\radiology-ppt.sqlite
• cache\
• scratch\
• outputs\
• review-sessions\
• library\board-review\

Source-checkout runs use the repository root. Installed runs use %LOCALAPPDATA%\RadiopaediaCasePowerPointBuilder. The Activity tab shows the active paths.

These paths are ignored by Git. SQLite stores settings, review history, generated PowerPoint metadata, backend cache rows, random history, case/image decisions, backend job diagnostics, prepared-case indexes, and schema migrations.

Use the Activity tab to refresh diagnostics, clean scratch files, clean old cache files, open the state folder, or run maintenance/SQLite optimization.

Architecture Summary

• csharp\RadiologyPpt.App: C# WPF desktop GUI, review flow, settings, local storage, and view models.
• csharp\RadiologyPpt.App\BackendClient.cs: JSONL process boundary to the local Node service.
• csharp\RadiologyPpt.App\BackendContracts.cs: C# payload builders/readers for the Node JSON contract.
• csharp\RadiologyPpt.App\BackendHealthMonitor.cs: backend ping/restart watchdog.
• src\backend-service.mjs: persistent local JSONL backend service.
• src\backend-api.mjs: workflow API for prepare, score, render, Core Review PowerPoint planning, ingestion, and quiz assembly.
• src\radiopaedia.mjs: small facade for Radiopaedia case fallback orchestration.
• src\radiopaedia-search.mjs: search URLs, search-result parsing, random selection, indexed random reuse, and random-history expansion.
• src\radiopaedia-case-fetch.mjs: case page loading, study/image loading, image preparation, and final case assembly.
• src\radiopaedia-case-text.mjs: patient data, intro text, prompt redaction, and teaching points.
• src\app-store.mjs: backend SQLite cache/history/index/review-decision storage.
• src\deck.mjs: PowerPoint rendering.
• src\contracts: JSON schema contracts for C# to Node payloads.
• docs\DECISION_LOGIC.md: explanation of case, image, random, and storage decisions.

See Architecture for details.

Developer Setup

Prerequisites:

• .NET 8 SDK / Windows Desktop runtime
• Node.js
• npm install or npm ci
• PowerShell

Run checks before pushing:

npm test
dotnet build .\csharp\RadiologyPpt.App\RadiologyPpt.App.csproj --configuration Release

Build and refresh the desktop app:

.\build-csharp-app.ps1
.\create-desktop-shortcut.ps1

Build the Windows installer:

.\build-windows-installer.ps1 -Version 0.3.1

GitHub Actions runs Node tests and the WPF Release build on Windows.

Core Review

Core Review has its own review-deck path. Set a case count, domain, random selection mode, modality mix, and optional output .pptx path, then click Generate Core Review PowerPoint. The app builds a domain-scoped plan, searches Radiopaedia for matching cases, opens the normal review window, and exports only the cases/images you approve. You do not need to select cases in the Cases tab for this workflow.

The bundled diagnosis seed list is original practice scaffolding aligned to public ABR Core domains. It is not official ABR content and is not a board-recall list.

Core Review can also import local PDFs, Word .docx documents, PowerPoint .pptx decks, notes, and JSON source material into a local study library under library\board-review\. The imported corpora stay local and are not committed. PDF imports keep page provenance, save page/image assets locally, crop caption-adjacent figure regions when possible, and attach the best supported source image to generated standalone questions.

Use the Core Review Import Sources control for study material. The Cases importer is only for Radiopaedia request rows or request-list files, and rejects PDF/binary-looking content so raw PDF object text does not become garbage case requests. Legacy .doc and .ppt files should be saved as .docx or .pptx before import.

Core Review PowerPoints can source standalone NIS and physics practice questions from:

• the bundled free practice bank
• the imported local Core Review library
• a custom question-bank JSON file

Question sources affect standalone NIS/physics slides. Case selection comes from the CORE diagnosis plan plus Radiopaedia search and review.

The repository does not bundle copyrighted board-review books or question banks. Import local materials only when you have the right to use them. Generated Core Review corpora remain ignored by Git.

License

This app's source code is licensed under the MIT License. See LICENSE.

The MIT License applies to this repository's code, not to Radiopaedia cases/images or user-imported study material. Generated PowerPoints include Radiopaedia attribution; keep that attribution and follow source material terms.