Skip to content

Latest commit

 

History

History
80 lines (66 loc) · 3.18 KB

README.md

File metadata and controls

80 lines (66 loc) · 3.18 KB
Raw

Compile From Source

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 with 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 auto-mcs directory:

OS Configuration Path
Windows %APPDATA%\.auto-mcs\Config\app-config.json
macOS ~/Library/Application Support/auto-mcs/Config/app-config.json
Linux ~/.auto-mcs/Config/app-config.json

Append the following key to this file to disable automatic update detection: "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
    ]
  }
}