sapgui-shortcut-fixer-macos 0.1.0

Automatically fix SAP GUI shortcut files (.sap) on macOS by removing malformed /M/ parameters from GuiParm connection strings

SAP GUI Shortcut Fixer for macOS

⚠️ DISCLAIMER: This entire application was AI-generated ("vibecoded") using GitHub Copilot.
While fully functional and tested, please review the code before use in production environments.

Automatically fix SAP GUI shortcut files (.sap) downloaded from SAP NetWeaver Portal on macOS by removing malformed /M/ parameters from GuiParm connection strings.

The Problem

SAP NetWeaver Portal sometimes generates .sap shortcut files with an extra /M/ prefix in the connection string:

GuiParm=/M//H/server.com/S/3200  ❌ Malformed

This prevents SAP GUI from connecting properly. This tool automatically fixes it to:

GuiParm=/H/server.com/S/3200  ✅ Fixed

Installation

pip install sapgui-shortcut-fixer-macos
sap-modifier install

Usage

sap-modifier status         # Check service status
sap-modifier test file.sap  # Test on specific file
sap-modifier logs           # View recent activity
sap-modifier uninstall      # Remove service

How It Works

Uses macOS launchd with WatchPaths to monitor Downloads folder. When a .sap shortcut file appears, it automatically fixes malformed GuiParm parameters.

Technology:

• Event-driven monitoring (no daemon process)
• Native macOS integration (launchd)
• Zero dependencies (pure Python 3.10+)

What are .sap Files?

.sap files are SAP GUI shortcut files - plain-text INI files generated by SAP NetWeaver Portal that contain connection parameters for SAP GUI for Windows. They're temporary launch shortcuts, not configuration exports or transport files.

Related SAP Files (NOT handled by this tool):

• .car/.sar - SAP kernel patches (use SAPCAR)
• .sda - Java deployment archives (use SDM)
• .epa - Portal content exports

Development

pip install -e ".[dev]"
pytest

License

MIT