Install Vineforce Teams Lite | macOS
- Purpose: Install the silent-mode background tracker application on macOS.
- Navigation: Log in to the web portal, go to the Downloads menu, and select Vineforce Teams Lite for macOS.
- Installation: Open the downloaded
.shscript in a text editor, copy the code, paste it into a Terminal window, and run it withsudocredentials. - Impact: The tracker starts automatically in the background and uploads logs to the Vineforce Teams web portal.
macOS
What is Vineforce Teams Lite for macOS?
Vineforce Teams Lite is a background activity tracking application designed for silent deployment. It runs without interrupting the user's workspace workflow and automatically records activity metrics in the background.
This guide walks you through the installation process using our automated shell script for macOS.
What are the macOS Prerequisites?
Ensure the target Mac meets the following requirements before starting:
| Requirement | Details |
|---|---|
| Operating System | macOS 11 (Big Sur) or later |
| Privileges | Admin privileges required to run the installation script |
| Permissions | Screen Recording and Accessibility access must be granted after install |
| Internet Access | Active connection required to download the installation packages |
| Disk Space | Minimum of 200 MB of available storage |
How to Download and Install Vineforce Teams Lite on macOS
Step 1: Sign In to the Web Portal
Log in to your organization's Vineforce Teams web portal. The URL is specific to your tenancy:
https://<your-tenancy-name>.vineforceteams.com/account/login
Example: If your tenancy name is vf-test, the login URL would be https://vf-test.vineforceteams.com/account/login.
Step 2: Download the Shell Script
- Navigate to the Downloads section from the left-hand navigation menu.
- Locate the Vineforce Teams section.
- Click Download VineforceLite for macOS.
This action downloads a shell script file (.sh) to your local computer.
Step 3: Copy the Installation Script
- Open your local Downloads folder.
- Double-click the downloaded
.shfile to open it in your default text editor (such as TextEdit or VS Code). - Select all the text in the file and copy the entire script code.
Step 4: Run the Script in the Terminal
- Open a new Terminal window on your Mac.
- Paste the copied script code into the Terminal.
- Press Enter to run the script.
- If prompted, type your system password (admin password) and press Enter (note: the characters will not show in the console for security).
The script will begin downloading required dependencies, configuring the environment, and setting up the tracker service.
If this is the first time the tracker has requested system access, macOS will prompt you to grant Screen Recording and Accessibility permissions. Approve both to allow the application to capture active window titles and screenshots correctly.
How to Verify the Background Service is Running on macOS
To confirm the tracker is active:
- Open Activity Monitor.
- Search the processes list for "Lite".
- Verify that the
Vineforce Teams Liteprocess is active.
If activity logging or screenshot capturing does not work after installation, check System Settings → Privacy & Security and confirm Vineforce Teams Lite is enabled under both Screen Recording and Accessibility. You may need to log out of your Mac and log back in for the changes to take effect.
How to Troubleshoot macOS Installation Errors
| Problem | Potential Cause | Recommended Solution |
|---|---|---|
| Permission Denied | Script execution blocked | Run chmod +x filename.sh in the Terminal to grant execute permissions. |
| Tracking Not Working | Screen Recording or Accessibility not granted | Go to System Settings → Privacy & Security and enable both permissions for Vineforce Teams Lite. |
| "App is damaged" or blocked | Gatekeeper blocking an unsigned/unnotarized script or binary | Go to System Settings → Privacy & Security and click Open Anyway next to the relevant message. |
Frequently Asked Questions (FAQ)
Does the macOS tracker support automated startup?
Yes. The shell script installs a LaunchAgent to ensure that the background tracker service starts automatically upon user login.
What should I do if my logs show up in Unassigned Logs?
This occurs when the Mac has not been mapped to an employee profile in the portal. Navigate to Tracker → Unassigned Logs in the web app to associate the machine hostname with the correct user.
Which macOS versions are supported?
The script supports macOS 11 (Big Sur) and later. Contact support for assistance with older versions.
Related Functionality
- Reconcile Unassigned Logs: Learn how to map time tracking logs synced from this machine to employee profiles.
- Tracker Settings: Adjust intervals, idle thresholds, and screenshot quality.
- Uninstall Vineforce Teams Lite (macOS): Learn how to remove the silent macOS tracker.