diff --git a/Adafruit_X2_Time_Ball/README.md b/Adafruit_X2_Time_Ball/README.md
new file mode 100644
index 000000000..447082841
--- /dev/null
+++ b/Adafruit_X2_Time_Ball/README.md
@@ -0,0 +1,20 @@
+# X2 Time Ball aka 2012 Disco Time Ball
+
+The files in this repository accompanied an Adafruit Project "X2 Time Ball" aka "2012 Disco Time Ball"
+
+See these Adafruit blog posts for additional details:
+
+https://blog.adafruit.com/2011/12/16/a-little-bit-of-times-square-on-your-desk/
+https://blog.adafruit.com/2011/12/19/new-year%E2%80%99s-disco-ball-3d-shapes-from-2d-parts/
+https://blog.adafruit.com/2011/12/21/new-year%E2%80%99s-disco-ball-because-%E2%80%9Cdisco-icosahedron%E2%80%9D-just-doesn%E2%80%99t-have-the-same-ring-to-it/
+https://blog.adafruit.com/2012/01/04/x2-time-ball-final-assembly/
+
+There is the Arduino code and also Processing code for calculating the best way to design the project.
+
+The code was formerly at https://github.com/adafruit/Adafruit-X2-Time-Ball/ - this has now been archived.
+
+If you are looking to make changes/additions, please use the GitHub Issues and Pull Request mechanisms.
+
+All code MIT License, please attribute to Adafruit Industries, Limor Fried
+
+Please consider buying your parts at [Adafruit.com](https://www.adafruit.com) to support open source code