FilterBox installation on Mac with USB Webcam Integration

This guide outlines instructions for Mac users to set up FilterBox on a VirtualBox virtual machine running Ubuntu, tailored explicitly for those utilizing USB cameras.


  1. Mac Computer: With a 64-bit Intel or Apple processor.

  2. VirtualBox: The latest version installed.

  3. Ubuntu ISO: Downloaded from the official site.

  4. USB Webcam: Mac-compatible.

  5. Administrative Privileges: For installation and configuration.

Recommended Mac Resources for Optimal Performance:

  • Memory: While VirtualBox can run with 512 MB, allocating 2-4 GB is recommended, and 8 GB ensures a smoother experience.

Installing VirtualBox on Your Mac

VirtualBox is ideal for installing FilterBox on your Mac, with its high performance on Intel CPUs, support for multiple VMs, and efficient disk I/O. Seamless integration allows FilterBox apps to run smoothly alongside the host OS.

  1. Download VirtualBox from the Official VirtualBox Downloads page.

  2. Open the downloaded file and follow the on-screen instructions to install VirtualBox on your Mac.

If you encounter a "The installation failed" error, it may be because security settings are preventing Oracle America from loading. Go to System Preferences > Security & Privacy > General tab, and click Allow next to the message about Oracle America.

Installing Ubuntu in VirtualBox

For Mac users running FilterBox, Ubuntu within VirtualBox is a strong choice, offering a Linux environment that closely mirrors native performance.

  1. Download the Ubuntu ISO File from the Official Ubuntu Downloads page.

  2. Open VirtualBox and click on New to create a new virtual machine.

  3. Provide a name for your virtual machine and choose the location for the installation.

  4. Assign the amount of RAM you wish to allocate to your virtual machine.

  5. Create a Virtual Hard Disk, selecting VDI (VirtualBox Disk Image) as the type and dynamically allocated storage.

  6. Set the disk size and choose the destination folder for the installation.

  7. Start the virtual machine. If the installation disk (Ubuntu ISO) is not automatically detected, navigate to its location and select the file.

  8. Follow the on-screen instructions to install Ubuntu. Select Install Ubuntu and proceed with the recommended 'Normal Installation' when prompted.

  9. Choose your keyboard layout and time zone, and create a user account with a password.

  10. Wait for the installation to complete, and reboot your virtual machine once prompted.

Configuring Ubuntu for Full-Screen Mode in VirtualBox

Expanding Ubuntu to full screen in VirtualBox in Windows may not resize as expected. This quick guide will help you resolve this to enjoy a seamless full-screen experience.

  1. After Ubuntu installation, to enable full-screen mode, click on Devices in the VirtualBox menu, then select Insert Guest Additions CD Image.

  2. Open the disk from the Ubuntu taskbar, right-click inside the folder, and select Open in Terminal.

  3. Update your packages and system by running:

sudo apt update 
sudo apt upgrade
  1. Execute the Guest Additions installation script:

  1. Confirm any prompts, enter your password when requested, and agree to any terms.

  2. Once the installation is complete, restart Ubuntu within VirtualBox.

  3. Ubuntu should now be able to run in full-screen mode.

Configuring USB Webcam in VirtualBox

  1. With the Ubuntu virtual machine selected, go to Settings in VirtualBox.

  2. Navigate to the Ports tab, then to the USB section.

  3. Enable the USB Controller and select the USB version corresponding to your webcam.

  4. Click on the "Add new USB device" icon (green plus) and select your USB webcam from the list of available devices.

  5. Click OK to save your settings.

Installing FilterBox

  1. With Ubuntu running, open a terminal.

  2. Execute the commands specified in Getting Started.

  3. Confirm that the application recognizes the USB webcam by accessing the device through the Ubuntu virtual machine.

By following these steps, you should be able to successfully install and run FilterBox on a Mac within a VirtualBox virtual machine, with full-screen functionality and USB webcam access.

Last updated