Short:        Mount Dropbox as an Amiga volume (DBOX:)
Author:       Renaud Schweingruber (original handler by Norbert Kett)
Uploader:     Renaud Schweingruber <renaud schweingruber protonmail com>
Type:         comm/net
Version:      1.0
Requires:     AmigaOS 3.0+, a TCP/IP stack, AmiSSL, MUI (setup)
Architecture: m68k-amigaos >= 3.0
Distribution: Aminet

DropBox-Handler makes your Dropbox account appear as an ordinary AmigaDOS
volume named DBOX:. Once mounted you can browse it in the Workbench, change
into its drawers from the Shell, and open or save files from any application,
exactly as if it were a local disk. Files are transferred to and from Dropbox
on demand over a secure HTTPS connection - no external programs, no temporary
files.

FEATURES

  - Dropbox mounted as a normal volume (DBOX:); browse, copy, create, delete,
    run programs, open projects.
  - Works from the Workbench, the Shell, and from applications.
  - Secure connection via AmiSSL; nothing else required at run time.
  - MUI setup program (DropBoxPrefs) that stores your keys, logs you in, and
    writes the configuration for you.
  - Phone-based login: DropBoxPrefs shows a QR code you scan with your phone
    to authorise, so there is no long web address to copy by hand (Amiga
    browsers cannot display the Dropbox login page).
  - One "DropBox-Toggle" script that mounts and unmounts with a single command.
  - Adaptive read-ahead: large sequential reads speed up automatically while
    drawer browsing and small reads stay light.
  - Live storage quota via Info DBOX:.
  - Optional blocking of background thumbnail/indexer tools (e.g. Eastern) so
    they do not download every image just to open a drawer.
  - All credentials live in a single config file; nothing secret is compiled
    into the programs, and the short-lived session token is kept in memory
    only, never written to disk.

INSTALLATION

  Double-click the Install icon (Commodore Installer). It copies the handler
  and its data to DEVS:Cloud, DropBoxPrefs to SYS:Prefs, and the DropBox-Toggle
  script to S:.

SETUP IN BRIEF

  Create a free Dropbox "app" in the Dropbox App Console to obtain an app key
  and app secret, then run DropBoxPrefs: enter the keys, press "Show QR code",
  scan it with your phone, approve access, and type the short code back in.
  Mount with "Execute S:DropBox-Toggle". The included AmigaGuide describes the
  whole Dropbox App Console process step by step - please read it, as that is
  the part most people miss.

REQUIREMENTS

  - AmigaOS 3.0 or higher, 68020 or better (including 68080 / Vampire).
  - A working TCP/IP stack (Roadshow, AmiTCP, Miami, ...) and an internet
    connection.
  - AmiSSL installed (amissl.library and amisslmaster.library).
  - MUI, for the DropBoxPrefs setup program.
  - KillDev (from the idefix97 package, not included) in C:, used by the
    supplied DropBox-Toggle script to unmount.
  - A Dropbox account (free is fine) and a phone to scan the login QR code.

CREDITS

  Based on the original Dropbox handler by Norbert Kett (anchor). QR codes via
  the MIT-licensed QR Code generator library by Project Nayuki. Thanks to the
  AmiSSL and MUI teams. Dropbox is a trademark of Dropbox, Inc.; this is an
  independent, unofficial program.