<h1 align="center">
<a href="https://github.com/tbruno25/can-explorer">
<!-- Please provide path to your logo here -->
<img src="https://github.com/Tbruno25/can-explorer/raw/main/docs/images/logo.png" alt="Logo" width="200" height="200">
</a>
</h1>
<div align="center">
can-explorer
<br />
<a href="https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=bug&template=01_BUG_REPORT.md&title=bug%3A+">Report a Bug</a>
·
<a href="https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=enhancement&template=02_FEATURE_REQUEST.md&title=feature%3A+">Request a Feature</a>
·
<a href="https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=question&template=04_SUPPORT_QUESTION.md&title=support%3A+">Ask a Question</a>
</div>
<div align="center">
<br/>
[![PyPI version](https://img.shields.io/pypi/v/can-explorer?color=mediumseagreen)](https://pypi.org/project/can-explorer/)
[![Python Versions](https://img.shields.io/pypi/pyversions/can-explorer?color=mediumseagreen)](https://pypi.org/project/can-explorer/)
[![Stars](https://img.shields.io/github/stars/tbruno25/can-explorer?color=mediumseagreen)](https://github.com/Tbruno25/can-explorer/stargazers)
</div>
---
## About
`can-explorer` is a CAN bus visualization tool designed to aid in reverse engineering.
![Demo](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/demo.gif)
### How does this help me?
By continuously plotting all payloads for each CAN id, spotting trends that correspond to a specific action can become signicantly easier to identify.
Please refer to this [prior article](https://tbruno25.medium.com/car-hacking-faster-reverse-engineering-using-canopy-be1955843d57) I wrote for a working example of how this approach can be used to find which id includes speedometer data.
### Built With
[![DearPyGui](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/dearpygui-logo.png)](https://github.com/hoffstadt/DearPyGui)
[![PythonCan](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/pythoncan-logo.png)](https://github.com/hardbyte/python-can)
## Getting Started
### Installation
[pipx](https://pypa.github.io/pipx/) is recommended although any package manager that supports `pyproject.toml` files can be used.
```sh
pipx install can-explorer
```
## Usage
The gui can be launched by running one of the below commands from a terminal.
```sh
can-explorer
```
```sh
python3 -m can_explorer
```
Before starting the viewer, you ***must*** navigate to the settings tab and input your interface adapter configuration to create a bus instance. Please refer to the [python-can docs](https://python-can.readthedocs.io/en/stable/index.html) for more information regarding the various interfaces supported.
The gui can also be launched with a demo flag which will auto select the virtual interface option and start streaming simulated CAN data in a background process.
```sh
can-explorer --demo
```
## Support
Reach out to the maintainer at one of the following places:
- [GitHub issues](https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=question&template=04_SUPPORT_QUESTION.md&title=support%3A+)
- Contact options listed on [this GitHub profile](https://github.com/tbruno25)
If you want to say **thank you** or/and support active development of can-explorer consider adding a [GitHub Star](https://github.com/tbruno25/can-explorer) to the project.
## Contributing
Please read [our contribution guidelines](docs/CONTRIBUTING.md)
For a full list of all authors and contributors, see [the contributors page](https://github.com/tbruno25/can-explorer/contributors).
## License
This project is licensed under the **GNU General Public License v3**.
See [LICENSE](LICENSE) for more information.
Raw data
{
"_id": null,
"home_page": "https://github.com/Tbruno25/can-explorer",
"name": "can-explorer",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "can,bus,canbus,can_bus,dbc",
"author": "TJ",
"author_email": "tbruno25@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c7/75/bf861ef148cf92ea8cbedddefc4d33a9ff9cecb2d73f470c74d83023c9fa/can_explorer-0.1.7.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">\n <a href=\"https://github.com/tbruno25/can-explorer\">\n <!-- Please provide path to your logo here -->\n <img src=\"https://github.com/Tbruno25/can-explorer/raw/main/docs/images/logo.png\" alt=\"Logo\" width=\"200\" height=\"200\">\n </a>\n</h1>\n\n<div align=\"center\">\n can-explorer\n <br />\n <a href=\"https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=bug&template=01_BUG_REPORT.md&title=bug%3A+\">Report a Bug</a>\n \u00b7\n <a href=\"https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=enhancement&template=02_FEATURE_REQUEST.md&title=feature%3A+\">Request a Feature</a>\n \u00b7\n <a href=\"https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=question&template=04_SUPPORT_QUESTION.md&title=support%3A+\">Ask a Question</a>\n</div>\n\n<div align=\"center\">\n<br/>\n\n\n[![PyPI version](https://img.shields.io/pypi/v/can-explorer?color=mediumseagreen)](https://pypi.org/project/can-explorer/)\n[![Python Versions](https://img.shields.io/pypi/pyversions/can-explorer?color=mediumseagreen)](https://pypi.org/project/can-explorer/)\n[![Stars](https://img.shields.io/github/stars/tbruno25/can-explorer?color=mediumseagreen)](https://github.com/Tbruno25/can-explorer/stargazers)\n</div>\n\n---\n\n## About\n\n`can-explorer` is a CAN bus visualization tool designed to aid in reverse engineering.\n\n![Demo](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/demo.gif)\n\n### How does this help me?\nBy continuously plotting all payloads for each CAN id, spotting trends that correspond to a specific action can become signicantly easier to identify. \n\nPlease refer to this [prior article](https://tbruno25.medium.com/car-hacking-faster-reverse-engineering-using-canopy-be1955843d57) I wrote for a working example of how this approach can be used to find which id includes speedometer data.\n\n\n### Built With\n\n\n[![DearPyGui](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/dearpygui-logo.png)](https://github.com/hoffstadt/DearPyGui)\n[![PythonCan](https://github.com/Tbruno25/can-explorer/raw/main/docs/images/pythoncan-logo.png)](https://github.com/hardbyte/python-can)\n\n## Getting Started\n\n### Installation\n\n[pipx](https://pypa.github.io/pipx/) is recommended although any package manager that supports `pyproject.toml` files can be used.\n\n```sh\npipx install can-explorer\n``` \n\n## Usage\n\nThe gui can be launched by running one of the below commands from a terminal.\n```sh \ncan-explorer\n``` \n\n```sh \npython3 -m can_explorer\n``` \n\nBefore starting the viewer, you ***must*** navigate to the settings tab and input your interface adapter configuration to create a bus instance. Please refer to the [python-can docs](https://python-can.readthedocs.io/en/stable/index.html) for more information regarding the various interfaces supported. \n\nThe gui can also be launched with a demo flag which will auto select the virtual interface option and start streaming simulated CAN data in a background process.\n\n```sh \ncan-explorer --demo\n``` \n\n## Support\n\nReach out to the maintainer at one of the following places:\n- [GitHub issues](https://github.com/tbruno25/can-explorer/issues/new?assignees=&labels=question&template=04_SUPPORT_QUESTION.md&title=support%3A+)\n- Contact options listed on [this GitHub profile](https://github.com/tbruno25)\n\nIf you want to say **thank you** or/and support active development of can-explorer consider adding a [GitHub Star](https://github.com/tbruno25/can-explorer) to the project.\n\n\n## Contributing\n\nPlease read [our contribution guidelines](docs/CONTRIBUTING.md)\n\nFor a full list of all authors and contributors, see [the contributors page](https://github.com/tbruno25/can-explorer/contributors).\n\n## License\n\nThis project is licensed under the **GNU General Public License v3**.\n\nSee [LICENSE](LICENSE) for more information.\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "Visualize CAN bus payloads in real time",
"version": "0.1.7",
"project_urls": {
"Homepage": "https://github.com/Tbruno25/can-explorer",
"Repository": "https://github.com/Tbruno25/can-explorer"
},
"split_keywords": [
"can",
"bus",
"canbus",
"can_bus",
"dbc"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "46242ded7e835d30a9760020371d41fc3db1c4a0700e0918333139d767cfaed9",
"md5": "d61905cd28b38248846bcf8d08db66dc",
"sha256": "b5bd9cb9832c7b719d7ca72fb70e92ab9c7a98c10167c77cae35250a76fb9c27"
},
"downloads": -1,
"filename": "can_explorer-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d61905cd28b38248846bcf8d08db66dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 19944667,
"upload_time": "2023-08-03T22:25:52",
"upload_time_iso_8601": "2023-08-03T22:25:52.123495Z",
"url": "https://files.pythonhosted.org/packages/46/24/2ded7e835d30a9760020371d41fc3db1c4a0700e0918333139d767cfaed9/can_explorer-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c775bf861ef148cf92ea8cbedddefc4d33a9ff9cecb2d73f470c74d83023c9fa",
"md5": "54a6202f64876d473c81416736c7a76a",
"sha256": "d10cfc983dc61a422d50c9588d76f49e84595187214bb593cf5a9bdb509042c8"
},
"downloads": -1,
"filename": "can_explorer-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "54a6202f64876d473c81416736c7a76a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 19935125,
"upload_time": "2023-08-03T22:25:55",
"upload_time_iso_8601": "2023-08-03T22:25:55.492370Z",
"url": "https://files.pythonhosted.org/packages/c7/75/bf861ef148cf92ea8cbedddefc4d33a9ff9cecb2d73f470c74d83023c9fa/can_explorer-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-03 22:25:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Tbruno25",
"github_project": "can-explorer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "can-explorer"
}