Update README.md

Author: AhmedYasserrr

README.md

@@ -1,31 +1,36 @@
 # Pyectool
 
-**Pyectool** is a Python package with C++ bindings for interacting with the Embedded Controller (EC) on ChromeOS and Framework devices. It is extracted from and based on [`ectool`](https://gitlab.howett.net/DHowett/ectool) utility, and exposes EC control functions directly to Python programs via a native extension.
+**Pyectool** provides Python bindings for interacting with the Embedded Controller (EC) on ChromeOS and Framework devices.  
+It is extracted from and based on [Dustin Howett's `ectool`](https://gitlab.howett.net/DHowett/ectool) and exposes EC control functions directly to Python via a native C++ extension built with `pybind11`.
 
-## Features
+Pyectool also provides a simple way to build the original `ectool` CLI tool, or to build `libectool`—a standalone C library that wrap most of ectool’s functionality, making it reusable in C/C++ projects or accessible from other languages. Both the CLI binary and the library are built automatically during installation.
 
-- Python bindings for EC functionality using `pybind11`.
+## Features
+- Python-native interface to low-level EC functionality via `pybind11`
 - Supports fan duty control, temperature reading, AC power status, and more.
-- Designed for integration with hardware management or fan control tools.
-- Shared core logic with `libectool` for C/C++ integration.
+- Designed for hardware monitoring, thermal management, and fan control tooling.
+- Bundles the native `ectool` CLI and `libectool` C library alongside the Python package:
+  * `pyectool/bin/ectool`  (ectool CLI)
+  * `pyectool/lib/libectool.a` (libectool static library)
+  * `pyectool/include/libectool.h` (libectool C header)
 
 ---
 
-## Build & Install (Python Package)
-
-We use [`scikit-build-core`](https://scikit-build-core.readthedocs.io/en/latest/) to build the C++ extension via CMake.
+## Installation
 
 ### Prerequisites
 
-Install the required system dependencies:
+Install system dependencies:
 
 ```sh
 sudo apt update
 sudo apt install -y libusb-1.0-0-dev libftdi1-dev pkg-config
 ````
 ### Clone the repository
 
-## Install system-wide
+### Install the package
+
+#### Option 1: System-wide (not recommended unless you know what you're doing)
 ```sh
 sudo pip install .
 ```
@@ -36,49 +41,45 @@ sudo env "PIP_BREAK_SYSTEM_PACKAGES=1" pip install .
 ```
 (Required on modern distros like Ubuntu 24.04 due to PEP 668.)
 
-### Test from outside the repo dir
-After installing, **do not run Python from the `libectool/` directory**, since it contains a `pyectool/` folder that may shadow the installed package.
-
-Instead, test from another location, e.g.:
-
-```sh
-cd ..
-sudo python -c "from pyectool import ECController; ec = ECController(); print(ec.is_on_ac())"
-```
-
-## VENV INSTALLATION
-
-If you **don’t** want to touch system Python:
-
-### Create venv
-
+#### Option 2: Isolated virtual environment (recommended)
 ```bash
 python3 -m venv ~/.venv/pyectool
 source ~/.venv/pyectool/bin/activate
+pip install .
 ```
 
-### Install your package
+### ⚠️ Important Note
+
+After installation, **do not run Python from inside the `libectool/` directory**. It contains a `pyectool/` folder that may shadow the installed package.
+
+Instead, test from a different directory:
 
-Inside the venv:
 ```bash
-pip install .
+cd ..
+python -c "from pyectool import ECController; ec = ECController(); print(ec.is_on_ac())"
 ```
-### Test from outside the repo dir
+
+If you're using a virtual environment and want to preserve its `PATH`, use:
 ```bash
 cd ..
 sudo env "PATH=$PATH" python -c "from pyectool import ECController; ec = ECController(); print(ec.is_on_ac())"
 ```
+This ensures the correct Python from your virtual environment is used even with `sudo`.
+
+---
 
-### Available Functions
+## Usage
 
-All functions are methods of the `ECController` class. Instantiate it like so:
+### Create an EC controller instance
 
 ```python
 from pyectool import ECController
+
 ec = ECController()
 ```
 
-Then use the methods as shown below:
+### Available Methods
+
 
 | Method                                                  | Description                                                               |
 | ------------------------------------------------------- | ------------------------------------------------------------------------- |
@@ -110,3 +111,10 @@ Returned by `get_temp_info()`, acts like a `dict` with:
 * `temp`: int
 * `temp_fan_off`: int
 * `temp_fan_max`: int
+
+---
+
+## License
+
+BSD 3-Clause License
+See the `LICENSE` file for full terms.