Monitor Controller

Monitor Controller is a Python application that scans connected devices and monitors, and switches input sources based on the detected devices.

Prerequisites

• Python 3.6+
• pip (Python package installer)

Installation

Install from PyPI

1. Install the package using pip:

   pip install monitor_controller

Install from Source

1. Clone the repository:

   git clone https://github.com/ate-pelsma/monitor_controller.git
   cd monitor_controller

2. Create and activate a virtual environment:

   python -m venv venv
   # On Windows
   .\venv\Scripts\activate
   # On macOS/Linux
   source venv/bin/activate

3. Install the required packages:

   pip install -r requirements.txt

Usage

Launch the Application when installed through pip

1. After installing the package, you can launch the application using the monitor_controller command:

   monitor_controller

Launch the Application when cloned via github

1. Run the main program:

   python __main__.py

After launching, simply follow the instructions shown in terminal

2. Follow the prompts to configure the application:

   • Select a trigger device from the list of connected devices.
   • The program will scan for connected monitors and configure the settings.

3. The program will start listening for events and switch monitor input sources based on the detected devices.

4. To exit the program, press Enter in the terminal.

Configuration

The configuration is saved in a config.json file in the working directory. The file contains the selected trigger device and monitor settings. When launching the application for the first time, it will guide you through the process of setting up this file. An example_config.json is stored in the repo to show you what it is supposed to look like.

Logging

Logs are generated to help with debugging and monitoring the application's behavior. The logs include information about detected devices, monitor settings, and actions taken by the application.

License

This project is licensed under the MIT License. See the LICENSE file for details.