VitalRecorder Downloaded 190,842 times since Feb 2017 · Free for research and clinical use
Free software to record and analyze biosignal waveforms and vital signs from patient monitors (GE, Philips, Drager, Nihon Kohden, Masimo…), anesthesia machines, ventilators, infusion pumps and ADCs. Full list of supported devices
Get started
- InstallRun the installer for your platform (Raspberry Pi: see the Pi 64 tab). User manual
- Connect your devicesSerial or network cable to the monitor, ventilator, or pump. Supported devices · Connection guide
- Record and watch liveRecordings are saved as .vital files and can be uploaded to My Files. Web Monitoring guide
Stuck? Ask VitalDB AI — it answers from the docs and past forum threads.
Download latest releases
more
more
more
1.19.382026-11-15
1.19.38 Fixed: Windows 에서 웹 모니터링 전송이 몇 초마다 끊기던 문제. 1.18.44 부터 Windows 판 VR 은 mod.vitaldb.net 처럼 https(wss) 로 접속하는 서버에 보낼 때, 서버에서 받을 것이 없어 읽기가 시간 초과되면 암호화 연결이 망가져 다음 전송이 실패하고(로그의 websocket send error) 5초 뒤 다시 접속하기를 되풀이했다. 그래서 웹 모니터에 데이터가 띄엄띄엄 오거나 거의 오지 않았다. 이제 한 번 맺은 연결로 계속 보낸다. 전송이 실패하면 그 이유를 로그의 같은 줄에 남긴다. 리눅스 판(PiVR 포함)과 1.18.43 이전 Windows 판은 이 문제가 없었다.
more1.19.372026-11-15
1.19.37 Added: VRN(Vitalnode)을 VR 에서 바로 받는다. 장비 설정의 port 에 VRN 의 MAC 을 적으면 (10bda3c85168, 10:bd:a3:c8:51:68, 10-BD-A3-C8-51-68, 또는 4300@10bda3c85168) VR 이 그 VRN 의 접속을 4300 포트(@ 앞에 적은 포트)에서 받아, VRN 이 모니터에서 읽은 파형과 수치를 그 장비의 트랙으로 녹화하고 웹 모니터링으로 보낸다. 지금까지는 VRN 서버(vrnserver)가 따로 있어야 했다. 장비 종류와 옵션(Intellivue 의 wavs 등)은 VR 설정에서 VRN 으로 내려가고, VRN 의 시계도 VR PC 의 시계에 맞춘다. 설정에 MAC 이 없는 VRN 은 받지 않는다. Changed: MAC 만 적은 port 는 이제 VRN 을 뜻한다. 예전처럼 VitalConnect 연결로 쓰이지 않는다. Changed: 진단 로그를 영어로 통일했다. Intellivue 파형 요청·응답, Nihon Kohden 에러 응답, 시계 보정, SERVER_CONTROL 등의 로그가 한글이어서 해외 사용처에서 읽을 수 없었다. Fixed: 같은 TCP 포트에 종류가 다른 장비 둘을 두면(예: [email protected] 은 Intellivue, [email protected] 는 Primus) 두 번째 장비가 열리지 않던 문제. Fixed: 리눅스에서 VR 을 다시 시작한 직후 TCP 서버 포트를 최대 60초 동안 열지 못해 그동안 장비가 붙지 않던 문제.
more1.18.402026-05-12
Hotfix: Drager Medibus 프로토콜 사용 베드에서 1.15.11 이후 vr.service 가 SIGSEGV 로 무한 재시작하던 문제. 1.15.10 (a8c7b2a) 의 "Sampling rate estimation" 리팩터링이 m_ptrk_awp/awf/co2 트랙을 add_trks() 에서의 eager 생성 (default srate=62.5Hz) 에서 realtime data 100 샘플 모인 후 lazy 생성으로 바꿨는데, Medibus 핸드셰이크 순서 (0x51 ICC → 0x52 DeviceID → 0x53 RealtimeConfig 응답 → 0x54 → realtime data 시작) 상 0x53 응답 핸들러 (Drager.cpp:295-307) 가 트랙들이 아직 nullptr 인 시점에 `ptrk->m_srate = 1000000.0/interval` 로 NULL 역참조 → 즉시 SEGV. 그 베드의 vr.service 가 systemd Restart=on-failure 로 재시작 → 다시 connect → 동일 0x53 패킷 받고 동일 SEGV → 무한 루프 (journald 로그상 restart counter 61 까지 누적, code=killed status=11/SEGV). 1.15.9 까진 트랙이 add_trks() 에서 생성되어 0x53 도착 시 항상 non-NULL 이라 안전했음. 수정: (a) add_trks() 에서 m_ptrk_awp/awf/co2 eager 생성 복원 (srate=62.5Hz default) — 0x53 는 ptrk->m_srate 만 갱신 (트랙 재생성 X). (b) on_received() 의 lazy creation + packet-timing srate 추정 블록 제거 — 0x53 가 권위 있는 srate 소스이고 packet 타이밍 기반 추정은 network jitter 에 약해 불안정. (c) 0x53 핸들러에 `if (interval > 0)` guard 추가 — 페이로드 깨졌을 때 div-by-zero / inf srate 방지. 영향 범위: Drager Primus / Apollo / Perseus / Fabius 등 Medibus 사용 마취기 전부. 우회 방법은 1.15.9 다운그레이드 외엔 없었음 (그 베드의 모든 데이터 유실 + 환자 모니터링 불가). MFC + Qt + Pi (RPI64) + Ubuntu Qt + AppImage 빌드 모두 통과.
more1.18.372026-05-08
Refactored: 필터 다이얼로그의 python 런타임 — pyvital → openvital 0.3.0 로 교체 + 동봉 python.zip 슬림화. 핵심 동기 셋: (1) pyvital 0.6.0 이 tensorflow+torch+keras 를 hard-dep 으로 끌어들여 PyPI upgrade 가 사실상 깨짐, (2) 기존 zip 121 MB 안에 botocore/aiobotocore/s3fs/pyarrow/pandas/aiohttp 등 vitaldb 클라우드 업로드용 deps 가 ~250 MB unpacked 차지 — 필터 서버는 한 번도 쓴 적 없는 dead weight, (3) sanic 25.x 의 multi-process worker 가 openvital __main__.py 를 fork 후 재import 하면서 worker 가 module-top app instance 를 못 찾아 "Sanic app name not found" 로 죽음 — 단순 endpoint 2개 로컬호스트 서버에 async stack 자체가 과함. 해결: openvital 0.3.0 (commit b6f445b) 가 sanic 을 stdlib http.server (BaseHTTPRequestHandler + HTTPServer) 로 50 LOC 재작성 — wire protocol (GET / 필터목록 JSON, POST /<modname> gzip 본문) 동일해 VR 클라이언트 변경 0줄. 단일 스레드로 기존 sanic event loop semantics (cfgs/default_cfgs lock-free 변경) 보존. build_python_zip.py (NEW) 가 Python 3.11.9 embed + numpy + openecg + openvital (local checkout 우선, fallback PyPI) 만으로 27 MB zip 빌드 — 기존 121 MB 대비 78% 감소. ML 필터 (sv_dlapco/abp_hpi/ecg_classifier/ecg_beat_noise_detector) 는 [Hybrid 모델] 사용자가 Add filter 다이얼로그의 "Install ML filters" 버튼 누를 때 silent pip install openvital[all] (cmd 창 미노출 — VRApp::install_pip_package + run_pip_silent 이 자체 progress 다이얼로그에 stdout heartbeat 흘림). 버튼 라벨은 "Upgrade pyvital" → "Install ML filters" 로 의도 명시. openvital __main__.py 가 missing extras 를 graceful skip 하므로 base 환경에서도 11개 필터 (ECG QRS detector, HRV, MTWA, annotator, eeg_fft, nirs_cox, pkpd_3comp, pleth_dpop/ptt/pvi, resp_compliance) 즉시 사용 가능. Migration: 기존 사용자의 user_dir/python 폴더는 pyvital + 옛 deps 가 그대로 남아있고 vitaldb.net/python.zip 만 새로 올리면 (a) 기존 폴더 삭제 후 install_python 으로 새 zip 받으면 깔끔, (b) 폴더 유지 시 server 가 openvital 못 찾아 필터 다이얼로그 에러 → release note 에 명시 필요. MFC + Qt 양쪽 코드: VRGui.rc 의 IDC_UPGRADE 버튼 라벨 + DlgAddFilter.cpp 의 dist-info prefix 매칭 (pyvital- 8자 → openvital- 10자) + QtDlgAddFilter.cpp 도 동일 변경 + onUpgrade 가 cmd /k QProcess::startDetached 대신 theApp.install_pip_package("openvital[all]") 호출 (Linux Qt 빌드는 #ifdef _WIN32 가드). VRApp.cpp:318 의 python -m pyvital → -m openvital. install_pip_package 는 anonymous namespace 의 is_safe_pkg_spec 화이트리스트 검증 + run_pip_silent (CreateProcessA + CREATE_NO_WINDOW + 자식 stdout pipe) + CDlgProgress / QtDlgProgress 자체 progress UI. 빌드 검증: python -m openvital 이 GET / 로 11 필터 반환, sanic import 부재 확인. zip 27.5 MB.
more1.18.332026-04-25
Fixed: Demo device never started since 1.18.11 (bed_manager skipped empty port_name as passive but Demo has no port and still needs lock_and_open); Fixed: Qt fit-to-window button rendered at top-left (0,0) instead of right-aligned in bottom nav bar; Fixed: Qt crash when closing tab / deleting device / deleting filter - paint dereferenced freed pointer before panel timer rebuilt items (added MFC-style stale-pointer guard to QtDeviceItem and QtFilterItem); Added: macOS DMG main window now shown on launch (restoreWindowPos had no Mac/Linux branch); Added: macOS Homebrew dylibs (openssl) bundled in Contents/Frameworks; Added: macOS .app bundle now notarized + stapled (drag-to-Applications no longer needs xattr -cr on first launch); Changed: Qt MSI ~1MB smaller (dropped unused iconengines and imageformats plugins)
more1.18.312026-04-22
Added: drug slot shows DOSE_AMOUNT (mg etc) in preference to VOL (mL) when available; Added: DOSE_RATE / DOSE_AMOUNT montypes bound to BBraun tracks for monitor view; Added: HL7 MDC_DOSE_DRUG_DELIV_TOTAL unit picked up dynamically from UCUM
moremore
more
more
1.19.382026-11-15
1.19.38 Fixed: Windows 에서 웹 모니터링 전송이 몇 초마다 끊기던 문제. 1.18.44 부터 Windows 판 VR 은 mod.vitaldb.net 처럼 https(wss) 로 접속하는 서버에 보낼 때, 서버에서 받을 것이 없어 읽기가 시간 초과되면 암호화 연결이 망가져 다음 전송이 실패하고(로그의 websocket send error) 5초 뒤 다시 접속하기를 되풀이했다. 그래서 웹 모니터에 데이터가 띄엄띄엄 오거나 거의 오지 않았다. 이제 한 번 맺은 연결로 계속 보낸다. 전송이 실패하면 그 이유를 로그의 같은 줄에 남긴다. 리눅스 판(PiVR 포함)과 1.18.43 이전 Windows 판은 이 문제가 없었다.
more1.19.372026-11-15
1.19.37 Added: VRN(Vitalnode)을 VR 에서 바로 받는다. 장비 설정의 port 에 VRN 의 MAC 을 적으면 (10bda3c85168, 10:bd:a3:c8:51:68, 10-BD-A3-C8-51-68, 또는 4300@10bda3c85168) VR 이 그 VRN 의 접속을 4300 포트(@ 앞에 적은 포트)에서 받아, VRN 이 모니터에서 읽은 파형과 수치를 그 장비의 트랙으로 녹화하고 웹 모니터링으로 보낸다. 지금까지는 VRN 서버(vrnserver)가 따로 있어야 했다. 장비 종류와 옵션(Intellivue 의 wavs 등)은 VR 설정에서 VRN 으로 내려가고, VRN 의 시계도 VR PC 의 시계에 맞춘다. 설정에 MAC 이 없는 VRN 은 받지 않는다. Changed: MAC 만 적은 port 는 이제 VRN 을 뜻한다. 예전처럼 VitalConnect 연결로 쓰이지 않는다. Changed: 진단 로그를 영어로 통일했다. Intellivue 파형 요청·응답, Nihon Kohden 에러 응답, 시계 보정, SERVER_CONTROL 등의 로그가 한글이어서 해외 사용처에서 읽을 수 없었다. Fixed: 같은 TCP 포트에 종류가 다른 장비 둘을 두면(예: [email protected] 은 Intellivue, [email protected] 는 Primus) 두 번째 장비가 열리지 않던 문제. Fixed: 리눅스에서 VR 을 다시 시작한 직후 TCP 서버 포트를 최대 60초 동안 열지 못해 그동안 장비가 붙지 않던 문제.
more1.15.102025-07-14
Bug Fixed: Sampling rate estimation in Medibus protocol.
more1.15.92025-06-03
Bug Fixed: EEG waveform labels from Philips monitors.
more1.15.82025-05-26
Added: EM_UPLOAD option to upload vital files to server immediately
more1.15.72025-05-26
Bug Fixed: Websocket connection error
more1.15.62025-05-19
Bug Fixed: S5 checksum error
moremore
more
more
1.19.382026-11-15
1.19.38 Fixed: Windows 에서 웹 모니터링 전송이 몇 초마다 끊기던 문제. 1.18.44 부터 Windows 판 VR 은 mod.vitaldb.net 처럼 https(wss) 로 접속하는 서버에 보낼 때, 서버에서 받을 것이 없어 읽기가 시간 초과되면 암호화 연결이 망가져 다음 전송이 실패하고(로그의 websocket send error) 5초 뒤 다시 접속하기를 되풀이했다. 그래서 웹 모니터에 데이터가 띄엄띄엄 오거나 거의 오지 않았다. 이제 한 번 맺은 연결로 계속 보낸다. 전송이 실패하면 그 이유를 로그의 같은 줄에 남긴다. 리눅스 판(PiVR 포함)과 1.18.43 이전 Windows 판은 이 문제가 없었다.
more1.19.372026-11-15
1.19.37 Added: VRN(Vitalnode)을 VR 에서 바로 받는다. 장비 설정의 port 에 VRN 의 MAC 을 적으면 (10bda3c85168, 10:bd:a3:c8:51:68, 10-BD-A3-C8-51-68, 또는 4300@10bda3c85168) VR 이 그 VRN 의 접속을 4300 포트(@ 앞에 적은 포트)에서 받아, VRN 이 모니터에서 읽은 파형과 수치를 그 장비의 트랙으로 녹화하고 웹 모니터링으로 보낸다. 지금까지는 VRN 서버(vrnserver)가 따로 있어야 했다. 장비 종류와 옵션(Intellivue 의 wavs 등)은 VR 설정에서 VRN 으로 내려가고, VRN 의 시계도 VR PC 의 시계에 맞춘다. 설정에 MAC 이 없는 VRN 은 받지 않는다. Changed: MAC 만 적은 port 는 이제 VRN 을 뜻한다. 예전처럼 VitalConnect 연결로 쓰이지 않는다. Changed: 진단 로그를 영어로 통일했다. Intellivue 파형 요청·응답, Nihon Kohden 에러 응답, 시계 보정, SERVER_CONTROL 등의 로그가 한글이어서 해외 사용처에서 읽을 수 없었다. Fixed: 같은 TCP 포트에 종류가 다른 장비 둘을 두면(예: [email protected] 은 Intellivue, [email protected] 는 Primus) 두 번째 장비가 열리지 않던 문제. Fixed: 리눅스에서 VR 을 다시 시작한 직후 TCP 서버 포트를 최대 60초 동안 열지 못해 그동안 장비가 붙지 않던 문제.
moremore
more
more
1.19.382026-11-15
1.19.38 Fixed: Windows 에서 웹 모니터링 전송이 몇 초마다 끊기던 문제. 1.18.44 부터 Windows 판 VR 은 mod.vitaldb.net 처럼 https(wss) 로 접속하는 서버에 보낼 때, 서버에서 받을 것이 없어 읽기가 시간 초과되면 암호화 연결이 망가져 다음 전송이 실패하고(로그의 websocket send error) 5초 뒤 다시 접속하기를 되풀이했다. 그래서 웹 모니터에 데이터가 띄엄띄엄 오거나 거의 오지 않았다. 이제 한 번 맺은 연결로 계속 보낸다. 전송이 실패하면 그 이유를 로그의 같은 줄에 남긴다. 리눅스 판(PiVR 포함)과 1.18.43 이전 Windows 판은 이 문제가 없었다.
more1.19.372026-11-15
1.19.37 Added: VRN(Vitalnode)을 VR 에서 바로 받는다. 장비 설정의 port 에 VRN 의 MAC 을 적으면 (10bda3c85168, 10:bd:a3:c8:51:68, 10-BD-A3-C8-51-68, 또는 4300@10bda3c85168) VR 이 그 VRN 의 접속을 4300 포트(@ 앞에 적은 포트)에서 받아, VRN 이 모니터에서 읽은 파형과 수치를 그 장비의 트랙으로 녹화하고 웹 모니터링으로 보낸다. 지금까지는 VRN 서버(vrnserver)가 따로 있어야 했다. 장비 종류와 옵션(Intellivue 의 wavs 등)은 VR 설정에서 VRN 으로 내려가고, VRN 의 시계도 VR PC 의 시계에 맞춘다. 설정에 MAC 이 없는 VRN 은 받지 않는다. Changed: MAC 만 적은 port 는 이제 VRN 을 뜻한다. 예전처럼 VitalConnect 연결로 쓰이지 않는다. Changed: 진단 로그를 영어로 통일했다. Intellivue 파형 요청·응답, Nihon Kohden 에러 응답, 시계 보정, SERVER_CONTROL 등의 로그가 한글이어서 해외 사용처에서 읽을 수 없었다. Fixed: 같은 TCP 포트에 종류가 다른 장비 둘을 두면(예: [email protected] 은 Intellivue, [email protected] 는 Primus) 두 번째 장비가 열리지 않던 문제. Fixed: 리눅스에서 VR 을 다시 시작한 직후 TCP 서버 포트를 최대 60초 동안 열지 못해 그동안 장비가 붙지 않던 문제.
moreIf you use the VitalRecorder in your research, please cite the following publication:
Lee HC, Jung CW. VitalRecorder-a free research tool for automatic recording of high-resolution time-synchronised physiological data from multiple anaesthesia devices. Sci Rep. 2018 Jan 24;8(1):1527.
doi: 10.1038/s41598-018-20062-4.
Available from: https://www.nature.com/articles/s41598-018-20062-4