diff --git a/uisimulator/README b/uisimulator/README
new file mode 100644
index 0000000000..bf1291fbc5
--- /dev/null
+++ b/uisimulator/README
@@ -0,0 +1,9 @@
+Solaris
+
+ $ make
+ $ ./rockboxui
+
+Linux
+
+ $ make LIBDIRS=-L/usr/X11R6/lib
+ $ ./rockboxui