From 4295183a67e979482f25104812283abc7c77e7b2 Mon Sep 17 00:00:00 2001
From: Victor Westerlund <victor@victorwesterlund.com>
Date: Sun, 31 Oct 2021 16:07:52 +0100
Subject: [PATCH] Update README.md

---
 README.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index b393571..cd943c4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-<h1 align="center">Still Alive</h1>
-<p align="center">A JavaScript implementation of the <a href="https://web.archive.org/web/20210929222906/https://www.youtube.com/watch?v=Y6ljFaKRTrI">end credits</a> from the video game <a href="https://en.wikipedia.org/wiki/Portal_(video_game)"><code>Portal</code></a></p>
+<p align="center"><img width="200" src="https://storage.googleapis.com/public.victorwesterlund.com/github/VictorWesterlund/still-alive/still-alive-f.svg"/></p>
+<h3 align="center"><strong>Still Alive</strong></h3>
+<p align="center"><i>The <a href="https://web.archive.org/web/20210929222906/https://www.youtube.com/watch?v=Y6ljFaKRTrI">end credits song</a> from the video game <a href="https://en.wikipedia.org/wiki/Portal_(video_game)">Portal</a><br>done with pure JavaScript, browser windows, and a lot of patience.</i></p>
 <p align="center"><a href="https://victorwesterlund.github.io/still-alive/"><strong>Take me to the demo 🍰</strong></a></p>
+<img src="https://user-images.githubusercontent.com/35688133/139586996-06eaa0cd-0c99-4e14-ba9d-2649e56c421f.png"/>
+<h2>Known limitations</h2>
+<ul>
+  <li><strong>Time drifting</strong><br>The browser will throttle <code>setTimeout()</code> when it deems a page as low-priority (running in the background etc.). This will cause all visuals to fall behind the music and appear as delayed.</li>
+  <li><strong>Windows blocked</strong><br>Pop-up blockers (built-in on most browsers) will prevent all- or some windows to open. You have to allow the page to "open multiple windows" in your browser for this demo to work.</li>
+  <li><strong>Stacking windows on Chrome for Windows (the OS)</strong><br>Due to a <a href="https://bugs.chromium.org/p/chromium/issues/detail?id=137681">bug in Chromium on Windows</a>, browser windows will stack if the play button is clicked from a non-primary display.</li>
+</ul>