diff --git a/README.md b/README.md
index 27e32de..0b57d41 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,42 @@ A generated Onvif client in Go. Contains a simple command line utility to send O
 commands/queries to an Onvif compatible device. This also serves as an example of how to use the
 generated client programatically.
 
+## CLI Usage
+
+Get the built `gonvif` binary for your system and architecture from our
+[Release](https://github.com/eyetowers/gonvif/releases) page.
+
+Then run a command of your choice from one of the supported Onvif ports, e.g., listing all device
+profiles using the `media` port, providing the Onvif device URL and credentials:
+
+```bash
+gonvif -a http://IP[:PORT] -u USERNAME -p PASSWORD media get-profiles
+```
+
+### Shell completion
+
+Get the shell completion script by running the following, using one of `bash`, `zsh`, `fish`,
+`powershell`:
+
+```bash
+gonvif completion bash
+```
+
+## Client Usage
+
+```golang
+import "github.com/hooklift/gowsdl/soap"
+
+...
+
+client := soap.NewClient("http://IP[:PORT]/onvif/Media2")
+client.SetHeaders(soap.NewSecurity("USERNAME", "PASSWORD"))
+media := wsdl.NewMedia2(client)
+resp, err := media.GetProfiles(&wsdl.GetProfiles{
+	Type: []string{"All"},
+})
+```
+
 ## License
 
 Gonvif is open source, released under the [MIT license](./LICENSE).