User Guide
┌──────────────────────────────────────────────────────────────────┐
│ CATIA Macro Menu - [ ] x │
├──────────────────────────────────────────────────────────────────┤
│ [Menu] [Refresh] [Settings] [Deps] [Stop] v2.1.0.128 │
├──────────────────────────────────────────────────────────────────┤
│ Filter scripts... │
├──────────────────────────────────────────────────────────────────┤
│ < * Favourites | Any Document Scripts | Part Doc Scripts > │
├──────────────────────────────────────────────────────────────────┤
│ > Rename Hybrid Shapes [i] │
│ Renames multiple hybrid shapes in one go. │
│ > Batch Isolate Geometric Set [i] │
│ Isolate every element in a geometric set as a datum. │
│ > Check Duplicate Names In Geometric Set [i] │
│ Scan a geometric set for elements that share a name. │
│ │
├──────────────────────────────────────────────────────────────────┤
│ Sync complete. +5/-0 folders, +71/-0 scripts, 0 updated. │
└──────────────────────────────────────────────────────────────────┘
| Button | Action |
|---|---|
| ☰ Menu | Access all app functions |
| ↻ Refresh | Re-sync scripts from all sources |
| ⚙ Settings | Open the settings dialog |
| ↓ Deps | Install/update Python dependencies |
| ■ Stop | Stop the currently running background script (disabled when idle) |
The top-right of the toolbar shows the current version and an update notification if a newer version is available.
The filter bar below the toolbar filters scripts in the current tab in real time. Type any text to filter by name or purpose. Clear it to show all scripts. Filtering is case-insensitive — searching iges matches IGES Export Curve AXIS.
Each tab corresponds to a script folder from the repository. Click a tab to switch categories. When more tabs exist than fit the window, ◄ ► arrows appear. Use the mouse wheel over the tab bar to scroll.
Tabs with no visible scripts are hidden automatically. If every script in a tab is hidden, the tab disappears from the bar and the app switches to the next available tab. The tab reappears as soon as any script in it is unhidden.
- Left-click the button to run the script
-
Hover the
ibadge on the right to see the script tooltip (Purpose, Author, Version, Date, Description) - Right-click for the full context menu
Shows sync progress, script launch status, and exit codes at the bottom of the window.
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_Scriptsrepository - Display scripts as clickable buttons organised by tab
If sync fails with "Connect to internet to sync", check your internet connection. On a corporate network, see GitHub Token.
Click any script button to run it. The app will:
- Verify the script SHA hash against GitHub to confirm it has not been tampered with
- Launch Python with the script path
- Show the status in the status bar
Configurable in Settings:
- Show console — opens a visible Python console when the script runs
- Keep console open — window stays open after the script finishes so you can read output and errors
- Without Show console, scripts run silently in the background
Click the ■ Stop button in the toolbar to terminate a script that is currently running in the background. The button is enabled only while a script is running and returns to the disabled (greyed) state once the script exits or is stopped. Use this if a script hangs or runs longer than expected.
Note: Only background (no-console) runs can be stopped this way. If Show console is enabled, close the console window directly or press
Ctrl+Cinside it.
Favourites give you quick access to the scripts you use most often.
To add a favourite:
- Right-click any script button → Add to Favourites
- Or open Script Details... → tick the Favourite checkbox → click OK
A dedicated ⭐ Favourites tab appears at the far left of the tab bar as soon as you have at least one favourite. It disappears automatically when all favourites are removed.
To remove a favourite:
- Right-click the script → Remove from Favourites
- Or open Script Details... → untick the Favourite checkbox → click OK
Favourites are also the source for the Quick Launch Bar — every favourited script automatically appears as a button on the floating bar.
Favourites are stored in %APPDATA%\CatiaMenuWin32\prefs.ini and persist across restarts and syncs.
A filter bar sits below the toolbar. Type any text to instantly filter the scripts in the current tab by name or purpose. Clear the box to show all scripts again. Filtering is case-insensitive.
Right-click any script → Script Details... to open a full details dialog.
The dialog shows:
- Script name, purpose, author, version, date
- Code environment and CATIA release
- Full description and requirements
- Local cache path
- Your personal note
- Favourite and Hidden toggles
Changes to the note, favourite, and hidden state are saved when you click OK.
Hiding a script removes it from view without deleting it from the cache.
To hide a script:
- Right-click any script → Hide Script
- Or open Script Details... → tick the Hidden checkbox → click OK
Hidden scripts remain in the cache and will not reappear after a sync. If every script in a tab is hidden, the tab itself disappears from the tab bar automatically.
To unhide scripts:
- Go to ☰ Menu → File → Manage Hidden Scripts
- Select one or more scripts from the list
- Click Unhide to restore selected scripts, or Unhide All to restore everything
The tab reappears automatically as soon as any script in it is unhidden.
Right-click any script → Add Note... (or Edit Note...) to attach a personal note. Notes are visible in the Script Details dialog and stored in %APPDATA%\CatiaMenuWin32\prefs.ini.
Right-click any script → Run with Arguments... to pass custom command line arguments when running the script.
☰ Menu → View → Sort Scripts offers four sort modes:
| Mode | Description |
|---|---|
| Default Order | Order from GitHub API or disk |
| Alphabetical | A–Z by script name |
| By Date | Most recent scripts first (from script header Date field) |
| Most Used | Scripts you run most often appear first |
The sort mode is saved in Settings and applied to all tabs.
Open via ☰ Menu → File → Settings... or the ⚙ toolbar button. See the Settings page for full details.
The Settings dialog has five tabs: General, Sync, Console, Window, and Quick Bar.
Open via ☰ Menu → File → Sources.... See the Script Sources page for full details.
The app can load scripts from three types of sources simultaneously: the built-in KaiUR/Pycatia_Scripts repository, additional GitHub repositories, and local folders on your machine.
Click ↓ Deps (or ☰ Menu → Run → Update Dependencies) to install Python packages required by the scripts.
The app runs pip install --upgrade pip && pip install --upgrade -r requirements.txt for each configured source that has a setup/requirements.txt file. Each source runs in its own console window sequentially.
Enable Keep Update Deps console open in Settings → Console to keep each window visible until you close it manually.
The Quick Launch Bar is a small floating button bar giving one-click access to your favourite scripts without switching to the main window.
Go to ☰ Menu → View → Quick Bar → Enable Quick Bar, or right-click the bar and tick Enable Quick Bar.
Each button represents one script from your ⭐ Favourites tab. The face shows the first two uppercase letters of the script name. Hover to see the full name and Purpose in a tooltip. Click to run.
When favourites exceed the visible area, ▲ ▼ (vertical) or ◄ ► (horizontal) scroll arrows appear. The mouse wheel also scrolls.
Drag any empty area of the bar to reposition it. Position is saved to settings.ini automatically.
Switch between vertical and horizontal layouts via ☰ Menu → View → Quick Bar or the right-click menu.
The bar tracks the state of a configured target application:
| State | Behaviour |
|---|---|
| Target app has a visible window | Bar shown normally |
| All target windows minimised | Bar hides; reappears on restore |
| Target app not running | Bar hides; reappears when the app opens |
| No target configured | Bar always visible when enabled |
When On Top with Target App is enabled, the bar rises to always-on-top while the target app is in the foreground.
The default target is CATIA V5. To change it:
- Right-click the bar → Set Target App…
- Enter any substring that appears in the target window title (e.g.
SolidWorks,Fusion 360) - Optionally enter the Target Exe — the process executable filename (e.g.
CNEXT.exe) — to prevent the bar from responding to other windows whose titles share the same substring. Click Browse… to select the executable with a file picker instead of typing the name manually - Click OK
Clear both fields and click OK to disable target tracking — the bar will remain always visible with no topmost behaviour.
| Option | Description |
|---|---|
| Enable Quick Bar | Toggle the bar on or off |
| Horizontal / Vertical | Switch orientation |
| On Top with Target App | Toggle topmost-with-target (greyed when no target set) |
| Set Target App… | Set the window-title substring and optional process executable to track |
| Reset Position | Move bar back to default position |
When Minimize to Tray is enabled, closing the window hides the app to the system tray. Double-click the tray icon to restore it. Right-click the tray icon for a menu with Restore, Refresh, and Exit options.
Enable Start with Windows to launch the app automatically at login. Combine with Start Minimized to have it start silently in the tray.
Switch between dark, light, and system-default themes via ☰ Menu → View → Theme:
- System (default) — follows your Windows theme setting automatically
- Dark — always dark regardless of Windows setting
- Light — always light regardless of Windows setting
Without a token, GitHub allows 60 requests per hour per IP address. A token raises this to 5,000 req/hr and is required for private repositories.
To add a token: open ☰ Menu → File → Settings... → General tab → tick Use token and paste it in. See Settings for full details.
Office / shared network users: All users behind the same public IP share the 60/hr limit. Each user should set their own token.
Press F1 or go to ☰ Menu → Help → Help Contents to open the built-in help window. The window has a table of contents on the left and formatted topic content on the right. It is resizable and stays open while you work.
| Shortcut | Action |
|---|---|
F1 |
Open Help |
F5 |
Refresh + Sync |
F9 |
Run last script |
Ctrl+Tab |
Next tab |
Ctrl+Shift+Tab |
Previous tab |
See the Writing Scripts wiki page for the full guide on creating compatible scripts, including the required header format, folder structure, naming conventions, and persistent data pattern.