https://github.com/openw3rk-develop/o3diag

o3DIAG - A Open Source OBD-II Diagnostic Tool for Windows and Linux
https://github.com/openw3rk-develop/o3diag

debian diagnostic-tool elm327 gui linux o3diag o3script o3script-language obd2 obd2-reader openw3rk openw3rk-invent python

Last synced: 10 days ago
JSON representation

o3DIAG - A Open Source OBD-II Diagnostic Tool for Windows and Linux

• Host: GitHub
• URL: https://github.com/openw3rk-develop/o3diag
• Owner: openw3rk-DEVELOP
• License: mit
• Created: 2025-08-31T18:58:05.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-11-19T10:18:29.000Z (7 months ago)
• Last Synced: 2025-11-19T11:18:24.175Z (7 months ago)
• Topics: debian, diagnostic-tool, elm327, gui, linux, o3diag, o3script, o3script-language, obd2, obd2-reader, openw3rk, openw3rk-invent, python
• Language: Python
• Homepage: https://o3diag.openw3rk.de
• Size: 3.96 MB
• Stars: 3
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
o3DIAG – OBD-II Diagnostic Tool

! Version 3.2.1 for Debian is also available in the "linux-only" branch !




o3DIAG is a diagnostic application designed to work with OBD-II vehicles through an ELM327 adapter.  

It provides an easy way to connect, read vehicle data, and interpret diagnostic trouble codes (DTCs).





Web:


https://o3diag.openw3rk.de / https://openw3rk.de


o3DIAG Development Tool:


https://github.com/openw3rk-DEVELOP/o3DIAG_E-EE


For Feedback:


develop@openw3rk.de


Main Features




Connection Control



– Select communication port and baud rate.


– Connect or disconnect the adapter with a single click.


– Initialize the adapter automatically with the required AT commands.





Live Data Reading



– Read common engine parameters such as:


  • Engine RPM (PID 010C)


  • Vehicle Speed (PID 010D)


  • Coolant Temperature (PID 0105)


  • Engine Load (PID 0104)


– Raw responses are automatically converted into real-world values (e.g., RPM in revolutions per minute,
 temperature in °C, speed in km/h).





Diagnostic Trouble Codes (DTCs)



– Read stored error codes from the engine control unit.


– Clear fault codes when required.


– Codes are translated into plain-text descriptions for easier understanding.





P-Code Translation



– The program can look up diagnostic codes (P0000–P0999 and beyond) from an integrated o3script-based list.


– Instead of showing just the raw code, the program displays the human-readable meaning of each fault.





User Interface



– Scrollable log window that shows all communication with the adapter.


– Each entry is timestamped for clarity (at Beta 1.5).


– Clear log function, with an automatic program banner shown again for orientation.


– Info/Warning section with program details and disclaimers.



Summary




With o3DIAG, users can quickly access essential vehicle information, monitor live sensor data, and interpret engine fault codes in a clear and user-friendly interface.  

It is a practical tool for basic diagnostics and understanding of OBD-II data.



Compile




Compiling o3DIAG is simple, using the following command (for Beta 2.5 or earlier):

pyinstaller --onefile --windowed --icon=o3DIAG_ico.ico --add-data "o3DIAG_logo.png;." --add-data "THE_PCODES_LIST.o3script;." o3DIAG_VERSION.py

Appropriate parameters such as "o3DIAG version" and the ".o3script" file for the P-codes list must be adjusted.



   

  Copyright (c) openw3rk INVENT