write readme

README.md

@@ -1,2 +1,34 @@
-# matlab-launcher
+# matlab launcher script / installation instructions for new linux machines
 
+## Context
+
+matlab ships with shitty outdated qt and c++ libraries and it breaks on
+anything from the current decade.
+
+this fixes it by making your pc fall back on the normal libraries.
+
+also we're gonna do this in a user-owned folder because that just seems like a
+good idea
+
+## Installation
+
+```sh
+sudo mkdir -p /opt/MATLAB
+sudo chown -R $USER:$USER /opt/MATLAB
+
+# get the matlab package manager and install matlab to the directory
+wget https://www.mathworks.com/mpm/glnxa64/mpm
+./mpm install --release=R2026a --destination=/opt/MATLAB/R2026a --products MATLAB Simulink
+
+# broken libraries begone
+cd /opt/MATLAB/R2026a/bin/glnxa64
+mkdir exclude
+mv libfreetype.so* exclude/
+
+# ditto
+cd /opt/MATLAB/R2026a/sys/os/glnxa64
+mkdir exclude
+mv libstdc++.so.6* exclude/
+```
+
+after installing, run `matlab.sh` to launch matlab

matlab.sh

@@ -0,0 +1,31 @@
+#!/bin/bash
+
+# Context
+# matlab ships with shitty outdated qt and c++ libraries and it breaks on
+# anything from the current decade.
+# this fixes it by making your pc fall back on the normal libraries.
+#
+# also we're gonna do this in a user-owned folder because that just seems like
+# a good idea
+
+# Installation:
+# sudo mkdir -p /opt/MATLAB
+# sudo chown -R $USER:$USER /opt/MATLAB
+#
+# wget https://www.mathworks.com/mpm/glnxa64/mpm
+# ./mpm install --release=R2026a --destination=/opt/MATLAB/R2026a --products MATLAB Simulink
+#
+# cd /opt/MATLAB/R2026a/bin/glnxa64
+# mkdir exclude
+# mv libfreetype.so* exclude/
+#
+# cd /opt/MATLAB/R2026a/sys/os/glnxa64
+# mkdir exclude
+# mv libstdc++.so.6* exclude/
+
+# after installing, run this script to launch matlab
+
+QT_QPA_PLATFORM=xcb
+PATH=/opt/MATLAB/R2026a/bin:$PATH
+
+exec matlab -licmode onlinelicensing