// Documentation
Documentation
Program icons
To use alternative icons in the program, simply create a "PENetwork.icl" file (icon library) and put it in the same folder.
A sample .icl file is included in the AutoIt3 source code (see Downloads).
This sample file contains the icons currently used in PENM.
Alternatively, you can use a specific icon library in a specific color scheme; see the section below.
Command-line options for PENetwork.exe
Here is a short summary of the available command-line options.
The parameters "/profileeditor" and "/wifiexporter" can be used directly under Windows.
Simply extract "PENetwork.exe" from the download archive (see Downloads) into a folder and create a shortcut with one of these two parameters.
This lets you run the "PENM profile editor" or the "PENM WiFi exporter" directly.
| Parameter | Description |
|---|---|
| /autostart | Starts the PENM network installation automatically without prompting. |
| /debug | Logs PENM usage/activity to %TEMP%\PENMDebug.txt. |
| /focusno | Sets the input focus to the 'No' button in the PENM network startup dialog. |
| /forceservices | Installs network components/services even if no network card is found. |
| /guidisable=mask | Hides the specified tabs. The mask can be any combination of the following values: 1 - Computer, 2 - Sharing, 4 - Drives, 8 - Profiles, 16 - Other, 32 - WiFi, 64 - Advanced 128 - WiFi preferred, 256 - WiFi service, 512 - Size button Example: 16 + 32 -> hide 'Other' (16) and 'WiFi' (32) -> 48 Note: The "Config"/"IP-Settings" and "About" tabs are always shown. If the "WiFi" tab is enabled, the "Available networks" tab is always shown. |
| /ini=ini file | Loads the specified ini file instead of 'PENetwork.ini'. |
| /noprofileselect | Disables the profile selection GUI that is shown by default on the first PENM startup. |
| /profile=name | Loads the specified profile directly from the ini file (see '/ini='). |
| /profileeditor | Starts the PENM configuration/profile editor directly. |
| /shareall | Automatically shares all local drives if sharing has been installed and started (can be used with /startsharing). |
| /smalltab | Starts PENM with small tabs on the left. |
| /startsharing | Automatically installs and starts sharing after the network installation. |
| /topmost | Makes the PENM network installation window the topmost window on the desktop. |
| /useprofiles | Reads profiles from the ini file. |
| /wifiexporter | Directly starts a small WiFi export GUI that exports local WiFi profiles to XML files. |
Registry options
Some options can be created before PENM runs under PE; others are changed or set automatically at runtime.
The first key is "HKEY_CURRENT_USER\Software\PENetwork".
Some PENM and PENM profile editor preferences are saved here.
The second key is "HKEY_LOCAL_MACHINE\Software\PENetwork".
By default, the values are registry strings and are set to "1" (on/set) or "0" (off/not set).
In one of the next versions, the first (user) key will become the primary key for all options.
However, the second key will still be read for backward compatibility.
Important: registry values always take precedence; ini values (see below) are only secondary.
| Main key | Used | Value | Description |
|---|---|---|---|
| HKLM | First startup only | AutoStart | Starts the PENM network installation automatically without prompting. |
| HKLM | First startup only | CloseAfterStartnet | The PENM GUI is NOT shown after the network installation. |
| HKLM | Always | CloseToTray | Closing the PENM window sends it to the system tray. |
| HKCU (HKLM) | Always | Debug | Logs PENM usage/activity to %TEMP%\PENMDebug.txt. |
| HKLM | First startup only | EnableAutoIP | Enables the use of APIPA; this mode is off by default. |
| HKLM | First startup only | FocusNo | Sets the input focus to the 'No' button in the PENM network startup dialog. |
| HKLM | First startup only | ForceScanOnStartup | Forces network card detection on the first startup, even if the network is already installed. |
| HKLM | Always | GUIDisable | Hides the specified tabs (see /guidisable for details). |
| HKCU | Always | MinimizeToTray | Minimizing the PENM window sends it to the system tray. |
| HKLM | First startup only | ShareAll | Automatically shares all local drives if sharing has been installed and started (can be used with /startsharing). |
| HKCU | Always | ShowTrayActivity | Shows the network activity icon in the system tray. |
| HKCU | Always | SmallTab | Starts PENM with small tabs on the left. |
| HKLM | First startup only | StartCountdown | Countdown time in seconds for the startup GUI. |
| HKCU | Always | StartMode | Optionally sets the startup mode of the PENM info window: 0 - Don't show, 1 - Center (default), 2 - Top left, 3 - Top right, 4 - Bottom left, 5 - Bottom right, 6 - Depends on system tray position |
| HKCU | Always | StartToTray | Always starts PENM in the system tray (useful together with "MinimizeToTray" and/or "CloseToTray"). |
| HKLM | First startup only | TopMost | Makes the PENM network installation window the topmost window on the desktop. |
| HKLM | First startup only | UseProfiles | Reads profiles from the ini file. |
| HKLM | First startup only | UseProfileSelect | Shows the profile selection GUI on the first PENM startup (profiles must exist in the ini file). |
| HKLM | First startup only | UseStartCountdown | Uses a countdown on the first startup, only if AutoStart is '0' or not set. |
INI options (for files such as PENetwork.ini)
The main options must be written to the main section [PENetwork] of the .ini file.
The following options/values are only used on the first startup of PENM.
Other settings, such as color schemes, are always read from the ini file.
By default, a value must be set to "Yes" or "No"; other formats are given in the description.
| Value | Description |
|---|---|
| AutoStart | Starts the PENM network installation automatically without prompting. |
| EnableAutoIP | Enables the use of APIPA; this mode is off by default. |
| FocusNo | Sets the input focus to the 'No' button in the PENM network startup dialog. |
| ForceScanOnStartup | Forces network card detection on the first startup, even if the network is already installed. |
| GUIDisable | Hides the specified tabs (see /guidisable for details). |
| MinimizeToTray | Minimizing the PENM window sends it to the system tray. |
| ProfileDefault | The default network profile to apply. |
| ProfileCountdown | Countdown time in seconds for the profile selection GUI. |
| ShareAll | Automatically shares all local drives if sharing has been installed and started (can be used with /startsharing). |
| ShowMain | Shows the PENM main GUI after the network installation ("Yes") or not ("No"). Defaults to "Yes" if not set. |
| ShowTrayActivity | Shows the network activity icon in the system tray. |
| StartCountdown | Countdown time in seconds for the startup GUI. |
| StartMode | Optionally sets the startup mode of the PENM info window: 0 - Don't show, 1 - Center (default), 2 - Top left, 3 - Top right, 4 - Bottom left, 5 - Bottom right, 6 - Depends on system tray position |
| StartSharing | Automatically installs and starts sharing after the network installation. |
| UseIniIcons | Loads other icons from the ini file (see the sample ini file in the zipped download archive). |
| UseOsFont | Uses the OS font for the GUI; if set to 'No', you can select another font, e.g. 'GlobalFont=Comic Sans MS'. |
| UseProfileCountdown | Uses a countdown for profile selection on the first startup. |
| UseProfiles | Reads profiles from the ini file. |
| UseProfileSelect | Shows the profile selection GUI. |
| UseStartCountdown | Uses a countdown on the first startup, only if 'AutoStart' is 'No' or not set. |
| TrayLimitHeight (new) | Limits the height of the tray info window, by default to half the desktop height; otherwise the window is only limited by the desktop height (default "No"). |
| TrayInfoHeight (new) | Sets a specific height for the tray info window; only used if TrayLimitHeight is set to "Yes". |
| TrayAdaptWiFi (new) | Adapts the height of the tray WiFi window to that of the tray info window (default "No"). |
| TrayWiFiHeight (new) | Sets a specific height for the tray WiFi window; only used if TrayAdaptWiFi is set to "No" or not set. |
| TrayShowMAC (new) | Shows the MAC addresses of network adapters in the tray info window (default "No"). |
| TrayShowIPv6 (new) | Shows the IPv6 addresses of network adapters in the tray info window (default "No"). |
Color scheme section
| IconLib | Uses a specific icon library in a specific color scheme. |