# BEANalyzer UltraPro v2.1 Cross-Platform Package

This package includes macOS, Windows, Linux and portable source builds.

## Included folders

```text
macOS/
Windows/
Linux/
Portable_Source/
```

## macOS

Use:

```text
macOS/Install_BEANalyzer_UltraPro_to_Applications.command
```

This installs:

```text
/Applications/BEANalyzer UltraPro.app
```

## Windows

Use:

```text
Windows/Run_BEANalyzer_UltraPro.bat
```

or install shortcuts with:

```text
Windows/Install_BEANalyzer_UltraPro_Windows.bat
```

Requires Python 3.12. During Python installation, enable:

```text
Add python.exe to PATH
```

## Linux

Use:

```bash
cd Linux
chmod +x run_beanalyzer_ultrapro.sh
./run_beanalyzer_ultrapro.sh
```

or install a desktop launcher:

```bash
chmod +x install_beanalyzer_ultrapro_linux.sh
./install_beanalyzer_ultrapro_linux.sh
```

Requires Python 3.12 / venv support.

## Portable source

The full Python project is in:

```text
Portable_Source/BEANalyzer_UltraPro/
```

Run manually:

```bash
python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python beanalyzer_ultrapro.py
```

On Windows:

```powershell
py -3.12 -m venv .venv
.\.venv\Scripts\activate
python -m pip install -r requirements.txt
python beanalyzer_ultrapro.py
```

## v2.2 Maintenance Update

This package includes fixed CSV replay, updated application icons, and preserved macOS/Linux executable permissions in the ZIP archive.


## Help Menu

The application includes a top-level `Help` menu:

```text
Help -> Check for Updates...
Help -> About
```

`Check for Updates...` opens the AE&D website in the default system browser.
`About` opens a professional software information dialog with the BEANalyzer UltraPro icon, AE&D manufacturer logo, website link, version information, and © 2026 AE&D copyright notice.


## v2.5 Startup / About Menu Fix

- Hardened the About menu role handling for different PySide6 builds.
- Removed a risky macOS launcher override that could cause the app to open and close immediately on some systems.
- Added runtime/crash logging under `~/Library/Application Support/BEANalyzer UltraPro/logs/` on macOS.
- Help -> About BEANalyzer UltraPro remains available, and Check for Updates opens https://aend-tech.com.


## BEANalyzer UltraPro v2.6 - CAN Gateway Monitor

This version adds a dedicated CAN Gateway Monitor window. It can be opened from:

```text
View -> Open CAN Gateway Monitor
Devices / CAN Gateway -> Open CAN Gateway Monitor
```

The CAN Gateway Monitor shows CAN RX/TX traffic in real time, including frames received from python-can hardware such as CANalyst-II, CANable/SLCAN, SocketCAN, PCAN, Kvaser, Vector, or virtual backends, plus frames sent through the Arduino CAN serial bridge.

The window includes:

```text
- Live RX/TX table
- Backend/source column
- CAN ID, extended flag, DLC and data bytes
- Raw CAN notation ID#DATA
- Per-ID counter
- Per-ID delta time
- CSV export
- JSON export
- Manual CAN transmit console
- Repetition count
- Delay between transmissions
- Continuous loop mode when Count = 0
```

The manual CAN transmit console can send through either:

```text
python-can
Arduino CAN serial bridge
```

For CANalyst-II, remember that it normally does not use a COM/tty serial port. Use the python-can backend with interface `canalystii`, device/channel configuration, and the selected bitrate.
