Explain how to upload and create video.

And explain a bit about jq and tranforming json.

Author: Manfred

README.md

@@ -8,6 +8,10 @@ A command-line interface for interacting with the SWITCHtube web service.
 
     brew install fingertips/tap/teletube
 
+If want to format or transform the resulting JSON is can be useful to install `jq`.
+
+    brew install jq
+
 ## From source
 
     git clone https://github.com/Fingertips/teletube.git
@@ -26,11 +30,49 @@ If you need to operate on a different endpoint, usually for testing purposes, yo
 
 # Channels
 
-Most interaction is around a channel so start by listing all channels you can upload to.
+Start by listing all channels you can access.
 
     teletube channels
 
-Alternatively you can limit the number of channels by filtering your own channels or the ones you don't own, but can upload to.
+Or filter the channels you own, or the channels you may contribute to.
 
     teletube channels list --role owner
     teletube channels list --role contributor
+
+# Upload a video
+
+    teletube files upload FILE.MOV
+
+This should print a NO_CONTENT response for every 50 megabytes uploaded. Error messages are handled as long as the command keeps running.
+
+Copy-paste the characters after 📃, this is the upload id.
+
+You can use a channel id, upload id, and a title to create a new video with the upload.
+
+    teletube videos create --channel-id <id> --upload-id <id> --title "Very serious video about nature."
+
+You can set other details about the video too, please use `--help` to see them.
+
+    teletube videos create --help
+
+# Help
+
+You can always end a command with `--help` to get more details. For example:
+
+    teletube --help
+    teletube browse --help
+    teletube browse poster --help
+    
+#  JSON
+
+Status information about the command is printed to `stderr`. JSON responses are written to `stdout` so you can use tools like `jq` to get details.
+
+For example, you can format the JSON for readability.
+
+    teletube channels list --role owner | jq
+
+Or you can transform it to only show the `id` and `name`.
+
+    teletube channels list --role owner | jq ".[] | {id: .id, name: .name}"
+
+The best way to learn `jq` is through the tutorial [https://stedolan.github.io/jq/tutorial/](https://stedolan.github.io/jq/tutorial/) and trying it out on [https://jqplay.org](https://jqplay.org).