LabScribber is a browser-based, Electron-packaged workstation for academic spectroscopy. It takes instrument data through baseline correction, peak deconvolution, chemometrics and journal-grade export in one application, and is backed by an automated suite of 187 tests covering numerical routines and UI behaviour.
| Signal processing | Baseline correction, smoothing and peak detection across all supported techniques |
| Peak deconvolution | Multi-peak fitting with covariance-based parameter uncertainty |
| Solid-state analysis | Scherrer and Williamson–Hall XRD analysis; Tauc bandgap extraction |
| Chemometrics | PCA, MCR-ALS, PLS and hierarchical clustering |
| NMR | ¹H, ¹³C and 2D COSY |
| Electrochemistry | Cyclic voltammetry and impedance (EIS) |
| Reproducibility | Session files (.lsb), provenance tracking and methods-section text generation |
| Export | Publication-oriented figures and PDF output |
Desktop installers are attached to every release:
| Platform | File |
|---|---|
| Windows | Labscribber-<version>-win-x64.exe (installer) or .zip (portable) |
| macOS | Labscribber-<version>-mac-arm64.dmg (Apple Silicon) or -mac-x64.dmg (Intel) |
| Linux | Labscribber-<version>-linux-x86_64.AppImage (chmod +x, then run) |
The installers are not code-signed yet. Windows: if SmartScreen appears, choose More info → Run anyway. macOS: right-click the app and choose Open the first time. The source is open and the build runs in public CI, so you can verify what you install.
Prefer the browser? See Quick start to run it locally.
Requires Node.js ≥ 20.19
git clone https://github.com/asifverse4/LabScribber.git
cd LabScribber
npm install
npm run devOpen http://localhost:3000.
Desktop app, tests, production build
npm run electron:dev # desktop app (Electron)
npm test # full test suite
npm run test:coverage # coverage report -> coverage/index.html
npm run build # production build
npm run electron:dist # Windows / macOS / Linux installerselectron:dist expects build/icon.ico, build/icon.icns and build/icon.png (PNG at least 512×512). Add them before packaging. See CONTRIBUTING.md for the developer guide and docs/SESSION_FORMAT.md for the .lsb session format.
- 187 automated tests across the numerical core and the UI.
- Continuous integration runs type-check, tests and a production build on every push and pull request (workflow).
- Verified on synthetic data with known ground truth; see the accompanying paper (
paper.md).
LabScribber is evolving into a comprehensive, multi-technique open-source spectroscopy workstation. See ROADMAP.md for our detailed multi-phase engineering plan.
| Phase | Milestone Focus | Key Capabilities |
|---|---|---|
| Phase 1 | High-Performance Compute | Web Worker solver offloading, Levenberg-Marquardt with analytical Jacobians, Rust/WASM matrix kernels |
| Phase 2 | Technique Expansion | 2D hyperspectral Raman/FTIR mapping, EIS equivalent circuit modeling (CNLS), Rietveld/Le Bail PXRD, TRPL lifetimes |
| Phase 3 | Vendor Interoperability | Native binary decoders for Bruker OPUS, Thermo Galactic SPC, Renishaw WDF, VAMAS XPS, and NeXus/HDF5 |
| Phase 4 | FAIR Science & Ecosystem | labscribber-io Python package, Jupyter widgets, direct Zenodo/ELN export, journal composite figure studio |
| Phase 5 | Edge AI & Live Hardware | 100% on-device ONNX spectral matching (FTIR/Raman), WebSerial/WebUSB live spectrometer acquisition |
- Tauc auto-window selection is noise-sensitive, even with the manual wavelength-range safeguard set correctly (paper §2.3). A scoped fix is planned for v1.3.
- AI-assisted interpretation is planned, not implemented. No AI features or cloud dependencies are included in this version.
- Real-instrument validation is ongoing. Validation on non-synthetic datasets is in progress.
Full release history: CHANGELOG.md · Comprehensive roadmap: ROADMAP.md.
If you use LabScribber in your research, please cite it using CITATION.cff. GitHub's Cite this repository button reads it directly. A draft JOSS paper is included (paper.md, paper.bib) but has not been submitted.
Raza, A., & Basheer, H. (2026). LabscribberPro (v1.1.1) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.23689725
Developed at the School of Chemical and Life Sciences, Jamia Hamdard University, New Delhi, India.
Created by Asif Raza · Contributor: Huma Basheer · Supervision: Imran A. Khan · Released under the MIT License