|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|
The COSBrowser installation package is an executable application. After downloading it, double-click it and then install as prompted by the system.
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.
|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
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.
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.
|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.
|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.
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.
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.
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.
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.
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.
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.
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:
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:
- 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.
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.
To quickly locate a bucket, enter the bucket name in the search box above the bucket list on the left.
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.
|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.