MControlCenter

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

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

Note: if your distribution ships old versions of Qt (older than 6.8) like ubuntu/Linux mint (Qt 6.4), you might need to build from source, continue reading.

Building from source

After installing the main package (qt6-base or libqt6widgets6), you'll need to install other packages to build the app.

For ubuntru/Linux mint: qt6-base-dev and/or qt6-tools-dev

For Arch qt6-tools And for fedora qt6-qttools

After you install the packages:

Make sure the app is completely closed if it was installed before (check if there is a system tray icon and close it).

Download the source code and extract the zip file.

Open the scripts folder.

Open a terminal inside the folder, then run these scripts in order:

1. build
2. create installer

If things went well, you should see a compressed file,

4. Extract it.
5. Open a terminal inside the new folder
6. Run the UNINSTALL script as sudo, it might fail if you don't have MCC installed. thats fine.
7. Run the INSTALL script as sudo, the last line should be a confirmation that the install was successful.
8. Check your apps, McontrolCenter should be there.

If the installation was successful but the app fails to run, open a terminal and type mcontrolcenter, copy the output and open an issue (IF there isn't one already).

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.