Download and Installation

Download

OS	System Requirements	Download Address
Windows	Windows 7 32/64-bit or above, Windows Server 2008 R2 64-bit or above	Windows
macOS	macOS 10.13 or above	macOS
Linux	Includes GUI which supports AppImage format	Linux

Installation

The COSBrowser installation package is an executable application. After downloading it, double-click it and then install as prompted by the system.

Login

You can log in to COSBrowser Desktop Edition using your TencentCloud API key, which can be obtained on the API Key Management page in the CAM Console. After successful login, the key will be saved in Historical Keys for future use. The login page is as shown below:

You cannot log in to COSBrowser using a project key.

Basic Features

1. Creating/Deleting bucket

Feature	Description	Directions
Create Bucket	You can create a bucket directly in your client	1. In the bucket list, click Add Bucket in the upper left corner 2. Enter the bucket name correctly, and select your region and access permissions 3. Click OK
Delete Bucket	Before deleting a bucket, make sure that all the data in the bucket has been cleared	1. In the bucket list, click Delete to the right of the bucket you have chosen 2. Click OK

2. Viewing bucket details

You can view bucket details by clicking Details to the right of the bucket list. Such details include bucket name, access permissions, and versioning.

In the bucket details, you can change bucket access permissions and enable/disable versioning.

3. Adding access path

If you log in with a sub-account that does not have permission to access the bucket list, you can initiate an access by Add Access Path, for which COSBrowser provides two methods as follows:
(1) Add an access path directly in the login page, and select your bucket region correctly. Once you log in, you can manage your resources immediately.

(2) After you log in with your sub account, in the upper left corner of the bucket list page, click Add Path, and enter a specified path so that you can enter a bucket and manage its resources.

4. Uploading file/folder

Upload Feature	Remarks	Directions
Uploading file	COSBrowser allows you to upload a single file or multiple files in batches in different ways	You can upload a file in the following ways. In the specified bucket or path: 1. Click **Upload Files** to upload files directly. 2. Right-click in the blank space of the file list and select **Upload Files** to upload files. 3. Drag a file to the file list pane to upload it.
Uploading folder and the contained files	If a file or folder with the same name as the one to be uploaded already exists in the bucket or path, it will be overwritten by default	You can upload a folder in the following ways. In the specified bucket or path: 1. Click **Upload Folder** to upload a folder directly. 2. Right-click in the blank space of the file list and select **Upload Folder** to upload a folder. 3. Drag a folder to the file list pane to upload it.
Incremental upload	Incremental upload refers to the process of comparing the file to be uploaded with existing objects in the bucket before uploading it and skipping it if an object with the same name already exists in the bucket	To use incremental upload, follows these 2 steps: In a bucket or path you specify: 1. Upload as you do with a folder, and click **Next**. 2.In **Store Mode**, Select **Skip**, and click **Upload** to begin incremental upload.

5. Downloading file/folder

Download Feature	Remarks	Directions
Downloading file	COSBrowser allows you to download a single file or multiple files in batches in different ways	You can download a file in the following ways: 1. Select the file to be downloaded and click **Download** in the UI to download it. 2. Right-click a file and select **Download**. 3. Drag a file to the local file system to download it.
Downloading folder and the contained files	If a file or folder with the same name as the one to be downloaded already exists in the local file system, the one to be downloaded will be renamed by default	You can download a folder and files in it in the following ways: 1. Select the folder to be downloaded and click **Download** in the UI to download it. 2. Right-click a folder and select **Download** to download it directly. 3. Drag a folder to the local file system to download it.
Incremental download	Incremental download refers to the process of comparing the object to be downloaded with local files before downloading it and skipping it if an object with the same name already exists	You can perform an incremental download by following the steps below: 1. Select the file/folder to be downloaded and move the cursor to **Download** and a drop-down list will appear. 2. Click **Advanced Download** in the drop-down list and select **Skip** in the pop-up window. 3. Then, click **Download Now** to incrementally download new files/folders.

6. Deleting file/folder

To delete a file/folder, select the file/folder to be deleted and click Delete in More at the top of the UI, or right-click it and select Delete. You can delete multiple files/folders in batches.

7. Synchronizing file

Using file synchronization feature, you can upload the specified files in your local folders to a bucket in real time. Detailed directions are as follows:

(1) Click Sync at the top right of the UI.
(2) Specify a local folder and bucket directory in the pop-up.
(3) Click Start Sync to enable file synchronization.
(4) View synchronization history logs in Sync Logs tab.

• Synchronization means that when the file is uploaded, the system automatically recognizes whether the same file exists in the bucket. Only the files that do not exist in the bucket are uploaded by the synchronization feature.
• Only supports synchronizing local files to bucket currently. Reverse operation is not supported.
• Supports for both manual and automatic synchronization.

8. Copying and pasting file

To copy a file/folder, select the file/folder to be copied in the specified bucket or path and click Copy in More at the top of the UI, or right-click it and select Copy. After the file/folder is successfully copied, you can paste it to another bucket or path. You can copy and paste multiple files/folders in batches.

If a file/folder with the same name as the one to be pasted already exists in the destination path, it will be overwritten by default.

9. Renaming file

Select a file you want to rename, right-click and select Rename, or click Rename in More Actions to the right of the file. Then enter your file name, and click OK.

Folders cannot be renamed.

10. Creating folder

To create a folder in the specified bucket or path, click Create Folder in the UI, or right-click in the UI and select Create Folder, enter the folder name, and click OK.

• The folder name can contain up to 255 digits, letters, and visible characters.
• The folder name cannot contain special characters such as \ / : * ? " | < >.
• .. cannot be used as the folder name.
• The folder cannot be renamed, so name it with caution.

11. Viewing file details

To view the details of a file, click its filename or right-click it and select Details. File details include file name, file size, modification time, access permission, storage class, ETag, headers, object address, and option to create a temporary link.

12. Generating file link

Each file stored in COS can be accessed through a specific link. If a file is private-read, you can request a temporary signature to generate a temporary access link with a certain validity period.

COSBrowser allows you to generate a file link in the following ways:

• In the list view, click the Share icon to the right of the file to generate a link and copy it. If the file is public-read, the link will not carry a signature and be valid permanently. If the file is private-read, the link will carry a signature and be valid for 2 hours.
• Right-click a file and select Copy Link to generate a link and copy it. If the file is public-read, the link will not carry a signature and be valid permanently. If the file is private-read, the link will carry a signature and be valid for 2 hours.
• In File Details, click Create a temporary link and set its validity period.

13. Previewing file

COSBrowser allows you to preview media files, including images, videos, and audio. To preview a media file, double-click it or right-click it and select Preview or Playback in the context menu. On the file preview or playback screen, you can click:

• Copy Link to generate a file access link and copy it.
• Download to download the file to the local file system. If a file with the same name already exists in the local file system, it will be overwritten by default.
• View on Mobile to generate a QR code for the file, which can be scanned on a mobile phone for direct view.

• Preview is available for images in most formats, .mp4 and .webm videos, and .mp3. and .wav audios.
• File preview will incur downstream traffic. Please use it with caution.

14. Searching for file

To search for a file, enter the filename in the search box at the top right of the bucket. COSBrowser supports prefix search and fuzzy search.

15. Searching for bucket

To quickly locate a bucket, enter the bucket name in the search box above the bucket list on the left.

16. Viewing multiple file versions

After versioning is enabled for your bucket, you can view the historical versions of a file by right-clicking in the blank space of the file list and select View multiple versions in the context menu.

Settings

System Feature	Remarks	Directions
Setting up proxy	COSBrowser uses the system-configured proxy to connect to the internet. Please make sure that your proxy is set up properly or disable the proxy configuration if it fails to connect to the internet	1. Select **Settings** > **Proxy**. 2. Set up a proxy to connect to the internet.
Setting the number of concurrent transfers	COSBrowser supports uploading/downloading multiple files in batches	1. Select **Settings** > **Download/Upload**. 2. Set the number of concurrent transfers, which is 5 by default
Setting the number of parts to be transferred	COSBrowser supports uploading/downloading a file in multiple parts. When the file to be transferred exceeds a certain size, multipart transfer will be performed by default	1. Select **Setting** > **Download/Upload**. 2. Set the number of concurrent parts to be transferred, which is 5 by default.
Setting the number of retries upon transfer failure	COSBrowser will retry failing tasks by default when transferring files	1. Select **Settings** > **Download/Upload**. 2. Set the number of retries upon transfer failure, which is 5 by default.
Setting upload check	COSBrowser supports checking files online after upload to verify whether their size and status are correct	1. Select **Settings** > **Upload**. 2. Select "Upload Check".
Setting MD5 checksum calculation during upload	COSBrowser supports calculating MD5 checksum during file upload and adding it to the file metadata as the `x-cos-meta-md5` custom header. Next time when the file is requested, the header will be returned for file check	1. Select **Settings** > **Upload**. 2. Select "Calculate meta-md5 Header".
Viewing local log	COSBrowser will record all the performed operations in the `cosbrowser.log` local file	1. Select **Settings** > **About**. 2. Click **Local Log** and the system will open the directory where the local log is stored.