diff --git a/docs/desktop/accessing-vaults.md b/docs/desktop/accessing-vaults.md index 70c5968..f8ca173 100644 --- a/docs/desktop/accessing-vaults.md +++ b/docs/desktop/accessing-vaults.md @@ -58,20 +58,7 @@ On Windows, you can choose the drive letter of the virtual drive for each vault ## Locate Encrypted File {#locate-encrypted-file} -The Locate Encrypted File feature helps users find the encrypted version of a specific file. This feature is particularly useful when vault files are versioned and the user wants to restore an older version of a file. As Cryptomator encrypts filenames and obfuscates directory structures, users first locate the encrypted file and then restore an older version of the encrypted file with the third party app. - -1. Unlock the desired vault. -2. Click on the `Locate Encrypted File` button. -3. Select the file within the vault. - -As an alternative for clicking the button, you can directly drag & drop a file onto the button. - -A file manager window opens showing the encrypted folder and marking the encrypted file. - - +See [Locate Encrypted File](/docs/desktop/encrypted-file-names.md#locate-encrypted-file) in the Encrypted File Names section. ## File System Case Sensitivity {#file-system-case-sensitivity} diff --git a/docs/desktop/encrypted-file-names.md b/docs/desktop/encrypted-file-names.md index 7f5408a..2edea15 100644 --- a/docs/desktop/encrypted-file-names.md +++ b/docs/desktop/encrypted-file-names.md @@ -42,28 +42,52 @@ The actual directory structure of the vault on your hard drive/cloud will look l While this increases security, it also makes it impossible to see the original file names and directory structure without decrypting them first. When you need to know the original name of a file (e.g. to restore an older version), you can use the `Decrypt File Name` feature to decrypt the file name. +Conversely, if you need to find the encrypted counterpart of a file inside the vault, use the `Locate Encrypted File` feature. -## Decrypting File Names {#decrypting-file-names} +## Locate Encrypted File {#locate-encrypted-file} + +The Locate Encrypted File feature helps you find the encrypted version of a specific file from inside the vault. This comes in handy when vault files are versioned and you want to restore an older version of a file. As Cryptomator encrypts file names and obfuscates directory structures, first locate the encrypted file and then restore an older version of the encrypted file with a third-party app. + +1. Unlock the desired vault. +2. Click on the `Locate Encrypted File` button. +3. Select the file within the vault. + +As an alternative for clicking the button, you can directly drag & drop a file onto the button. + +A file manager window opens showing the encrypted folder and marking the encrypted file. + +## Decrypt File Names {#decrypting-file-names} :::note -Due to technical reasons, given only an encrypted file Cryptomator can only decrypt its name. -It cannot compute its cleartext path. +Due to technical reasons, Cryptomator can only decrypt the name of an encrypted file if that file is provided by itself. +It cannot determine the file's cleartext path. ::: -You can access this feature from the unlocked view of a vault in the Cryptomator main window. -On the bottom of the unlocked view, drop files on the `Decrypt File Name` zone or click on it. -A modal window with the encrypted-decrypted-mapping opens. +The Decrypt File Name feature helps you resolve encrypted file names back to their original cleartext names. To map encrypted files back to their cleartext names, just drag and drop the files onto the button in the unlocked vault section of the main app. + +1. Unlock the desired vault. +2. Click on the `Decrypt File Name` zone at the bottom of the unlocked view. +3. Select the encrypted file. + +As an alternative for clicking the zone, you can directly drag & drop files onto it. Vault detail view in the unlocked state -The encrypted-decrypted-table has an action bar at the top with two buttons: -* Clipboard button to copy the whole table as a CSV into the system clipboard -* Trash button to clear the table +A modal window opens showing a two-column table with the encrypted names on the left and their decrypted, cleartext names on the right. Decrypt file names window -Encrypted file names and their corresponding decrypted, original name are shown inside a two column table, with the encrypted names on the right. -If you have not dropped any files, the table is empty. -You can click inside the empty table to select files with a file picker dialog. +The action bar at the top of the table provides two buttons: +* Clipboard button to copy the whole table as CSV into the system clipboard +* Trash button to clear the table + +Select single cells and copy their content with the OS-specific keyboard shortcut. + +## Video Walkthrough + +The following video demonstrates both features in action: first, **Locate Encrypted File** to find the encrypted counterpart of a file, and then **Decrypt File Name** to resolve an encrypted file name back to its original name. -Once the table has content, you can select single cells and copy their content with the OS specific keyboard copy shortcut. + diff --git a/static/vid/file-names.mov b/static/vid/file-names.mov new file mode 100644 index 0000000..804da37 Binary files /dev/null and b/static/vid/file-names.mov differ