This document describes the available command-line arguments for the TRAFOLO application. These parameters control runtime behavior, debugging, display settings, and execution modes.
Command-Line Arguments
-d, –debug
Type: Flag (boolean)
Default: False
Enables debug mode.
When set, the application produces more verbose logs and diagnostic output. This is useful for troubleshooting and development.
–clear_updates
Type: Flag (boolean)
Default: False
Clears any pending or cached updates.
Use this option if you need to reset the application’s update state, especially when resolving update-related issues.
-wt, –width
Type: Integer
Default: None
Forces a fixed width for the application window.
- Disables horizontal resizing of the window.
- If the value is too small, some UI elements may not be visible or may be clipped.
-ht, –height
Type: Integer
Default: None
Forces a fixed height for the application window.
- Disables vertical resizing of the window.
- If the value is too small, some UI elements may not be visible or may be clipped.
–serverless
Type: Flag (boolean)
Default: False
Runs the application without starting the built-in server.
⚠️ Warning:
When this flag is enabled, the backend/server component must be started separately. This mode is intended for advanced deployments where services are managed independently.
Command-Line Usage Examples
Run in debug mode with fixed window size:
trafolo.exe --debug --width 1280 --height 800
Run in serverless mode:
trafolo.exe --serverless
Creating a Windows Shortcut with Arguments
You can pass arguments via a Windows shortcut:
- Right-click desktop -> New -> Shortcut
- Enter target:
"%LOCALAPPDATA%\Programs\Trafolo\trafolo.exe" --debug --width 1280 --height 800
- Complete the wizard
Environment Variables
Environment variables allow low-level control over application behavior.
Runtime Directories
These variables control where temporary runtime data is stored (e.g., extracted files, working data).
TRAFOLO_RUNTIME_DIR
Overrides the runtime directory for the main application.
- Redirects temporary runtime data to a custom location
- Useful for placing data on a different drive
TRAFOLOBACKEND_RUNTIME_DIR
Overrides the runtime directory for the backend/service component.
- Same behavior as
TRAFOLO_RUNTIME_DIR, but applies to the backend service
Default Runtime Location
If not specified, both components use:
%TEMP%/TrafoloRuntime
Notes
- These directories are used for temporary extracted data and runtime files
- Customizing them can:
- Improve performance
- Avoid system drive space limitations
- Provide better control in restricted or containerized environments