Update README.md

README.md

@@ -19,13 +19,18 @@ $ cd youtube-upload-master
 $ sudo python setup.py install
 ```
 
-  * If you don't want (or you can't) install software on the computer, run it directly from sources:
+  * Or run directly from sources:
 
 ```
 $ cd youtube-upload-master
 $ PYTHONPATH=. python youtube_upload/youtube_upload.py ...
 ```
 
+Authentication
+==============
+
+You'll see that there is no email/password options. Instead, the Youtube API uses [OAuth 2.0](https://developers.google.com/accounts/docs/OAuth2) to authenticate the upload. The first time you try to upload a video, you will be asked to follow a URL in your browser to get an authentication token. If you have multiple channels for the logged in user, you will also be asked to pick which one you want to upload the videos to. You can use multiple credentials, just use the option ```--credentials-file```. Also, check the [token expiration](https://developers.google.com/youtube/v3/) policies.
+
 Examples
 ========
 
@@ -37,13 +42,14 @@ $ youtube-upload --title="A.S. Mutter" --description="A.S. Mutter plays Beethove
 pxzZ-fYjeYs
 ```
 
-* Upload a video with your own ```client_secrets.json```:
+* Upload a video with your own ```client_secrets.json``` and credentials file:
 
 ```
 $ youtube-upload --title="A.S. Mutter" --description="A.S. Mutter plays Beethoven" \
                  --category=Music --tags="mutter, beethoven" 
-                 --client-secrets=my_client_secrets.json anne_sophie_mutter.flv
-pxzZ-fYjeYs
+                 --client-secrets=my_client_secrets.json
+                 --credentials-file=my_credentials.json anne_sophie_mutter.flv
+tx2Zb-145Yz
 ```
 
 * Split a video with _ffmpeg_
@@ -69,16 +75,14 @@ $ youtube-upload ....
 Caveats
 =======
 
-* The package includes a default ```client_secrets.json``` file. If you plan to make a heavy use of the script, please [create and use your own OAuth 2.0 file](https://developers.google.com/youtube/registering_an_application).
-* If a video does not comply with Youtube size limitations you must split it (using ffmpeg/avconv, for example).
-* Check the [token expiration](https://developers.google.com/youtube/v3/) policies.
+* The package includes a default ```client_secrets.json``` file. If you plan to make a heavy use of the script, please [create and use your own OAuth 2.0 file](https://developers.google.com/youtube/registering_an_application), it's a free service.
 
 Notes for developers
 ====================
 
 * Main logic of the upload: [main.py](youtube_upload/main.py) (function ```upload_video```).
 * Check the [Youtube Data API](https://developers.google.com/youtube/v3/docs/).
-* Some [examples](https://github.com/youtube/api-samples/tree/master/python).
+* Some Youtube API [examples](https://github.com/youtube/api-samples/tree/master/python) provided by Google.
 
 More
 ====
@@ -86,4 +90,4 @@ More
 * License: [GNU/GPLv3](http://www.gnu.org/licenses/gpl.html). 
 * Bugs: [Open a issue](https://github.com/tokland/youtube-upload/issues).
 * New features: I'll try to fix bugs, but, to add functionality, please send a pull request.
-* [Want to donate?](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=pyarnau%40gmail%2ecom&lc=US&item_name=youtube%2dupload&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest).
+* [Want to donate?](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=pyarnau%40gmail%2ecom&lc=US&item_name=youtube%2dupload&no_note=0&currency_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest)