Skip to main content

Overview

Note

Self-Hosted Deployment Note: If your organization has deployed Penfield in a self-hosted model (where the Penfield application is hosted on your corporate infrastructure), the Windows Interaction Sensor will communicate directly with your self-hosted Penfield backend, not with Penfield's hosted backend. The communication endpoint is determined by where your Penfield application is deployed.

The Windows Interaction Sensor application captures and processes user interactions, including data collection and task management. This guide will walk you through the steps to set up, configure, and run the application.

System Requirements​

  • OS: Windows 10 or higher
  • Python Version: 3.12.x
  • Conda: For managing Python environments
  • Git (optional): For cloning the repository
  • Windows Steps Recorder (PSR.exe): Required for capturing interactions

Setup Instructions​

Step 1: Install Miniconda​

  1. If you don’t have Miniconda installed, download and install it from:
    Miniconda: https://www.anaconda.com/docs/getting-started/miniconda/install#quickstart-install-instructions

  2. Open Anaconda Prompt and run this command to add Conda to your PATH:

    conda init cmd.exe

Step 2: Download the code from the Gitlab repository​

  1. Download the script from the Gitlab repository, Contact Penfield for the code.

Step 3: Create a Conda Environment​

  1. Navigate to the Application Root:
    Before setting up the project, make sure you're in the directory where the environment.yml is located (the project root). Use the cd command to navigate there:

    cd path/to/windows-interaction-sensor

    Replace path/to/windows-interaction-sensor with the actual path to your project folder.

  2. Open the Anaconda PowerShell Prompt: Open the Prompt by going to start menu and search for Anaconda PowerShell Prompt and run next steps in that prompt.

  3. Create the Conda Environment:
    Create the Conda environment using the environment.yml file:

    conda env create -f environment.yml

    It will ask you to accept the Terms of Service, So please accept it.

Step 4: Activate and Verify Setup​

  1. Activate the Conda Environment:
    After creating the Conda environment, activate it to ensure all the installed dependencies are available:

    conda activate win_sensor

  2. Verify Installation:
    Once the environment is activated, you can verify that everything is installed properly by listing the installed packages:

    conda list

    This will display all installed dependencies within the win_sensor environment.

Running the Windows sensor Application​

Once the setup is complete, you can run the application using the following steps:

Step 1: Activate the Conda Environment​

 conda activate win_sensor

Step 2: Navigate to the Application Directory​

You need to navigate to the app directory where the main application script is located. If you're in the root project directory, run the following command:

cd path/to/windows-interaction-sensor/app

Replace path/to/windows-interaction-sensor with the actual path to your project folder.

Step 3: Modify the config​

  • Config file location is: /app/configs/default.yaml
  • Update the config file: Search for base_directory settings, and replace %user% with the username.

Step 4: Run the Application​

Once inside the app directory, run the following command to start the application:

python main.py

This will start the application and begin monitoring user interactions.

Step 5: Stopping the Application​

To stop the application, press Ctrl + C in the terminal window where the application is running or Esc anywhere.
This will stop any ongoing tasks and end the user session.

Running the Privacy service application​

Once the setup is complete, you can run the application using the following steps:

Step 1: Activate the Conda Environment (Optional)​

You only need to activate if it is not activated already in the Anaconda PowerShell Prompt

 conda activate win_sensor

Step 2: Create pathfinder folder if not exist (Optional)​

Under Downloads folder if pathfinder folder does not exist please create it.

Step 3: Navigate to the Application Directory​

You need to navigate to the app directory where the main application script is located. If you're in the root project directory, run the following command:

cd path/to/privacy-service/

Replace path/to/privacy-service with the actual path to your project folder.

Step 4: Modify the config​

  • Config file location is: /config.yml
  • Update the config file: Under watch_folders update both paths, and replace %user% with the username.

Step 5: Run the Application​

Once inside the app directory, run the following command to start the application:

python main.py

This will start the application and begin monitoring user interactions.

Step 6: Stopping the Application​

To stop the application, press Ctrl + C in the terminal window where the application is running.
This will stop any ongoing tasks and end the user session.