# File Management Pages

Using these pages you can view and manage the files of your allocations.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FIGFMQVYoaH83G9n26WZz%2Fimage.png?alt=media&#x26;token=bc62309d-1138-4c8b-b7d5-4abd505db48b" alt=""><figcaption><p>Fig1: File Management Pages</p></figcaption></figure>

Those pages are:

| Page          | Description                                                                                                           |
| ------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Home Page** | Here you can view all your files/folders.                                                                             |
| **Recents**   | Here you can view and manage the files that you accessed recently.                                                    |
| **Favorites** | Here you can view and manage the files that you stated as favorite.                                                   |
| **Encrypted** | Here you can view and manage the encrypted files.                                                                     |
| **Shared**    | Here you can view and manage the files that you shared, both publicly and privately.                                  |
| **Offline**   | Here you can view and manage the files that you made available offline, even if you're not connected to the internet. |

### Page Components

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FusdwzMcRy8nOQcXx8R1s%2Fimage.png?alt=media&#x26;token=9af9ace7-eedd-4d84-bcd1-d7777062af44" alt=""><figcaption><p>Fig1: Page Components</p></figcaption></figure>

#### Files Viewer

This is the main part of the page, where you can see your files listed. You also have controls in the top right part, where you can use to sort the files, change their view or reload the data.

#### Search bar

Here's where you can search for your files by name.

#### Control Buttons

Here where you can upload file(s), upload a whole folder or create a new folder.

#### Multiple files selection

When you click on this checkbox, you can select multiple files to perform [Operations on multiple files](#operations-on-multiple-files).

#### File Operations Menu

This menu shows up when you click the three dots just beneath the file size. It carries controls which you can use to perform operations on this file.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FmStfP6WrVEQolKnzbIVY%2Fimage.png?alt=media&#x26;token=296e83c5-9927-407a-9ca6-cad5b1133ce0" alt=""><figcaption><p>Fig2: File Operations Menu</p></figcaption></figure>

<table><thead><tr><th width="217">Control</th><th>Description</th></tr></thead><tbody><tr><td>View</td><td>Opens the <a href="#file-content-viewer">File Content Viewer</a> of this file.</td></tr><tr><td>Share</td><td><a href="#share-a-file">Share a file</a>.</td></tr><tr><td>Download File</td><td><a href="#download-a-file">Download a file</a>.</td></tr><tr><td>Favorites</td><td>Add the file to the favorites list.</td></tr><tr><td>Copy</td><td><a href="#copy-a-file">Copy the file</a>.</td></tr><tr><td>Move</td><td><a href="#move-a-file">Move the file</a>.</td></tr><tr><td>Rename</td><td><a href="#rename-a-file">Rename the file</a>.</td></tr><tr><td>Make available offline</td><td>Dowload the file to be accessible offline in the current device.</td></tr><tr><td>File Details</td><td>Opens the <a href="#file-details-viewer">File Details Viewer</a></td></tr><tr><td>Delete</td><td>Deletes the file</td></tr></tbody></table>

#### File Content Viewer

> Todo: add an image

Here you can view the contents of the file, if it's format is supported by the viewer. Most docuement, image and video formats are supported by the viewer. You can also use the viewer to navigate between the files in the current directory.

#### File Details Viewer

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FSt9ol45fuWUsM97chjRm%2Fimage.png?alt=media&#x26;token=69ad8bb5-3939-46e1-8b35-3d448f4fb523" alt=""><figcaption><p>Fig3: File Details Viewer</p></figcaption></figure>

Here you can view details about the file, which are:

<table><thead><tr><th width="165">Details Key</th><th>Description</th></tr></thead><tbody><tr><td>Size</td><td>Size of the file</td></tr><tr><td>Encrypted</td><td>Whether the file is encrypted or not.</td></tr><tr><td>Created</td><td>Date when your file was created/uploaded.</td></tr><tr><td>Modified</td><td>Date when your file was last modified.</td></tr><tr><td>Last Opened</td><td>Date when your file was last opened.</td></tr><tr><td>Path</td><td>Absolute Path  to your file on the allocation, starting from the root level (/).</td></tr><tr><td>File Name</td><td>Name of the file, including the extension/format.</td></tr><tr><td>Hash</td><td>A hash of the contents of the file used in the algorithms behind storage on Züs system, with a copy icon to copy it.</td></tr><tr><td>Allocation ID</td><td>The identifier of your allocation, within which this file resides, with a copy icon to copy it.</td></tr><tr><td>Blobber Details</td><td>This shows a list of the blobbers who actually store the file, including their url (which, if clicked, takes you to the blobber's details page on Atlus)</td></tr></tbody></table>

#### Recents View

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FmJcCBYshH15MJWzLYmoB%2Fimage.png?alt=media&#x26;token=3882fef7-9f9e-42c4-9355-0de303cd602c" alt=""><figcaption><p>Fig4: Recents view</p></figcaption></figure>

You can open this page by clicking the "Recents" button in the navigation menu to the right of the files viewer. This shows the files that you recently accessed.

#### Favourites View

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FzyYaD9gv08YIv4653wgR%2Fimage.png?alt=media&#x26;token=4f147853-16a9-41c4-8a2e-b6b2c639637e" alt=""><figcaption><p>Fig5: Favorites View</p></figcaption></figure>

You can open this page by clicking the "Favorites" button in the navigation menu to the right of the files viewer. This shows the files that you marked as favorite from either the star icon within the file card or from the [File Operations Menu](#file-operations-menu).

#### Encrypted View

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F2wDwbG2lId1tckOx2H8C%2Fimage.png?alt=media&#x26;token=cd4a9359-6ec5-4c2c-bf03-c2231fbdcc37" alt=""><figcaption><p>Fig6: Encrypted view</p></figcaption></figure>

You can open this page by clicking the "Encrypted" button in the navigation menu to the right of the files viewer. This shows the files that you made encrypted by either stating that while uploading them or placing then inside the "Encrypted" folder. This viewer can also be accessed when you open the Encrypted folder.

#### Shared View

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FAcCB09hDusDxeOFuJ1Ap%2FFeb-11-2024%2021-43-05.gif?alt=media&#x26;token=2e900c11-d648-45de-bb98-4562eeca017c" alt=""><figcaption><p>FIg7: Shared view</p></figcaption></figure>

You can open this page by clicking the "Shared" button in the navigation menu to the right of the files viewer. This shows information about shared files, organized in tabs.

<table><thead><tr><th width="172">Tab</th><th>Description</th></tr></thead><tbody><tr><td>Shared with me</td><td>Files shared privately by other users with you.</td></tr><tr><td>Shared by me</td><td>Files shared privately by you with other users.</td></tr><tr><td>Publicly Shared</td><td>Files shared by other users publicly that you opened.</td></tr></tbody></table>

#### Offline View

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F5GMzRRpwpfeUEPncuq3H%2Fimage.png?alt=media&#x26;token=ce2aa1d8-ba28-487a-aa31-09f4ef33e84f" alt=""><figcaption><p>Fig8: Offline View</p></figcaption></figure>

You can open this page by clicking the "Offline" button in the navigation menu to the right of the files viewer. This shows the files that you made available offline from the [File Operations menu](#file-operations-menu).

### Interactions

Here we describe how you can use the components of this page to perform needed operations on your files.

#### Create a new folder

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2Fj4QZpCFWABYX5HDZqicW%2Fimage.png?alt=media&#x26;token=ea824386-4b8a-4034-bd5f-fe950c7f6c17" alt=""><figcaption><p>Fig9: Create a new folder</p></figcaption></figure>

You can create a file by either clicking on the "New Folder" button in the Files Viewer, or the "Create Folder" button in the Controls section.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F52ZqJQrBcNiQyuxYlvvh%2Fimage.png?alt=media&#x26;token=40341543-ff80-4444-b4a4-78889d0c122b" alt=""><figcaption><p>Fig10: New folder window</p></figcaption></figure>

Then you should specify a name to your folder, then click "Create" to save the file.

#### Upload file(s)

You can upload a file by either:

* Clicking on "Upload File(s)" button in the controls section
* Draging and dropping files

Then you'll need to specify the folder you need to place your files in, or don't specify if you want it to be in the current folder. If you chosen the "Encrypted" folder, your files will automatically be encrypted.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FtVKboRPlk8oAkisvCGcS%2Fimage.png?alt=media&#x26;token=f944409c-6c5f-4996-883c-6c66d391d520" alt=""><figcaption><p>Fig11: Upload window</p></figcaption></figure>

While your file is getting uploaded, you can check its progress in the Upload Manager.

#### Upload a whole folder

You can use the "Upload folder" button to upload a whole folder. It will view the same popup window as when you upload files. After you upload it, the file will be created and opened for you where you can see its contents being uploaded.

While your files are getting uploaded, you can check its progress in the Upload Manager.

#### Rename a file

You can rename using the "Rename" control in the [File Operations Menu](#file-operations-menu). You'll then need to specify a name in the popup window.

> Note: When you change the name of the file, it becomes automatically "unshared" both publicly and privately.

#### Move a file

You can move a file to a different location using the "Move" control from the [File Operation Menu](#file-operations-menu).&#x20;

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2Fubal2sgFhlmdrL5FzOID%2Fimage.png?alt=media&#x26;token=5392b84c-a2f5-491b-be60-76291e6347c2" alt=""><figcaption><p>Fig13: Move a file</p></figcaption></figure>

You'll then need to either choose an existing folder or create a new one to move your file to.

#### Copy files/folders

You can create a copy of your file using the Copy control from the [File Operations Menu](#file-operations-menu). You'll need to specify where you need to place your copy, it cannot be placed in the same folder as the actual file.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FnGny8CyI1W26r4lcUrtu%2Fimage.png?alt=media&#x26;token=aedaa5f0-7821-447e-a23c-8bc070786fe2" alt=""><figcaption><p>Fig14: Copy Files/Folders</p></figcaption></figure>

#### Share a file

Sharing is how you can enable other people to view your files and download them. You can share the file using the "Share" control from the [File Operations Menu](#file-operations-menu). There are two types of sharing:

* **Public Sharing:** When you share any unencrypted file, it will be publicly available for anybody with the link to view it, even if the viewer doesn't have an account in Züs at all. In this case, after you click "Share", you'll be shown this window.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2F9uHMxGfxnbTJOQ9K4eBi%2Fimage.png?alt=media&#x26;token=5bb137f8-99b4-4b46-97a4-7db304c2d03d" alt=""><figcaption><p>Fig15: File Sharing - Public</p></figcaption></figure>

Here you can see some controls to share the generated link, as well as the AuthTicket. AuthTicket is like a ticket that will be given to anybody with the link to be able to access your file. For more on this, check the [File Sharing](https://docs.zus.network/zus-docs/system-overview/storage/file-operations/file-sharing) page.

* **Private Sharing:** When you share an encrypted file you should specify the account(s) you need to share it with. In this case, after you click "Share", you'll be shown this window.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FnkeTnzbczjOZ0VBTY859%2Fimage.png?alt=media&#x26;token=c7f2839c-7bfc-43d2-bcbe-652b6404d1ae" alt=""><figcaption><p>Fig16: File Sharing - Private 1</p></figcaption></figure>

Here you should specify the username of the user(s) of the Züs System you want to share your file with, and then click add.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FF3xucXKHIJer8353Tjd5%2Fimage.png?alt=media&#x26;token=fc3a4edf-e145-47de-9d8a-4350304178b4" alt=""><figcaption><p>Fig17: File Sharing - Private 2</p></figcaption></figure>

After adding the user, you'll be able to see it in the list of users who have access. You can also revoke their access using the remove button to the right of the user. If you want to revoke access for everybody, you can use the "Revoke Sharing" button just beneath the name field.

#### Download a file

You can download a file using the "Download" control from the [File Operations Menu](#file-operations-menu).&#x20;

#### Delete a file

You can delete a file using the "Delete" control from the [File Operations Menu](#file-operations-menu).

> Note: Deleted files becomes unshared.

#### Operations on multiple files

You can copy/move/delete multiple files by selecting those files, either by highlighting them using your mouse, or using the [Multiple file selection](#multiple-files-selection) tool.

<figure><img src="https://2414485336-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUGN3Vu2Hi1voQQLrIVGO%2Fuploads%2FYa4rQfPb0OMG9bFZzcs9%2Fimage.png?alt=media&#x26;token=63a9dbe6-8042-4e93-b6c1-8d2a31d73e0a" alt=""><figcaption><p>Fig18: Highlight multiple files</p></figcaption></figure>

The available controls are:

* Move
* Delete
* Download
* Make favorite
* Copy
* Make available offline