Installation

Installation

Requirements

• Windows 10 or later (64-bit)
• Python 3.9+ — download from python.org
• PyCATIA — install via pip install pycatia
• CATIA V5 — must be running for scripts that interact with it

Install Steps

1. Go to the latest release
2. Download CatiaMenuWin32.exe
3. Place it anywhere you like — no installer required
4. Double-click to run

First Launch

On first launch the app will:

• Create %APPDATA%\CatiaMenuWin32\ to store settings and cached scripts
• Auto-detect your Python installation
• Sync scripts from the built-in KaiUR/Pycatia_Scripts repository
• Display scripts as clickable buttons organised by tab

Installing Dependencies

Click the ↓ Deps button in the toolbar to upgrade pip and all required Python packages automatically. This runs pip install --upgrade pip then pip install --upgrade -r requirements.txt for each configured source.

Using a Virtual Environment (optional)

A Python virtual environment keeps the script dependencies isolated from your global Python installation. This is useful if you use Python for other projects and want to avoid package conflicts.

Create the environment:

python -m venv C:\path\to\your\venv

A convenient location is a venv folder alongside the scripts cache, for example:

%APPDATA%\CatiaMenuWin32\venv

Install the script dependencies into it:

C:\path\to\your\venv\Scripts\activate
pip install -r setup\requirements.txt

Or use the path to the Pycatia_Scripts requirements.txt directly:

C:\path\to\your\venv\Scripts\pip install pycatia wxPython xlsxwriter

Point CatiaMenuWin32 at the environment:

1. Open ☰ Menu → File → Settings... → General tab
2. Click Browse... next to Python Interpreter
3. Navigate to python.exe inside the venv's Scripts folder: C:\path\to\your\venv\Scripts\python.exe
4. Click OK

The app calls Python directly by full path, so the venv does not need to be activated in a terminal first.

Tip: After changing the Python path, click ↓ Deps to install all required packages into the new environment.

---

Default Behaviour

By default the app:

• Starts with Windows automatically — launches at login via registry autorun (disable in Settings → Window → Start with Windows)
• Minimizes to the system tray — closing or minimizing the window hides it to the tray; double-click the tray icon to restore (disable in Settings → Window → Minimize to Tray)
• Starts minimized to the system tray on launch (disable Start Minimized in Settings → Window to open the window immediately on startup)

These can all be changed in Settings.

Uninstalling

1. Close the app
2. Delete CatiaMenuWin32.exe
3. Optionally delete %APPDATA%\CatiaMenuWin32\ to remove all cached scripts and settings