Short:        Amiga Cloud Handlers
Author:       Norbert Kett (anchor@rocketmail.com)
Type:         comm/tcp
Version:      0.9
Architecture: m68k-amigaos >= 3.0.0; ppc-amigaos; ppc-morphos; i386-aros


DESCRIPTION

  This is a Dos handler pack allowing easy access to your Google Drive
  and Dropbox storage.


REQUIREMENTS

  Internet connection, and for 68k based Amigas: 68020 28MHz, and 8M fast RAM.
  Advertise: To get PCMCIA network card check this link: http://bit.ly/2B1knDn
  
  
LIMITATIONS

  Without the licence key, both handlers act as a read only volume, and document
  exporting is disabled for Google Drive. To obtain the licence key, please
  send 10 EUR to this PayPal account: anchor@rocketmail.com
  You also need to send an email to my email address with the following details:
  - contact email address,
  - display name - (real name, or nick)
  - an email address associated with Google Drive (up to two accounts, optional),
  - an email address associated with Dropbox (up to two accounts, optional)

  
INSTALLATION

  Since there is no installer yet, you need to follow these steps:
  1. Copy the entire 'Cloud' folder to your Devs: from the archive.
  2. If you want to use Google Drive, visit the following site with a modern
     browser: http://bit.ly/2AZRmIl and copy the given client code into
	 Devs:Cloud/google_drive_client_code
     (Please note: Every time when you ask a new client code, you must delete
     Devs:Cloud/google_drive_access_token and Devs:Cloud/google_drive_refresh_token
	 files if they exist!)
  3. If you want to use Dropbox, visit the following site with a modern
     browser: http://bit.ly/2Db5Ueh and copy the given client code into
	 Devs:Cloud/dropbox_client_code
     (Please note: Every time when you ask new client code, you must delete
     Devs:Cloud/dropbox_access_token if it's exist!)
  4. Add the following lines to your user-startup:
  
  ;BEGIN Cloud
     Assign SSLROOT: Devs:Cloud/.sslroot
     Mount GOOGLE: from Devs:Cloud/cloud.mountlist
     Mount DBOX: from Devs:Cloud/cloud.mountlist
  ;END Cloud 

  (If somehow, you already have SSLROOT: assign, skip that line) 
  That’s all. Let's check your installation. 
  Reboot, and open a new CLI window. Type: list GOOGLE: or list DBOX:
  If everything is fine, after few seconds you should see the list of
  files and folders of your GD root or Dropbox root. (GD refers to Google Drive
  in this whole document)
  
  If you want to see GD/Dropbox icon on your Workbench, upload one from
  Devs:Cloud/.data folder to your GD/Dropbox root, and rename it to Disk.info.
  In order to upload files you’ll need to use a full version of the handlers,
  or a modern browser.
  
 
TECHNICAL NOTES

  - If you have 68060 or Vampire 68080 cpu, i recommend to use the handlers
  google-drive-handler_102e.68k and dropbox-handler_102e.68k from the pack. 

  - DOpus doesn't follow Amiga programming reference manual, and does not
  support EOF for ACTION_READ. Thus, I don't recommend DOpus for 
  exporting documents from GD.

  - GD and Dropbox does not allow modification of file contents. If you want to
  modify a file, make a local copy first, and as soon as you have finished, upload it.
  
  - GD expects the exact file size for every upload. If you create a new
  file, it is going to be empty. Due to this, if you upload something, the contents
  will be stored into a buffer, and the real upload will occur when the
  file has been closed. Thus, the maximum size of the uploaded file is limited
  by amount of free RAM. This is not true for Dropbox.
  
  - If the GD short link above isn't working, here is the original long one:
  https://accounts.google.com/o/oauth2/auth?scope=https://www.googleapis.com/auth/
  drive&redirect_uri=urn:ietf:wg:oauth:2.0:oob&response_type=code&client_id=
  641021021914-0f5goga25u7mo14eclhdkqlpc8hueirs.apps.googleusercontent.com
  
  - If the Dropbox short link above isn't working, here is the original long one:
  https://www.dropbox.com/1/oauth2/authorize?client_id=64r6xzzvigfqbst&response_type=code
 
  
PLANNED FEATURES 

  - support AmiSSL
  - OCR (automatic text document export from image, during upload for GD)
  - Shared file support for GD
  - icon ghosting
  - thumbnails as icons for NG systems
  - 64 bit actions for NG systems
  - change detection (if you operate on other machine at the same time)
 
 
VERSION
 
   GD and Dropbox handlers are still in an early stage of development, far from
   the mature state. They may contain bugs. Please consider this release as a
   public beta. Any feedback is welcomed, any question will be answered.
   Thanks to:
    - BSzili,
    - Viktor Soponyai alias dh1 from Amiga Mania Magazin,
    - PMonster,
    - Sir_Lucas