akvirtualcamera-wiki/Build-and-install.md

Dependencies

• CMake

Mac

• Xcode Command Line Tools (xcode-select --install from a terminal)

Windows

• MSYS2
• Visual Studio Build Tools

Build

For building akvirtualcamera, open a terminal and run the following commands:

Note: Replace /path/to with the actual path of the sources directory.

Mac

cmake -S /path/to/akvirtualcamera -B /path/to/akvirtualcamera-build-directory
make -C /path/to/akvirtualcamera-build-directory

MSYS2

cmake -G "MSYS Makefiles" -S /path/to/akvirtualcamera -B /path/to/akvirtualcamera-build-directory
make -C /path/to/akvirtualcamera-build-directory

Visual Studio

cmake -G "Visual Studio 16 2019" -S /path/to/akvirtualcamera -B /path/to/akvirtualcamera-build-directory
cmake --build /path/to/akvirtualcamera-build-directory

For other generators check CMake documentation.
You can also compile akvirtualcamera using cmake-gui.
The generated plugin files are located at /path/to/akvirtualcamera-build-directory/build.

Note: For Windows, you must build both 32 and 64 bits versions, and put x86 and x64 folders together in the same folder.

Install

akvirtualcamera service needs to be installed and running for the virtual camera to properly work.

Note: Replace /path/to with the actual path of the plugin.

Mac

Run the following commands as root

# Is highly recommendable Linking the plugin instead of copying it.

ln -s /path/to/AkVirtualCamera.plugin /Library/CoreMediaIO/Plug-Ins/DAL/AkVirtualCamera.plugin

# Create the configuration file for the assistant.

cat << EOF > /Library/LaunchDaemons/org.webcamoid.cmio.AkVCam.Assistant.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>Label</key>
        <string>org.webcamoid.cmio.AkVCam.Assistant</string>
        <key>ProgramArguments</key>
        <array>
            <string>/path/to/AkVirtualCamera.plugin/Contents/Resources/AkVCamAssistant</string>
            <string>--timeout</string>
            <string>300.0</string>
        </array>
        <key>MachServices</key>
        <dict>
            <key>org.webcamoid.cmio.AkVCam.Assistant</key>
            <true/>
        </dict>
        <key>StandardOutPath</key>
        <string>/tmp/AkVCamAssistant.log</string>
        <key>StandardErrorPath</key>
        <string>/tmp/AkVCamAssistant.log</string>
    </dict>
</plist>
EOF

# If the service was disabled re-enable it.

launchctl enable system/ org.webcamoid.cmio.AkVCam.Assistant

# Configure and launch the service.

launchctl bootstrap system /Library/LaunchDaemons/org.webcamoid.cmio.AkVCam.Assistant.plist

Windows

Open an administrator CMD and run the following commands:

rem If you are running in 64 bits Windows run:

/path/to/x64/AkVCamAssistant.exe --install

rem If you are running in 32 bits Windows run:

/path/to/x86/AkVCamAssistant.exe --install

rem Start the service

sc start AkVCamAssistant