docs: usage instructions

Author: forevanyeung

README.md

@@ -1,11 +1,49 @@
+![](extras/art/guppy-1.png)
+
 # guppy
-Guppy is a simple tool for opening files in Google Drive. It can be used as a file handler to associate with file types and open them in Google Drive, or also as a command line tool to upload files to Google Drive.
+Guppy is a simple tool for opening files from your computer in Google Drive. It can be set as the default file handler 
+or as a command-line tool.
+
+## Usage
+When you launch guppy for the first time, it will set itself as the default handler. Then you can double-click or 
+right-click and select open with any CSV, Excel, Word, or PowerPoint file to have guppy upload and open it in Google 
+Drive. 
+
+#### Command Line 
+`guppy [file]` `guppy upload [file]`  
+Upload a file to Google Drive.  
+
+`guppy login`  
+Login to Google Drive.  
+
+`guppy help [command]`  
+Display help information.
+
+#### Flags
+```
+-h, --help      Provides help command
+-v, --verbose   Enable verbose output
+```
 
 ## Installation
-Create a Google OAuth2 Client ID for Desktop applications.
-Deploy a configuration profile for macOS.
-Download the guppy app from releases.
+To use guppy, you will need to set up a Google OAuth2 Client ID. As an organization, you can distribute the OAuth2 
+Client ID to your users via an MDM configuration profile.
 
-## Usage
-Set guppy as the default file handler
-Double-click or Open with, authorize Google Drive, the authorization is saved in the keychain for 1 hour.
+#### Create a Google OAuth2 Client ID for Desktop applications
+1. Go to https://console.cloud.google.com/projectcreate
+2. Enable the Google Drive API
+3. Configure OAuth consent screen
+4. Create a OAuth2 Client ID for Web application, save the client ID
+5. Add `http://localhost/interstitial.html` as a redirect URI
+
+#### Deploy a configuration profile for macOS
+Examples of configuration profiles can be found in the `extras` folder. Substitute the client ID in the configuration 
+profile with your own from Step 4 above.
+| key                  | type    | required | default |
+|----------------------|---------|----------|---------|
+| GoogleOauth2ClientId | String  | true     |         |
+| DisableAnalytics     | Boolean | false    | false   |
+
+#### Download the guppy app from releases
+The latest release of guppy can be found in the [releases](https://github.com/forevanyeung/guppy/releases) section of 
+this repository.

extras/guppy.mobileconfig

@@ -5,6 +5,18 @@
         <key>PayloadContent</key>
         <array>
             <dict>
+                <key>PayloadDisplayName</key>
+                <string>Custom Settings</string>
+                <key>PayloadIdentifier</key>
+                <string>79663069-1865-4C0B-9C2F-72977D4C5C79</string>
+                <key>PayloadOrganization</key>
+                <string></string>
+                <key>PayloadType</key>
+                <string>com.apple.ManagedClient.preferences</string>
+                <key>PayloadUUID</key>
+                <string>79663069-1865-4C0B-9C2F-72977D4C5C79</string>
+                <key>PayloadVersion</key>
+                <integer>1</integer>
                 <key>PayloadContent</key>
                 <dict>
                     <key>com.forevanyeung.guppy</key>
@@ -15,7 +27,7 @@
                                 <key>mcx_preference_settings</key>
                                 <dict>
                                     <key>GoogleOauth2ClientId</key>
-                                    <string></string>
+                                    <string>xxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com</string>
                                     <key>DisableAnalytics</key>
                                     <false />
                                 </dict>
@@ -25,5 +37,25 @@
                 </dict>
             </dict>
         </array>
+        <key>PayloadUUID</key>
+        <string>F3800699-4456-4B39-837F-8BBBBA8306BF</string>
+        <key>PayloadType</key>
+        <string>Configuration</string>
+        <key>PayloadOrganization</key>
+        <string></string>
+        <key>PayloadIdentifier</key>
+        <string>F3800699-4456-4B39-837F-8BBBBA8306BF</string>
+        <key>PayloadDisplayName</key>
+        <string>Guppy Configuration</string>
+        <key>PayloadDescription</key>
+        <string />
+        <key>PayloadVersion</key>
+        <integer>1</integer>
+        <key>PayloadEnabled</key>
+        <true />
+        <key>PayloadRemovalDisallowed</key>
+        <false />
+        <key>PayloadScope</key>
+        <string>User</string>
     </dict>
 </plist>