odrive

The odrive Developer Hub

Welcome to the odrive developer hub. You'll find comprehensive guides and documentation to help you start working with odrive as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Manage Sync

TRACK SYNC PROGRESS

When you sync a large file or large set of files, odrive automatically optimizes your sync job to deliver the fastest and most successful transfer to the cloud. That being said, you may inevitably need to just be patient. A big job is still a big job, and we can't make your connection faster (even though we'd like to).

If you do not see the blue badge that signifies completion, you can track the sync progress.

Track sync in real-time from your system tray

It provides you with the percentage completed, in relation to the other files you are trying to sync.

To read more about which cloud storage is the fastest in the land: Is Your Cloud Storage Slow as Shit?

STOP AND START ALL SYNC

You may want to stop odrive sync so that another application (e.g. Netflix) can optimize bandwidth or simply because you wanted to stop a certain file or folder from syncing to the cloud.

Stop sync from the odrive tray menu

This is an account-level setting so all sync of any files across odrive will stop. You can restart sync when you are ready.

Re-start sync when your ready from the tray

STOP FILE SYNC

If you are downloading a very large file or folder, but you want to stop the syncing because you did not mean to sync it or simply want to pause it until later, you can stop the syncing by right clicking on it:

Right click any file in-sync and select stop

Similarly, if you double-clicked on a placeholder or hit right click sync on it, you can stop the placeholder from expanding into a regular file or folder by the same right click "Stop Sync" action.

For both actions, you can restart by right-click "Sync" to start the download again or double clicking to expand the placeholder.

Re-sync your file when you're ready
For uploads of really large files or updates of really large files, we recommend using "Pause Sync" located in your tray menu. The right-click "Stop Sync" will only pause uploads for a short time; odrive will automatically resume the upload a few seconds later.

Pause sync from your system tray

THROTTLING BANDWIDTH UTILIZATION

Bandwidth throttling can be used to limit your upload or download rates, when you want to minimize bandwidth congestion or optimize the performance of another application that is utilizing the Internet.

odrive allows you to control separately the upload and download rates with this Premium feature.

Throttle odrive uploads/downloads if connection is limited

This flexibility is important since the upload speed permitted by your Internet Service Provider is typically much lower than the download speed. You can test your speed by using an available online test site. Open your web browser to your favorite search engine and search for "speedtest".

You may want to control bandwidth utilization based on whether you are uploading vs. downloading, size of your files, and the bandwidth hogging of concurrently running applications (e.g. Netflix binge watching).

UPLOAD LARGE FILES (IFS/SPLIT LARGE FILES)

Storage is pretty useless if you can’t upload your files. That is why we created the odrive Infinite File Size (IFS) feature. IFS gives users a sure-fire way to get even the largest files uploaded. If you find that you are experiencing issues with larger files uploading successfully, you should adjust your IFS settings to compensate.

IFS is available from the odrive tray menu under “Split Large Files”.

You have the option of choosing a threshold and segment size between 100MB and 2GB, or turning off IFS completely with the “Nothing” setting.

Set the size you wish to split large files in the tray menu

Once set, the odrive desktop client will automatically engage IFS when uploading any files that exceed the selected size option. The file will be split into chunks, according to the size selected, and uploaded to your storage.

For example, if you have set the IFS option to 100MB and you have added a 650MB file into an odrive folder, the odrive desktop client will automatically split the file into 7 different segments (6 x 100MB + 1 x 50MB) and upload it. If an IFS file upload is interrupted at any point, odrive will resume the upload from where it left off, automatically.

Important: The files uploaded with IFS will remain "split" on the remote storage. These files will look just like any other file, both as a placeholder and locally cached, when viewed through the odrive desktop client. If you try to access these files outside of odrive, they will appear in their "split" state.

For an in-depth look at IFS, please take a look at our blog post about IFS.

SYNC EXTERNAL FOLDERS

The Sync to odrive premium feature sets up a direct sync relationship between any folder on your computer to any storage that you've linked in odrive. So you can sync a folder on your computer in its existing location to any storage without having to constantly move or copy your files into the odrive folder.

For example, you may want to sync your Downloads folder on your computer to a Laptop Backup subfolder on your Amazon Drive storage that you've linked to odrive. Then every file you download on your computer from your web browser or email which goes into Downloads is also saved to your Amazon Drive.

We would begin by right-clicking on the Downloads folder on my computer (e.g. ~/Downloads/ on my mac, or C:\Users\MyUser\Downloads on my Windows laptop).

Right-click 'Sync to odrive'

Your web browser will then automatically open to a Pick Destination Folder screen where you can select the desired storage location inside odrive. Let's use /Amazon Cloud Drive/Laptop Backup as our destination folder.

A new matching folder will be created (e.g. /Amazon Cloud Drive/Laptop Backup/Downloads) unless your selected destination folder itself already has the same name or if a matching subfolder already exists.

  • Example 1: I chose Sync to odrive on my Downloads folder and then chose /Amazon Cloud Drive/Laptop Backup/ as my destination folder on the web picker. A new folder Downloads will be created inside of the destination folder unless one already exists (in which case we'll just use that existing Downloads subfolder).
  • Example 2: I chose Sync to odrive on my Downloads folder and then chose /Amazon Cloud Drive/Laptop Backup/Downloads as my destination folder on the web picker. The destination folder name Downloads already matches your Downloads folder name on your computer, so we will use that folder directly.

In both cases, we will now create a direct sync relationship between:

  • Folder on computer: (Mac) ~/Downloads/ or (Windows) C:\Users\MyUser\Downloads\
  • Folder linked to odrive: /Amazon Cloud Drive/Laptop Backups/Downloads/

Any content changes in Downloads on your computer will be synced up to the corresponding Downloads folder on your Amazon Drive above, and vice versa.

In the tray menu, you will find a shortcut to every local folder for which you have configured the Sync to odrive option.

You can stop the sync at any time by the right click menu.

Remove sync from a folder anytime

Although we can sync most folders, we do not recommend that you sync folders that contain active application data (Quickbook files), large files that are actively edited, and databases.

Please note that creating direct sync relationships between folders on your computer (outside of your odrive folder) and your linked storage is different from just using the automatic sync capabilities for folder within your odrive. The former is a Premium feature, while the latter is a part of the free version.

For more information about how you can use either the free or the Premium ways of syncing your files, please see this medium article on using sync to backup your computer to Amazon Drive.

SYNCING EXTERNAL STORAGE

You can sync external storage to an odrive storage location, so long as it is represented as a folder on your local computer. While syncing, your computer must be connected to the external storage and have persistent access to the storage.

Navigate into your external storage device on your local computer, you can right click Sync to odrive on any folder in that storage.

Right-click 'Sync to odrive'

Your web browser will then automatically open to a Pick Destination Folder screen where you can select the desired storage location inside odrive.

A new matching folder will be created with the same name as the folder you selected Sync to odrive on unless your selected destination folder itself already has the same name or if a matching subfolder already exists.

The contents of the external storage folder will be synced to the selected odrive folder.

You will find a shortcut to every local folder you have synced in the tray menu.

You can stop the sync at any time by the right click menu.

Remove sync from a folder anytime

Manage Sync