OpenDrive
At a glance
Section titled “At a glance”| Capability | Support |
|---|---|
| rclone support tier | Tier 1: Core |
| Checksums | MD5 |
| Modification times | Kept, to 1 s |
| Case-insensitive names | Yes |
| Duplicate names allowed | No |
| Server-side copy | Yes |
| Server-side move and rename | Yes |
| Folder move and rename | Yes, in one step |
| Free space reporting | Yes |
| Empty folders | Yes |
| Change notifications | No |
| Uploads of unknown size | No |
| Public links | No |
Setup notes
Section titled “Setup notes”In CloudMount you add this drive from the Add drive screen, and the wizard asks for the options listed under Options. The notes below come from rclone’s setup guide.
Modification times and hashes
Section titled “Modification times and hashes”OpenDrive allows modification times to be set on objects accurate to 1 second. These will be used to detect whether objects need syncing or not.
The MD5 hash algorithm is supported.
Restricted filename characters
Section titled “Restricted filename characters”| Character | Value | Replacement |
|---|---|---|
| NUL | 0x00 | ␀ |
| / | 0x2F | ／ |
| “ | 0x22 | ＂ |
| * | 0x2A | ＊ |
| : | 0x3A | ： |
| < | 0x3C | ＜ |
| > | 0x3E | ＞ |
| ? | 0x3F | ？ |
| \ | 0x5C | ＼ |
| | | 0x7C | ｜ |
File names can also not begin or end with the following characters. These only get replaced if they are the first or last character in the name:
| Character | Value | Replacement |
|---|---|---|
| SP | 0x20 | ␠ |
| HT | 0x09 | ␉ |
| LF | 0x0A | ␊ |
| VT | 0x0B | ␋ |
| CR | 0x0D | ␍ |
Invalid UTF-8 bytes will also be replaced, as they can’t be used in JSON strings.
Options
Section titled “Options”Standard options
Section titled “Standard options”The wizard asks for these when you add the drive.
username
Section titled “username”Username.
Type: string · Required
password
Section titled “password”Password.
NB Input to this must be obscured - see rclone obscure.
Type: string · Required
Advanced options
Section titled “Advanced options”The wizard shows these under Advanced options. Most drives work without changing any of them.
encoding
Section titled “encoding”The encoding for the backend.
See the encoding section in the overview for more info.
Type: Encoding · Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,LeftSpace,LeftCrLfHtVt,RightSpace,RightCrLfHtVt,InvalidUtf8,Dot
chunk_size
Section titled “chunk_size”Files will be uploaded in chunks this size.
Note that these chunks are buffered in memory so increasing them will increase memory use.
Type: SizeSuffix · Default: 10Mi
access
Section titled “access”Files and folders will be uploaded with this access permission (default private)
Type: string · Default: private
Choices:
private: The file or folder access can be granted in a way that will allow select users to view, read or write what is absolutely essential for them.public: The file or folder can be downloaded by anyone from a web browser. The link can be shared in any way,hidden: The file or folder can be accessed has the same restrictions as Public if the user knows the URL of the file or folder link in order to access the contents
description
Section titled “description”Description of the remote.
Type: string
Limitations
Section titled “Limitations”Note that OpenDrive is case insensitive so you can’t have a file called “Hello.doc” and one called “hello.doc”.
There are quite a few characters that can’t be in OpenDrive file
names. These can’t occur on Windows platforms, but on non-Windows
platforms they are common. Rclone will map these names to and from an
identical looking unicode equivalent. For example if a file has a ?
in it will be mapped to ？ instead.
rclone about is not supported by the OpenDrive backend. Backends without
this capability cannot determine free space for an rclone mount or
use policy mfs (most free space) as a member of an rclone union
remote.
See List of backends that do not support rclone about and rclone about.