diff --git a/README.md b/README.md
index 8537484..0d65538 100644
--- a/README.md
+++ b/README.md
@@ -12,12 +12,15 @@ Feel free to email comments, suggestions, or inquiries directly to andrewchilx@g
   <img src="https://github.com/user-attachments/assets/f46a447d-42ce-47af-b2ae-17409240cb9f" width="49%">
 </p>
 
+---
+---
+
 # I. The Software
 
 #### Objectives
 
-✔ **Generate a randomized number grid** with grouped 'bad numbers'.  
-✔ **Animate and style the interface** to match the aesthetics of the show. 
+  - **Generate a randomized number grid** with grouped 'bad numbers'.  
+  - **Animate and style the interface** to match the aesthetics of the show. 
 
 ### a. The Number Grid
 
@@ -25,28 +28,83 @@ Feel free to email comments, suggestions, or inquiries directly to andrewchilx@g
   <tr>
     <td><b>1</b></td>
     <td><b>GENERATE</b></td>
-    <td>A NxN grid is filled with random numbers between 0-9.</td>
+    <td>
+      <ul>
+        <li>A NxN grid is created.</li>
+        <li>Each cell is filled with a random integer between 0-9.</li>
+      </ul>
+    </td>
   </tr>
   <tr>
     <td><b>2</b></td>
     <td><b>MAP</b></td>
-    <td>A Perlin noise map generates smooth gradients, grouping numbers logically.</td>
+    <td>
+      <ul>
+        <li>A Perlin noise map assigns smooth gradient values to the grid.</li>
+        <li>This ensures numbers are naturally grouped rather than randomly scattered.</li>
+      </ul>
+    </td>
   </tr>
   <tr>
     <td><b>3</b></td>
     <td><b>THRESHOLD</b></td>
-    <td>Values above a set threshold are marked as 'bad'.</td>
+    <td>
+      <ul>
+        <li>Each cell's value is compared to a set threshold.</li>
+        <li>Values above the threshold are marked as 'bad' numbers.</li>
+      </ul>
+    </td>
   </tr>
   <tr>
     <td><b>4</b></td>
     <td><b>GROUP</b></td>
-    <td>'Bad' numbers are grouped based on their proximity to others.</td>
+    <td>
+      <ul>
+        <li>'Bad' numbers are grouped based on proximity.</li>
+        <li>At random times, a group visible in the viewport will be activated:
+          <ul>
+            <li>If hovered over, they become 'super active', extending their active time and appearing agitated.</li>
+            <li>If clicked, the group 'refined', animating into a pre-determined bin and resetting as not "bad".</li>
+          </ul>
+        </li>
+      </ul>
+    </td>
   </tr>
   <tr>
     <td colspan="3" align="center">
-      <img src="https://github.com/user-attachments/assets/33353a90-e046-4c57-9a20-040a64b68e8e" width="90%">
+      <img src="https://github.com/user-attachments/assets/33353a90-e046-4c57-9a20-040a64b68e8e" width="50%">
     </td>
   </tr>
 </table>
 
+
+
 ### b. The Interface
+
+- A moving Perlin noise map offsets each number (vertically or horizontally).  
+- Activated bad groups expand / contract / jitter.
+- Numbers scale based on cursor position.
+- Refined groups animate into bins, with a percent bar keeping track of your progress.  
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/14310434-81b7-4f62-8833-948708edee78" width="15%">&nbsp;&nbsp;&nbsp;
+  <img src="https://github.com/user-attachments/assets/6e2145ac-08f5-44f9-bdad-ebf272cbc0ce" width="15%">&nbsp;&nbsp;&nbsp;
+  <img src="https://github.com/user-attachments/assets/5d105682-2eb9-4c84-9806-cfafa7e4dd91" width="15%">
+</p>
+
+#### Additional Features:
+- The application is cross-compatible, allowing compilation for both Linux and Raspberry Pi (ARM).
+- Debug mode reveals various settings.
+- Save / load configurations to / from disk (JSON).
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/f3261ced-c8a8-4699-a935-dd7249ce5d18" width="50%">
+</p>
+
+- An 'idle' mode can be enabled to display the Lumon logo screensaver.
+- Numbers animate-on when going from idle mode.
+- The user can navigate the full grid using arrow and zoom keys.
+
+---
+---
+
+# II. The Housing