Installation

Installation

win_can_tool can be used three different ways depending on your setup and workflow.

---

✅ Option 1: Windows EXE (Recommended)

This is the easiest way to run the tool with no Python required.

1. Go to: https://github.com/kfafard/win_can_tool/releases

2. Download the latest file: win_can_tool-vX.Y.Z.exe

3. Double-click the EXE to run.

✅ No dependencies
✅ Best for most users
✅ Matches official releases

---

✅ Option 2: Install from PyPI (Python Users)

If you are running from Python:

pip install win-can-tool

Run it with:

win-can-tool

or:

python -m win_can_tool

✅ Good for developers ✅ Supports CLI + GUI ✅ Easier to script and extend

---

✅ Option 3: Run From Source (Development Mode)

Use this if you plan to modify the code:

git clone https://github.com/kfafard/win_can_tool.git
cd win_can_tool
pip install -r requirements.txt
python can_gui_launcher.py

✅ Full source access ✅ Ideal for debugging and feature work

---

🔌 Supported CAN Interfaces

win_can_tool supports the following CAN backends:

• Intrepid (ics / neoVI)
• Kvaser
• PCAN
• SocketCAN
• Virtual (no hardware required)

---

⚠️ Important Notes

• Some USB CAN devices require:

  • Admin/root permissions
  • Vendor drivers installed first

• Always plug in hardware before launching the app.

• If the app fails to start:

  • Verify drivers
  • Verify Python version (3.12 recommended for source builds)
  • Try the virtual interface for testing

---