Skip to content

Application Settings

The Settings window in VirtualProg allows you to configure global application preferences, including virtual machine storage, shared folders, appearance, and system behaviors.

📸 Screenshot: Settings Storage

🗂 Storage Path

Choose where VirtualProg stores all your virtual machines:

  • Choose Folder: Select a custom folder as your VM storage location.
  • Drag & Drop Folder: Alternatively, drag a folder into this area to set it.
  • The Selected Item field below confirms the active storage path.

All VMs, snapshots, templates, and restore images are saved here.

📁 VirtIO Shared Folder Mount

Define the mount name that will be used inside Linux guests when VirtIO folder sharing is enabled.

  • This name (e.g., macOS) is required when mounting the shared folder with VirtioFS.
  • Example command in Linux guest: 
    sudo mount -t virtiofs macOS /mnt/mac

🔍 Spotlight Indexing

When enabled, VirtualProg will automatically index all your virtual machine names in macOS Spotlight.
This allows you to quickly search and launch virtual machines directly from Spotlight by typing their names.

When disabled, all previously indexed virtual machines will be removed from Spotlight to keep your system index clean.

📸 Screenshot: Settings General

🎨 Appearance

Choose your preferred user interface theme:

  • System: Follows the system appearance (Light or Dark).
  • Light: Forces a light mode appearance.
  • Dark: Forces a dark mode appearance.

🚀 Launch at Login

  • Automatically launch VirtualProg when the user logs into macOS.

🧭 Minimize on Control Center Close

When enabled, clicking the close button in the Control Center window title bar will minimize the window instead of quitting VirtualProg. This helps keep VirtualProg running in the background while keeping your workspace tidy.

🖼️ Screenshot Background

Use a VM screenshot as the background image.

📸 Screenshot: Settings Interfaace

  • Notifications: Display system notifications for virtual machine events.
  • Menu Bar Icon: Display the VirtualProg icon in the macOS menu bar.
  • Favorites: Mark VMs, templates, or snapshots as favorites for quick access.
  • Tag Colors: Show or hide color-coded tags for VMs, snapshots, and templates.
  • Groups: Organize VMs into groups for easier management.

📸 Screenshot: Settings CLI

💻 CLI Port

The CLI port is used to communicate with VirtualProg from the command line vpvm.

  • Enable CLI port: Allows remote control and automation of VirtualProg operations via vpvm commands.
  • Port: Specify the port number to use for the CLI.
  • Restart : Restart the CLI service after changing the port.
  • Download the vpvm cli from https://makeprog.com/Products/VirtualProg/vpvm.zip**
  • More Info About Command Line
  • External Access: Enable remote control of VirtualProg via vpvm commands/web dashboard from other machines on the network.
  • Token: A unique authentication token required for remote CLI access. You can copy the current token or generate a new one if needed.
  • There is also a Web Dashboard avaialble and you can access it from browser from local or network by typing http://macip:port/dashboard

📸 Screenshot: Settings Advanced

🎥 Modern ScreenCapture

VirtualProg now supports a more reliable and efficient screen recording method using macOS ScreenCaptureKit (macOS 13+). This option ensures better compatibility and performance when recording VirtualProg's interface.

✅ Enabling Modern ScreenCapture

To activate this feature:

  1. Enable the Modern ScreenCapture checkbox in the settings.
  2. A macOS system prompt will appear requesting permission for VirtualProg to record your screen and audio.
  3. Grant screen recording access to VirtualProg by navigating to:

System Settings → Privacy & Security → Screen Recording

  1. After giving access, return to VirtualProg, re-enable the checkbox, and click the Test button.

📸 Screenshot: Screen Recording Permission

🧪 Testing Screen Access

When you click the Test button:

  • macOS will display a System Private Window Picker prompt requesting permission for VirtualProg to bypass the system's standard picker and directly access your screen.

  • Allowing this is essential for Modern ScreenCapture to function.

📸 Screenshot: Private Window Picker

ℹ️ Important Notes

  • Only VirtualProg windows are recorded. No other apps or parts of the screen are captured.
  • If the test is successful, a confirmation message will appear.
  • If the test fails:
  • Disable the checkbox.
  • Re-enable it.
  • Repeat the process.

This screen recording method is designed to integrate securely with macOS privacy standards while offering seamless capture support for VirtualProg.

📜 Logs

Enable logging of VM activity. Logs can be accessed from the Help menu.

📏 Max Log Size (MB)

Defines the maximum size of the log and dashboard log files. When this limit is reached, the log file is cleared and recreated.

⏰Scheduler

Enable or disable the scheduler. By default it is enabled.

📸 Screenshot: Settings Network

🌐 Network Settings

The Network tab is where you manage how your virtual machines connect to the world. You can create multiple isolated or shared interfaces here.

➕ Creating a New Interface

To add a new network, click the Plus (+) icon at the bottom of the sidebar. This will generate a new entry where you can define your network settings.

⚙️ Configuration Options

Setting Description
Enable Toggle the checkbox to turn the network interface ON or OFF.
Name Give your network a recognizable name (e.g., Shared or Development).
Type Defines how traffic is routed (Shared, or Host-only).
Interface Select which physical adapter (Wi-Fi, Ethernet) the VM should use.
Subnet The IP address range for your virtual network. Click the 🔄 icon to randomize.
MTU Set the packet size. Higher values (like 2000) can improve speed on supported hardware.
IPv6 Enable this to support modern 128-bit IP addressing.
Prefox The IPv6 prefix address. Click the 🔄 icon to randomize.

🗑️ Deleting an Interface

If you no longer need a specific network configuration: 1. Select the interface from the left-hand sidebar (e.g., "Shared"). 2. Click the Trash icon at the bottom. 3. Note: This action is immediate. Ensure you have saved any important IP configurations before deleting.

💾 Saving Changes

The Save button in the top right will highlight when changes are detected. Always click Save before switching to another tab or closing the window to ensure your network updates are applied.

[!IMPORTANT] Changing network settings is not possible while the network is in use by running Virtual Machine.

💡 Changes here affect how VirtualProg behaves and presents across all virtual machines.

💬 Leave a Review

You can share your feedback or rate VirtualProg on the Mac App Store by clicking Leave a Review.
Your feedback helps improve future versions of VirtualProg and supports ongoing development.
If you enjoy using the app, consider leaving a positive review — it makes a big difference!