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
1 maintainer
Metadata
1 maintainer
Release files for sapgui-shortcut-fixer-macos 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| sapgui_shortcut_fixer_macos-0.1.0.tar.gz | 10.6 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| sapgui_shortcut_fixer_macos-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 20.0 kB
Release files / sapgui_shortcut_fixer_macos-0.1.0.tar.gz
| Download URL | sapgui_shortcut_fixer_macos-0.1.0.tar.gz |
|---|---|
| Size | 10.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
00e2103679834a3df9ab927d2ee7fd7a660ad9f2aa4cacfaf994f49e93dd30ab
|
|
BLAKE2b-256 checksum How to use checksums |
5f5c2999c0f6fdf4180ac1aa278c43d62ffc63f780f9d7d8ea93f18ceae1ad4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2025.
Transparency logRelease files / sapgui_shortcut_fixer_macos-0.1.0-py3-none-any.whl
| Download URL | sapgui_shortcut_fixer_macos-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df8a61cba7cee7db98ee36ad39e67dcb841864ad4ef87a936b279b3e57149188
|
|
BLAKE2b-256 checksum How to use checksums |
a3ea372de808006ff6585a31c88bfcb94c25e0b09f40be0e5135fa09ec821bae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2025.
Transparency logSecurity for sapgui-shortcut-fixer-macos 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for sapgui_shortcut_fixer_macos-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 8, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
