Oxygen Toolkit (01-22-2020) Win-28 / Mac-81 / Linux-60

Dear Oxygen Community,

We’ve got a BIG release of the Oxygen Toolkit available this morning, especially for those of you using our sync capabilities in the toolkit.

  • Sync: custom sync exclusions
    • Use the exclusions command from the sync> prompt to manage exclusion sync rules against a file name or path match pattern (e.g. test.txt, *.tmp, test*, [bnprt]est.txt, ?est.txt).
    • The exclusion rule is bidirectional; both local and remote changes matching the pattern are prevented from syncing.
    • Use the excluded command to see what has been stopped from uploading or downloading by an exclusion rule.
    • You can also allow an excluded item to upload or download (e.g. excluded download test*).
  • Sync: create push-only sync mounts
    • When you set up the mount using the –push option, only local-to-remote changes will sync. Changes made on the remote side will not propagate back to local.
    • Use the holds command to see what remote-to-local changes were held. The holds command can also be used to undo, upload, or download a change accordingly.
  • Sync: improvements to resolve failures and conflicts
    • The failed and conflicts commands have been enhanced to be more consistent with the new command usages (so you can use wildcard patterns and also use familiar subcommands like failed download * or conflicts upload *.jpg to retry a sync failure or conflict.
    • Conflicts can also be resolved with the rename subcommand so you can keep both files (e.g. conflicts rename test.txt will keep the remote “test.txt” file intact and upload your local file as “test (1).txt”).
    • Both failed items and conflicting items can also be ignored using the ignore command if you want to keep the lists clean. Ignored items will no longer try to sync.
      • Ignored items can be retried later (e.g. ignored upload * will attempt to retry all ignored uploads).
  • Sync: enhanced schedule command to set up refresh and offload schedules for a path.
    • Set up a daily or hourly refresh of a folder (including using the –recursive option).
    • Set up a daily or hourly offload task which can include –age=<days-old> comparison (against date modified) or –inactive=<days-inactive> (against the last time the file was uploaded or downloaded) to automatically offload the local copy of the files in order to free up local disk space.
    • As a reminder, offloaded files in the toolkit currently disappear, though future versions of the toolkit may allow for other options (sparse files like in Oxygen Drive or placeholder files like in odrive).
  • New oxygen shell too for managing your oxygen account:
    • Sign up for an oxygen account (similar to how you can create an account via Oxygen Drive). You can sign in and sign out after you have an account.
    • Manage the storage attached to the oxygen account (list, add, or remove storage).
    • Once you have storage linked to the account, you can authorize explorer shell to access your oxygen storage. You can either authorize by providing account credentials or by using key-based access.
    • Oxygen shell is where you manage your key-based storage access as well. Use the keys command to manage your keys. Find the storage-access key to see how to link your storage to explorer shell using the explore utility’s oxygen authorize <account> <secret> command.
      • Example: if my account handle is yoda and my storage-access key is set to 12345, I can use the explore utility to run oxygen authorize yoda 12345 to give explorer key-based access to my oxygen account storage without having to enter my oxygen user’s sign-in ID and password.
  • Integration fixes and improvements:
    • Enable multipart uploads to S3 and Dropbox.
    • Bug fixes
  • Lots of other miscellaneous fixes and improvements.

Existing users: we highly recommend updating as soon as possible for best results. You will unfortunately need to deauthorize and reauthorize your existing storage links (you can do this one-at-a-time manually if don’t have a lot of storage linked, or you can consult the reset configuration documentation for a quicker way).

Download: The new toolkit can be downloaded here, and the documentation is available for reference. We are in the process of upgrading our documentation, so some of the newer functionality mentioned above may not quite be available yet. Check back from time to time, and as always, feel free to ask us a question here on the forum if you have any questions. We’re here to help.