Skip to content

Upload & Share

CyberGems edited this page Aug 30, 2026 · 1 revision

Upload & Share

CyberSnap supports uploading captures to 7 destinations. All upload credentials are encrypted locally with AES-GCM encryption.


Supported Providers

Provider Protocol Best For
FTP FTP/FTPS Self-hosted servers, web hosting
SFTP SSH File Transfer Secure server uploads
S3-compatible S3 API AWS S3, MinIO, Wasabi, Backblaze B2
ImgBB REST API Free image hosting
Imgur REST API Community sharing, albums
Webhook HTTP POST Custom integrations, automation
CyberSnap Share Proprietary Built-in sharing with 48h TTL

Configuring Providers

FTP

Setting Description
Server address FTP server hostname or IP
Port Server port (default: 21)
Username FTP username
Password FTP password (encrypted)
Remote directory Target folder on server
Passive mode Enable for firewall/NAT compatibility
FTPS Enable TLS/SSL encryption

SFTP

Setting Description
Server address SFTP server hostname or IP
Port Server port (default: 22)
Username SSH username
Password SSH password (encrypted)
Private key Optional SSH key authentication
Remote directory Target folder on server

S3-Compatible

Setting Description
Endpoint S3 endpoint URL
Bucket Target bucket name
Region AWS region or custom
Access key S3 access key ID
Secret key S3 secret access key (encrypted)
Path prefix Optional folder prefix
Custom domain CDN or custom domain for URLs

ImgBB

Setting Description
API key Your ImgBB API key
Expiration Auto-delete after (60s, 60m, 1d, or never)

Imgur

Setting Description
Client ID Your Imgur API client ID
Album Optional album ID

Webhook

Setting Description
Endpoint URL HTTP/HTTPS endpoint
Method POST or PUT
Headers Custom HTTP headers
Body template JSON template for request body
File field name Form field name for the image

CyberSnap Share

Setting Description
API key Your CyberSnap Share API key
Custom server Self-hosted CyberSnap Share URL

Upload Settings

General

Setting Description
Default provider Provider used for auto-share and quick upload
Image format PNG or JPEG for upload
JPEG quality Compression level for JPEG uploads (1–100)
Resize before upload Max width/height for uploaded images
Timeout Upload timeout in seconds
Retry attempts Number of retries on failure

Post-Upload Actions

Action Description
Copy URL to clipboard Automatically copy the share URL
Open in browser Open the URL in your default browser
Show notification Display a toast with the URL
Shorten URL Use URL shortener if available

Credential Security

All upload credentials are stored in an encrypted vault:

  • Encryption: AES-256-GCM
  • Storage: Local encrypted file
  • Master key: Derived from machine-specific entropy
  • No cloud sync: Credentials never leave your machine

Sharing Workflow

  1. Capture or open an image in the editor
  2. Click Share (or use auto-share)
  3. Select the provider (or use default)
  4. Upload progress shown in notification area
  5. On success:
    • URL copied to clipboard
    • Toast notification with options
    • URL added to history entry

CyberSnap Share Server

For self-hosting, CyberSnap includes a PHP-based share server:

  • TTL: 48 hours (configurable)
  • API key authentication
  • Automatic cleanup via hourly cron
  • LiteSpeed/cPanel compatible

See the CyberSnap Share README for deployment instructions.

Clone this wiki locally