Divoom PC Monitor Python - Implementation for Linux Systems

This repository contains the Python code that interfaces with the Divoom PC Monitor application on the Divoom Times Gate or Divoom Pixoo64 to monitor system information for Linux systems.

Overview

This project is a Python implementation of the Divoom PC Monitor originally written in C# by DivoomDevelop. It allows users to monitor various system metrics and display them on their Divoom Times Gate or Divoom Pixoo64.

Features

• System Metrics Displayed:
  • CPU usage percentage
  • CPU temperature
  • RAM usage
  • GPU usage (NVIDIA & AMD)
  • GPU temperature (NVIDIA & AMD)
  • HDD usage (dynamic drive selection based on highest usage)
• Easy Setup: Configuration script simplifies the setup process.
• Scheduled Task Support: Users can copy the SystemD config files for easy systemctl support.

Usage

1. Configuration:

   • Run divoom_setup.py to create the necessary configuration file and established the Divoom PC Monitor app on a LCD face.

2. Running the Script:

   • Execute divoom_pc_monitor.py
   • The following arguments are accepted:

    usage: divoom_pc_monitor.py [-h] [-i INTERVAL_IN_SECONDS] [-v]
   
    DivoomPCMonitor.py - Monitor system information on a Divoom Times Gate device
   
    options:
    -h, --help            show this help message and exit
    -i, --interval_in_seconds INTERVAL_IN_SECONDS
                            Interval in seconds to update the system information (default: 30)
    -v, --verbose         Display verbose output on the console
   

Installation

1. Clone the repository:

   git clone https://github.com/KallanX/Divoom-PC-Monitor-Python.git
   cd Divoom-PC-Monitor-Python
   

2. Run the setup:

   python divoom_setup.py
   

   ⚠️ Attention: If the PC Monitor app (625) is currently displayed on a 'LCD face', the setup output will include 'Divoom PC Monitor'. This message doesn't restrict which 'LCD face' you can ultimately use; the app can be assigned to any face regardless of its initial state.

3. Execute main monitor:

   python divoom_pc_monitor.py -i 10 -v
   

4. (Optional) Setup SystemD service by copying the distro associated service file:

   cp /systemd-configs/<DISTRO>/divoom_monitor.service  /etc/systemd/system/
   sudo systemctl daemon-reload
   sudo systemctl enable divoom_monitor.service
   sudo systemctl start divoom_monitor.service
   

Work In Progress

1. The number one WIP is getting Intel cards (Arc) to properly report GPU usage and temps. This is a current WIP for the Linux kernel team and will be implemented into this project once available.
2. An on-going bug hunt and optimization. User contributions/recommendations are welcome.

Author

This project was created by Keith Carichner Jr. due to the lack of a competent implementation that actually functioned and was well-written/documented.

License

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