mirror of
https://github.com/fr3ts0n/AndrOBD.git
synced 2026-06-02 18:44:39 -04:00
bfbbffde94
- AndroidManifest.xml: add maxSdkVersion=30 to location permissions (not needed on API 31+ with BLUETOOTH_SCAN neverForLocation), add FOREGROUND_SERVICE_CONNECTED_DEVICE permission (required API 34+), add foregroundServiceType=connectedDevice to ObdBackgroundService - MainActivity: replace 4 individual requestPermissions() calls (only last dialog was shown) with a single batched call keyed on SDK version (BLUETOOTH_SCAN+CONNECT on API 31+, ACCESS_FINE_LOCATION on API 23-30); add POST_NOTIFICATIONS runtime request on API 33+; add onRequestPermissionsResult() to retry BT init after grant - BtDeviceListActivity: batch BLUETOOTH_SCAN+BLUETOOTH_CONNECT into one requestPermissions() call - BleDeviceListActivity: same batching fix; guard startScan() behind permission check with early return - ChartActivity: add WRITE_EXTERNAL_STORAGE runtime request before screenshot on API 23-28; add onRequestPermissionsResult() to take screenshot after permission is granted Agent-Logs-Url: https://github.com/fr3ts0n/AndrOBD/sessions/6000e1a5-7568-4451-9a6a-42692a940107 Co-authored-by: fr3ts0n <2822578+fr3ts0n@users.noreply.github.com>
AndrOBD allows your Android device to connect to your car's on-board diagnostics system via any ELM327 compatible OBD adapter, display various information & perform operations. It is open source and completely free. The application also has a built in Demo mode that simulates live data, so you don't require an adapter to test it.
Documentation
Install
Features
Connection types
- Bluetooth
- USB
- Wi-Fi
Functionality
- Read fault codes
- Clear fault codes
- Read/record live data
- Read freeze frame data
- Read vehicle info data
Expand features list
Additional features
- Day/Night view
- Data charts
- Dashboard
- Head up display
- Save recorded data
- Load recorded data (for analysis)
- CSV export
Customisation of PID data
- PID data items
- Data conversions
Plugin extension support
- Development: AndrOBD-Plugin repository
- Available Plugins:
- MQTT publisher - Publish OBD data to MQTT broker
- GpsProvider - Provide GPS data to AndrOBD
- SensorProvider - Provide Accelerometer data to AndrOBD
Native language support
- translatable via weblate.org
Screenshots
| Functions | OBD data | Dashboard |
|---|---|---|
 |
 |
 |
More screenshots available on the Website or in the Screenshots folder
Contribute
- Report issues in the issue tracker
- Create a Pull Request
- Test the app with different devices, alpha & beta releases are posted in the Telegram AndrOBD release channel
- Contribute to development of plugin extensions: AndrOBD-Plugin repository
- Discuss the project in the Telegram or Matrix chat rooms
- Translate this app into more languages on Weblate, or have a look at Language translation section in the Wiki for more info.
Expand translation status
App dialogs:
OBD data descriptions:
Fault codes:
Plugin framework:
⚠️ Design request ⚠️
- AndrOBD is looking for help with designing and implementing of a new modern GUI (#104, #126), Java & Kotlin can be used. Contributers will be credited/linked in the Readme.
Support by donating
Buy us a coffee or donate in the amount that you see valuable for the project, as it will enable us to put more free time into the active development.
| Thank you for donating | ||
|---|---|---|
 |
PayPal | https://www.paypal.me/fr3ts0n |
|
Liberapay | https://liberapay.com/AndrOBD/donate |
 |
Bitcoin | 19UApzsc5eDJ5VNDNYCA1bpszPnkcpWeFP |
Credits
Donators
| Date | Supporter | Donation |
|---|---|---|
| 2018/02 | John Zimmerer | $10 |
| 2018/12 | Martin Bourdoiseau | €20 |
| 2019/06 | Jeffrey O'Connell | $10 |
| 2019/08 | Christoph Schmid | €10 |
| 2020/01 | Glenn Fowler | $5 |
| 2020/02 | Klemen Skerbiš | €5 |
| 2020/06 | Jairus Martin | $10 |
| 2020/06 | rusefi llc | €25 |
| 2020/07 | Klemen Skerbiš | €5 |
| 2020/10 | Frank White | $8 |
| 2021/03 | Raphael Högger | CHF60 |
| 2021/04 | Klemen Skerbiš | €5 |
| 2021/06 | Christoph Goetz | €5 |
| 2021/11 | Raphael Högger | CHF60 |
| 2022/05 | Cecil Harper | €6 |
| 2022/07 | Daniel Singh | $10 |
| 2022/09 | Andrew Hofmans | €5 |
| 2022/11 | Glenn Fowler | $5 |
| 2023/01 | Remy Piper | €10 |
| 2023/03 | Hausmeister0815 | $60 |
| 2023/07 | Christian Böttcher | €10 |
| 2023/11 | @user8446 | $10 |
| 2024/01 | Hausmeister0815 | €50 |
| 2024/04 | @BaderSZ | $5 |
| 2024/05 | Raphael Högger | CHF52 |
| 2024/11 | @user8446 | $10 |
| 2025/05 | Klemen Skerbiš | $20 |
| 2025/12 | @user8446 | $10 |
| 2026/01 | Raphael Kröpfli-Högger | CHF30 |
Contributors
Graphic design
- Very special Thanks to anaufalm for the beautiful graphic design artwork and logos.
Start page
- Thank you very much sampoder for a beautiful AndrOBD start page.
Internet promotion
- Big hands to aha999 for a fancier Readme, community help and many ideas to improve AndrOBD.
Hosting translations
- Special thanks to Michal Čihař for hosting translations on weblate.org.
Thanks to the open source community and any supporters who pick this project up, AndrOBD will be able to get more development, new features, and hopefully even more than that.