Python-OBD
A Python module for reading real-time sensor data from OBD-II vehicle ports using ELM327 adapters.
What is Python-OBD?
python-OBD is a Python module for interfacing with OBD-II vehicle diagnostic ports to read real-time engine and sensor data. It connects to ELM327-based adapters and provides a simple API for querying parameters like speed, RPM, temperature, and fuel levels. The library handles unit conversions and protocol differences, making it accessible for automotive telematics and monitoring applications.
Developers, hobbyists, and researchers working on automotive telematics, vehicle monitoring systems, or Raspberry Pi-based projects that require access to real-time vehicle data.
It offers a pure-Python, well-documented solution with extensive OBD command support and unit-aware measurements, eliminating the need to deal with low-level serial protocols. Its compatibility with affordable ELM327 adapters and Raspberry Pi makes it a cost-effective choice for DIY and professional applications.
Overview
OBD-II serial module for reading engine data
Use Cases
Best For
- Building custom vehicle telematics and monitoring dashboards
- Raspberry Pi projects that log or display real-time car data
- DIY automotive diagnostics tools for enthusiasts and mechanics
- Research and data collection on vehicle performance and emissions
- Educational projects teaching OBD-II protocols and Python serial communication
- Integrating vehicle sensor data into IoT or home automation systems
Not Ideal For
- Real-time safety-critical control systems requiring low-latency and deterministic responses
- Commercial fleets needing turnkey, vendor-supported telematics platforms with guaranteed uptime
- Projects targeting vehicles with proprietary OBD implementations or non-standard CAN bus protocols
Pros & Cons
Pros
Works with widely available USB, Bluetooth, or RF adapters, making it cost-effective and accessible for hobbyists and professionals alike.
Returns sensor values with proper units using the Pint library, allowing easy conversions like mph to kph directly in code.
Supports dozens of standardized OBD commands for engine parameters, fuel levels, VIN, and more, as documented in the command tables.
Tailored for embedded platforms like Raspberry Pi, ideal for portable or fixed installations in DIY automotive projects.
Cons
README admits issues with Bluetooth adapters, especially on Raspberry Pi, requiring manual tweaks like setting fast=False and timeout=30 for stability.
Support for OBD commands varies by vehicle, meaning not all listed sensors may be accessible on every car, limiting predictability.
Primarily designed for reading data; lacks built-in features for writing to the ECU or controlling vehicle systems beyond diagnostics.
Frequently Asked Questions
Related Projects
ScapyScapy: the Python-based interactive packet manipulation program & library.
canmatrixConverting Can (Controller Area Network) Database Formats .arxml .dbc .dbf .kcd ...
Caring CaribouA friendly car security exploration tool for the CAN bus
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.