diff --git a/supporting-docs/projects/2017-05-02-circle.md b/supporting-docs/projects/2017-05-02-circle.md
index 5cde4a94..601a9a63 100644
--- a/supporting-docs/projects/2017-05-02-circle.md
+++ b/supporting-docs/projects/2017-05-02-circle.md
@@ -3,6 +3,7 @@ layout: project
 title: Circle
 description: A thin client and server for group chat, supporting IRC & Matrix
 categories: projects client
+thumbnail: /docs/projects/images/circle-fe-term+matrix-small.png
 author: LeoNerd
 maturity: Beta
 ---
@@ -12,7 +13,49 @@ Circle is an IRC & Matrix client which merges the best attributes of a local cli
 
  * Keep IRC connects and state on a backend server, allowing disconnections from local UI.
  * Interact with a real local GUI for the frontend, instead of incurring SSH roundtrips for every keypress.
+ * Supports IRC, Matrix, 
 
 ![image](http://www.leonerd.org.uk/code/circle/circle-two-fes.png)
+![image](/docs/projects/images/circle-fe-term+matrix.png)
 
-Get the code from [LeoNerd's Bazaar](http://www.leonerd.org.uk/code/circle/obtain.html).
+First, get the code from CPAN:
+
+```
+$ cpan Circle
+$ cpan Circle::Net::Matrix
+
+$ cpan Circle::FE::Term
+```
+
+Now you can run the backend. Personally I keep UNIX sockets in `$HOME/var/run` but of course feel free to use whatever path you like.
+
+```
+$ mkdir -p ~/var/run
+$ cd circle-be
+$ ./circle-be --socket ~/var/run/circle.sock
+```
+
+Now you can run the frontend, which connects to the backend server via ssh and connects to that UNIX socket.
+
+```
+$ cd circle-fe-term
+$ ./circle-fe-term sshunix://server/var/run/circle.sock
+```
+
+Then in the Global tab, create a new Matrix network:
+
+```
+/networks add -type matrix Matrix
+```
+
+Then in the new MyNet tab for that network, configure it and connect:
+
+```
+/set homeserver example.org
+/set user_id @me:example.org
+/set access_token MDAxABCDE...
+
+/connect
+```
+
+(for now, you'll have to steal the access token from another Matrix client, such as Riot or [App::MatrixTool](https://metacpan.org/pod/App::MatrixTool))
diff --git a/supporting-docs/projects/images/circle-fe-term+matrix-small.png b/supporting-docs/projects/images/circle-fe-term+matrix-small.png
new file mode 100644
index 00000000..dc88b736
Binary files /dev/null and b/supporting-docs/projects/images/circle-fe-term+matrix-small.png differ
diff --git a/supporting-docs/projects/images/circle-fe-term+matrix.png b/supporting-docs/projects/images/circle-fe-term+matrix.png
new file mode 100644
index 00000000..c09095a8
Binary files /dev/null and b/supporting-docs/projects/images/circle-fe-term+matrix.png differ