Skip to content

An application that allows you to change the settings of MSI laptops running Linux

License

Notifications You must be signed in to change notification settings

mutchiko/MControlCenter

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MControlCenter

MControlCenter is a Free and Open Source GNU/Linux application that allows you to change the settings of MSI laptops.

Screenshots of MControlCenter

Features

  • CPU and GPU temperature display
  • Fan speed display
  • Switch between modes (Since version 0.2):
    • High Performance
    • Balanced
    • Silent
    • Super Battery
  • Change the maximum battery level limit
  • Advanced Fan Speed Control (Since version 0.4)
  • Change other settings such as keyboard backlight mode, USB Power Share, etc.

TODO

  • Saving multiple fan speed profiles

Supported devices

The app uses the msi-ec driver that comes with the linux kernel, so device support depends on whether the kernel driver supports your device or not.

List of tested devices by msi-ec

If your device is not on the list, follow the steps on the msi-ec github page to add support for your device.

Installation

The application requires the ec_sys module with option write_support=1 to run.

If the ec_sys kernel module is not included in your distribution's kernel, you can use the acpi_ec kernel module.

If your laptop is in the supported devices list but all the options are grayed out, consider reinstalling the msi-ec driver.

This is a Qt6 application. You may need to install libqt6widgets6 or its equivalent on your distribution for the applicatoin to run.

Installation from the archive

  1. Download MControlCenter-x.x.x.tar.gz from the releases page
  2. Unpack the archive with the program
  3. Open terminal in unpacked directory
  4. Run the script sudo ./install

Installation from the repository

openSUSE Tumbleweed:

zypper addrepo https://download.opensuse.org/repositories/home:dmitry-s/openSUSE_Tumbleweed/home:dmitry-s.repo
zypper refresh
zypper install mcontrolcenter

openSUSE Leap 15.5

zypper addrepo https://download.opensuse.org/repositories/home:dmitry-s/openSUSE_Leap_15.5/home:dmitry-s.repo
zypper refresh
zypper install mcontrolcenter

openSUSE Leap 15.4:

zypper addrepo https://download.opensuse.org/repositories/home:dmitry-s/15.4/home:dmitry-s.repo
zypper refresh
zypper install mcontrolcenter

Launch MControlCenter on session startup

To restore settings after a reboot, add MControlCenter to startup.

Execute this command on a terminal:

cp /usr/share/applications/mcontrolcenter.desktop ~/.config/autostart/mcontrolcenter.desktop

Localization

You can help translate the MControlCenter app into your native language

  1. Copy /src/i18n/MControlCenter_en.ts to src/i18n/MControlCenter_xx.ts where xx is language code into which the translation is being made.
  2. Open MControlCenter_xx.ts in text editor and change language="en_US" to your language code.
  3. Translate strings into your language directly in a text editor or use the QT Linguist app.
  4. Translate GenericName in app shortcut resources/mcontrolcenter.desktop. To do this, add the line GenericName[xx]=translated generic name.
  5. Send pull request on github.

About

An application that allows you to change the settings of MSI laptops running Linux

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 94.1%
  • CMake 3.1%
  • Shell 2.0%
  • C 0.8%