From d88ca348bc67918a43ccbf4d6912fdde16cf8152 Mon Sep 17 00:00:00 2001
From: jazz <jazz@airmail.cc>
Date: Mon, 18 May 2026 21:02:47 -0500
Subject: [PATCH] write readme

---
 README.md | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 0076a32..044fde7 100644
--- a/README.md
+++ b/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