CS Browser Options

General Options

The General tab allows you to configure various settings for CS Browser, including software updates, file transfer settings, and permissions.

General

Automatically check for software updates - If this option is enabled, CS Browser will automatically check for software updates on startup. If a new version is available, you will be prompted to download and install it.

Click here to learn more about the data sent during the new version check.

File transfer settings

Enable multipart uploads with part size (in megabytes) - If this option is enabled, large files will be uploaded using multiple parallel threads for faster performance. You can specify the part size in megabytes. The default value is 8 MB.

Enable multipart downloads with part size (in megabytes) - If this option is enabled, large files will be downloaded using multiple parallel threads for faster performance. You can specify the part size in megabytes. The default value is 100 MB.

Overwrite options for existing files

Overwrite options for existing files - This setting allows you to configure how CS Browser handles files with the same name that already exist in the destination. You can choose from the following options:

• Show confirmation dialog - Prompts you to confirm the action for each file when a file with the same name already exists in the destination.
• Overwrite (replace the file in the destination) - Replaces the existing file in the destination with the file being transferred.
• Skip (do not overwrite, keep existing file) - Leaves the existing file unchanged and skips transferring the file.
• Rename (keep both files, rename the new file automatically) - Saves the file with a unique name in the destination to avoid overwriting the existing file.

Permissions

The options in this section may require additional configuration for buckets created after April 2023 to work correctly. Click here for more information.

Inherit permissions from parent bucket - If this option is enabled, files uploaded will inherit the permissions (ACL) of the parent bucket.

Preserve permissions when overwriting existing files - If this option is enabled, CS Browser will maintain the permissions of the existing files during uploading or copy/move operations.

When this option is enabled, an extra request is sent to Amazon S3 for each file to retrieve the existing file's permissions before overwriting it. This may increase the number of requests sent to Amazon S3 when uploading or copying large numbers of files.

Proxy

The Proxy tab allows you to configure proxy server settings to connect to Amazon S3. This is useful if your network requires a proxy server for internet access.

Proxy

Select the proxy connection type from the dropdown menu. Options include:

• Do not use proxy (direct connection) - CS Browser will connect to Amazon S3 directly without using a proxy server.
• Autodetect proxy settings - CS Browser will automatically detect and use the proxy settings configured on your system.
• Use proxy settings below - Allows you to specify custom proxy server settings manually.

Address - Enter the IP address or hostname of the proxy server.

Port - Enter the port number used by the proxy server. The default value is 8080.

My proxy server requires authentication - Check this option if your proxy server requires a username and password for authentication.

Username - Enter the username required for proxy server authentication.

Password - Enter the password required for proxy server authentication.

Domain - Enter the domain name if required for proxy server authentication. This field is optional.

Bandwidth Throttling

The Bandwidth Throttling tab allows you to limit the transfer rate for uploads and downloads. This feature can help prevent CS Browser from consuming all available bandwidth, ensuring other applications or services on your network remain functional.

Bandwidth Throttling

Enable bandwidth throttling with max transfer rate per thread (KB/s) - Check this option to enable bandwidth throttling. You can specify the maximum transfer rate (in kilobytes per second) for each active thread.

Total bandwidth usage depends on the number of active threads. For example, if you set the maximum transfer rate to 32 KB/s and have 4 active threads, the total bandwidth usage will be approximately 128 KB/s.

Data Integrity

The Data Integrity tab allows you to enable checks to ensure data is not corrupted during uploads or downloads. This helps maintain the integrity of your files when transferring them to or from Amazon S3.

Data Integrity

Check data integrity during file upload - Enable this option to ensure data is not corrupted during upload. This may increase upload time. The file checksum will also be stored in the metadata for integrity verification during download.

Checksum algorithm - Select the checksum algorithm used for data integrity verification. Supported algorithms include CRC32, CRC32C, CRC64/NVME, SHA-1, and SHA-256.

Note that many Amazon S3 compatible storage providers may only support SHA-256. Using other algorithms such as CRC-32, CRC-32C, or SHA-1 may not be supported or may cause upload/download failures if the storage does not recognize them.

Check data integrity during file download - Enable this option to ensure data is not corrupted during download. This may increase download time.

Data Integrity Check Mode for Downloaded Files

Choose how to handle downloaded files with missing or invalid checksums:

• Flexible - Treat files with missing or invalid checksums as valid.
• Strict - Treat files with missing or invalid checksums as corrupted.

Click here to learn more about data integrity checking.

Queueing

The Queueing tab allows you to configure the maximum number of concurrent tasks for uploads, downloads, and other operations. These settings help optimize resource usage and performance during file transfers.

Queueing

Maximum number of concurrent uploads - Set the maximum number of uploading tasks that can run simultaneously. The default value is 8.

Maximum number of concurrent downloads - Set the maximum number of downloading tasks that can run simultaneously. The default value is 8.

Maximum number of other concurrent tasks - Set the maximum number of other tasks, such as file deletions, permission changes, and similar operations, that can run simultaneously. The default value is 8.

The Free version of CS Browser allows up to two concurrent uploads or downloads, which may limit your ability to fully utilize your network speed. Upgrading to the Pro version unlocks unlimited concurrent transfers, enabling faster and more efficient file uploads and downloads. Upgrade to Pro today to experience the full potential of your broadband connection!

Interface

The Interface tab allows you to configure system tray behavior, performance optimization settings, and the application color theme.

System Tray

Always show CS Browser icon in system tray - Check this option to keep the CS Browser icon visible in the system tray at all times.

Minimize to system tray - Check this option to hide CS Browser to the system tray when minimized.

Performance Optimization

Enable bucket pagination with page size - Check this option to paginate bucket listings based on the specified page size. The default value is 1000.

Limit items in version listings to - Check this option to limit the number of items in version listings to the specified value. This is useful for managing or deleting large quantities of file versions efficiently. The default value is 10,000.

Limit the max file size for Preview (MB) - Check this option to set a maximum file size limit (in megabytes) for downloading files for preview. The default value is 100 MB.

Color Theme

Choose the color theme for the application:

• Light - Use the light theme.
• Dark - Use the dark theme.
• System - Automatically match the system theme.

Changing the theme requires restarting the application to take effect.

Logging and Error Handling

The Logging and Error Handling tab allows you to configure how logs are recorded and how failed tasks are retried in CS Browser.

Logging

Save event log to file - Check this option to save all log messages to a log file. You can view log files by clicking the view log files link.

Remove log files older than (days) - Check this option to automatically delete log files older than the specified number of days. The default value is 30 days.

Verbosity level - Choose the detail level of log entries:

• Verbose - Detailed log entries.
• Brief - Summarized log entries.
• Errors and Warnings Only - Logs only errors and warnings.

Error Handling

Maximum retry attempts for failed tasks - Specify how many times a task should be retried after a failure. The default value is 3.

Delay (in seconds) between retry attempts - Specify the wait time (in seconds) before retrying a failed task. The default value is 1 second.

Advanced

The Advanced tab allows you to configure advanced settings for file system behavior, security, and power management.

File System

Folder for temporary files - Specify the folder to store temporary files during compression or encryption.

Check for free drive space before downloading a file - If enabled, CS Browser will check for free drive space before downloading a file.

Allow parallel disk access for hashing and encryption - Enable this option only for SSDs. It is not recommended for HDDs or network drives.

Security

Bypass SSL/TLS validation (program restart required) - Disable certificate validation to ignore validation errors and trust all certificates.

Power Options

Prevent computer sleep if there are any active tasks - Prevent the computer from going to sleep if there are active tasks in CS Browser.

Prevent display off if there are any active tasks - Prevent the display from turning off if there are active tasks in CS Browser.