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

dmitry-s93/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

With version 0.5.0 the app uses the msi-ec driver that comes with the linux kernel (you might need to reinstall the driver), 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

This is a Qt6 application. You need to install libqt6widgets6 or its equivalent on your distribution (qt6-base for example). the application will fail to open without it!

Check the output of cat /sys/devices/platform/msi-ec/shift_mode in your terminal, if it says No such file or directory it means that you need to install or reinstall (uninstall first then install) the msi-ec driver. or the application will open but it wont have any effect!

Also, McontrolCenter 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.

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.