Building

Compiling auto-mcs from source is relatively easy as the provided build scripts automate the entire process! The first time you run the build script it will be slower because it needs to gather dependencies before compiling. After the initial setup, consecutive compilations will take seconds!

Windows

On Windows, open a PowerShell instance as administrator and run the following one-liner to build auto-mcs from source:

$a = ".\auto-mcs.zip";Invoke-WebRequest https://auto-mcs.com/src -OutFile $a;Expand-Archive $a -DestinationPath ".";Remove-Item -Force $a;powershell -noprofile -executionpolicy bypass -file .\auto-mcs-main\build-tools\build-windows.ps1

macOS

On macOS, open a Terminal instance as a standard user and run the following one-liner to build auto-mcs from source:

git clone https://github.com/macarooni-man/auto-mcs && cd auto-mcs/build-tools && chmod +x build-macos.sh && ./build-macos.sh

Note

When running this command, you’ll be prompted to install the command line developer tools if git is not installed. Additionally, you’ll be prompted to install the homebrew package manager if it’s not installed

Linux

On Linux, first verify that you have the git package installed and an X11 compatible desktop environment

Note

On Linux, Kivy requires a desktop environment with X11 to install, but there’s a work around

• It’s currently not possible to compile running pure Wayland, though, the finished binary can run under Wayland
  

If you don’t have an X11 environment, install the xvfb package to emulate a display and enable it th the following commands:

export DISPLAY=:0.0
Xvfb :0 -screen 0 1280x720x24 > /dev/null 2>&1 &
sleep 1
fluxbox > /dev/null 2>&1 &

Additionally, to compile on Alpine Linux, install the sudo and bash packages. Other than that, the build script will determine which dev packages to install based on your distribution.

Finally, in a terminal run the following one-liner to build auto-mcs from source:

git clone https://github.com/macarooni-man/auto-mcs && cd auto-mcs/build-tools && chmod +x build-linux.sh && sudo ./build-linux.sh

Additional Notes

The source repo will be stored in the directory that you run the command in. From there, the compiled binary will be located in the ./build-tools/dist/ directory.

Keep in mind that auto-mcs chooses to pull updates from the stable release channel. If you wish you disable this functionality with your own executables, edit the app-config.json file in the app data directory.

To disable automatic update detection, insert the following key at the top:

{
  "auto-update": false,
  ...
}

After this edit, the config file should look something like this:

{
  "auto-update": false,
  "fullscreen": false,
  "geometry": {
    "pos": [
      527,
      119
    ],
    "size": [
      850.0,
      850.0
    ]
  }
}