From 9a454c213fc84a41c5501e06a7ea3ad02e2e9cf6 Mon Sep 17 00:00:00 2001 From: drm00 Date: Wed, 24 Mar 2021 23:28:53 +0100 Subject: [PATCH] Update INSTALL.md (#1) (#400) Update the installation instructions for katrain on the M1-Macs --- INSTALL.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/INSTALL.md b/INSTALL.md index 5f332a6..508831a 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -25,6 +25,22 @@ brew install katago pip3 install katrain ``` +If you are using a M1 Mac, at the point of writing, the latest stable release of Kivy (2.0) does not support the new architecture, so we have to use a development snapshot and build it from source: + +```bash +/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)" +brew install python3 +brew install katago + +# install dependencies: https://kivy.org/doc/stable/installation/installation-osx.html#install-source-osx +brew install pkg-config sdl2 sdl2_image sdl2_ttf sdl2_mixer gstreamer ffmpeg + +# install Kivy from source: https://kivy.org/doc/stable/gettingstarted/installation.html#kivy-source-install +pip3 install "kivy[base] @ https://github.com/kivy/kivy/archive/master.zip" --no-binary kivy + +pip3 install katrain +``` + Now you can start KaTrain by simply typing `katrain` in a terminal. These commands install [Homebrew](https://brew.sh), which simplifies installing packages, @@ -32,8 +48,6 @@ These commands install [Homebrew](https://brew.sh), which simplifies installing To upgrade to a newer version, simply run `pip3 install -U katrain` -If you encounter an error about SDL being missing, try ` brew install sdl sdl_image sdl_mixer sdl_ttf portmidi` - ### Troubleshooting and Installation from sources Installation from sources is essentially the same as for Linux, see [here](#LinuxSources),