+Overview
+========
+
+This repository contains three things related to writing "hacks", or
+screensavers which are compatible with the
+[xscreensaver](https://www.jwz.org/xscreensaver/) `screenhack` framework.
+They are:
+
+ - a copy of the `screenhack` library, located under the `screenhack/`
+ directory, allowing the compilation of standalone hacks outside the
+ xscreensaver build system,
+
+ - reference files needed to build your own hack, including a simple yet
+ complete reference implementation as well as notes for getting started, all
+ located under the `reference/` directory, and
+
+ - a collection of my own hacks located under the `hacks/` directory.
+
+Each of the three subdirectories includes a `README.md` file explaining how to
+use its contents.
+
+
+Status
+======
+
+Complete. Tested on FreeBSD.
+