diff --git a/README.md b/README.md
new file mode 100644
index 0000000..de6aaf6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,3 @@
+hello, this is a python scipt to play the portal 1 credits (also known as "still alive") on your linux machine! 
+the RUNMEBEFORE.sh script installs all of the neccsary components and packages for STILLPYTHON.
+when you get the message "All done! You're ready to run STILLALIVE.py!" you can go and do "python3 STILLALIVE.py" and there!