X-Git-Url: https://www.tinc-vpn.org/git/browse?a=blobdiff_plain;f=gui%2FREADME.gui;fp=gui%2FREADME.gui;h=f2b095b1624aa345d1248f36ad3529c9a6596865;hb=10d609b1f0dd9eeb024cd40359683d48542aecbf;hp=0000000000000000000000000000000000000000;hpb=55ef2f806f9840103bceb472564a711b22e73d58;p=tinc

diff --git a/gui/README.gui b/gui/README.gui
new file mode 100644
index 00000000..f2b095b1
--- /dev/null
+++ b/gui/README.gui
@@ -0,0 +1,24 @@
+This experimental GUI is written in Python with wxPython widgets. You need to
+have both installed for it to work. After starting tinc with either tincd or
+tincctl, you can start the gui:
+
+tincd -n vpn
+tinc-gui -n vpn
+
+If the GUI cannot find the controlcookie (for example if it is not in
+/var/run), you can specify its location manually:
+
+tinc-gui --controlcookie /usr/local/var/run/tinc.vpn.cookie
+
+The following things sort of work:
+
+- Changing the debug level from the settings page
+- Viewing the list of connections, nodes, edges and subnets. These lists will
+  be refreshed once per second.
+- Right-clicking on a connection brings up a popup menu, which allows you to
+  close a connection.
+
+Python was chosen to enable rapid application development, wxWidgets for its
+cross-platform compatibility and platform-native widgets. Once the GUI is
+matured, it will probably rewritten in C++ to allow static linking and easy
+distribution, without needing to install both Python and wxWidgets.