​

Receiving Files

​

Transfer Request Process

​

1. Incoming Transfer Notification

​

Request Dialog

• Sender Information: Device name and identification
• File List: All files being sent with details
• Total Size: Combined size of all files
• File Types: Icons indicating file categories
• Accept/Decline Options: Choice to accept or reject

​

Request Information Structure

{
    type: 'request',
    header: [
        {
            name: 'vacation-photo.jpg',
            size: 2048576,
            mime: 'image/jpeg'
        },
        {
            name: 'document.pdf',
            size: 1048576,
            mime: 'application/pdf'
        }
    ],
    totalSize: 3096562,
    imagesOnly: false
}

​

2. File Preview and Inspection

​

File Details

• File Names: Exact names of files being sent
• File Sizes: Individual and total file sizes
• File Types: MIME types and file extensions
• File Count: Number of files in transfer

​

Security Indicators

• File Type Warnings: Potentially dangerous file types
• Size Warnings: Unusually large files
• Sender Verification: Known vs unknown senders
• Auto-Accept Status: For paired devices

​

3. Acceptance Decision

​

Accept Transfer

• Click Accept: Begin receiving files immediately
• Choose Location: Select download destination (browser-dependent)
• Monitor Progress: Watch transfer progress in real-time
• Completion Notification: Receive success notification

​

Decline Transfer

• Click Decline: Reject the transfer request
• Optional Reason: Send decline reason to sender
• Notification: Sender receives decline notification
• Privacy: No files are downloaded

​

Auto-Accept (Paired Devices)

• Automatic Accept: Files download automatically
• Configurable: Toggle per device in settings
• Trust Management: Control which devices auto-accept
• Security: Only enable for trusted devices

​

File Reception Process

​

1. Header Reception

// From network.js lines 841-867
_respondToFileTransferRequest(accepted) {
    this.sendJSON({type: 'files-transfer-response', accepted: accepted});
    if (accepted) {
        this._requestAccepted = this._requestPending;
        this._totalBytesReceived = 0;
        this._filesReceived = [];
    }
    this._requestPending = null;
}

​

2. File Assembly

​

FileDigester Process

// From network.js lines 1718-1746
class FileDigester {
    constructor(meta, totalSize, totalBytesReceived, callback) {
        this._buffer = [];
        this._bytesReceived = 0;
        this._size = meta.size;
        this._name = meta.name;
        this._mime = meta.mime;
        this._totalSize = totalSize;
        this._totalBytesReceived = totalBytesReceived;
        this._callback = callback;
    }

    unchunk(chunk) {
        this._buffer.push(chunk);
        this._bytesReceived += chunk.byteLength || chunk.size;
        this.progress = (this._totalBytesReceived + this._bytesReceived) / this._totalSize;
        if (isNaN(this.progress)) this.progress = 1;

        if (this._bytesReceived < this._size) return;
        
        const blob = new Blob(this._buffer);
        this._buffer = null;
        this._callback(new File([blob], this._name, {
            type: this._mime || "application/octet-stream",
            lastModified: new Date().getTime()
        }));
    }
}

​

3. Progress Monitoring

​

Progress Information

• Percentage: 0-100% completion
• Transfer Speed: Current download rate
• Time Remaining: Estimated completion time
• File Progress: Individual file progress for multiple files

​

Progress Events

// Progress tracking during reception
_onProgress(progress) {
    Events.fire('file-progress', {
        progress: progress,
        peerId: this._peerId
    });
}

​

File Management

​

1. Download Location

​

Default Behavior

• Downloads Folder: Most browsers use default Downloads folder
• Browser-Specific: Each browser has its own download location
• User Configurable: Can be changed in browser settings
• Prompt Option: Some browsers prompt for location

​

File Naming

• Original Names: Preserves original file names
• Conflict Resolution: Adds suffix for duplicate names
• Special Characters: Handles special characters appropriately
• Extension Preservation: Maintains file extensions

​

2. File Organization

​

Automatic Organization

• Date Stamping: Some browsers add timestamps
• Sender Identification: Files may include sender info
• Type Grouping: Consider organizing by file type
• Project Folders: Create folders for different projects

​

Manual Organization

• Review Files: Check all received files
• Move to Folders: Organize into appropriate directories
• Delete Duplicates: Remove unnecessary copies
• Backup Important: Backup critical files

​

Advanced Receiving Features

​

Multiple Simultaneous Transfers

​

Concurrent Transfers

• Multiple Senders: Accept transfers from different devices
• Independent Progress: Each transfer tracked separately
• Bandwidth Sharing: Transfer speed shared among transfers
• Queue Management: Transfers queue automatically

​

Transfer Management

• Pause/Resume: Pause individual transfers if supported
• Priority Setting: Prioritize important transfers
• Cancel Options: Cancel unwanted transfers
• Retry Failed: Automatic retry for failed transfers

​

Preview and Quick Actions

​

Image Previews

• Thumbnails: Small preview images
• Basic Info: Resolution and file size
• Format Support: JPEG, PNG, GIF, WebP
• Quick Actions: Save, share, or delete

​

Document Previews

• Text Files: Basic text preview
• PDF Info: Document metadata
• File Properties: Size, creation date, type
• Security Scan: Basic security information

​

Security and Privacy

​

Transfer Security

​

File Validation

// File integrity verification
_onFileTransferCompleted() {
    const fileBlob = this._filesReceived[0];
    this._totalBytesReceived += fileBlob.size;
    this._completeTransfer('receive', true);

    this.sendJSON({type: 'file-transfer-complete'});

    const sameSize = fileBlob.size === acceptedHeader.size;
    const sameName = fileBlob.name === acceptedHeader.name;
    Events.fire('file-received', { 
        file: fileBlob, 
        peerId: this._peerId,
        imagesOnly: request.imagesOnly,
        sameSize, 
        sameName 
    });
}

​

Security Checks

• Size Verification: Confirm actual size matches declared size
• Name Verification: Ensure file name matches expected
• Type Verification: Validate MIME type consistency
• Integrity Check: Verify file integrity

​

Privacy Protection

​

Anonymous Reception

• No Registration: No account required
• No Tracking: Transfer not logged permanently
• Local Processing: All processing on your device
• Temporary Data: Minimal data stored temporarily

​

Safe Practices

• Trusted Senders: Only accept from known sources
• Scan Files: Use antivirus software on received files
• Sandbox Opening: Open suspicious files in sandbox
• Regular Cleanup: Remove unnecessary downloaded files

​

Browser-Specific Behavior

​

Desktop Browsers

​

Chrome/Edge

• Downloads Folder: Files go to Downloads folder
• Download Bar: Shows download progress at bottom
• Right-Click Options: Context menu for file actions
• History: Download history available

​

Firefox

• Downloads Panel: Separate downloads panel
• Custom Location: Can set custom download folder
• Privacy Mode: Enhanced privacy in private browsing
• Add-ons: Extended functionality with add-ons

​

Safari

• Downloads Folder: Uses default Downloads folder
• Smart Download: Organizes by file type sometimes
• Privacy Features: Enhanced tracking protection
• iCloud Integration: May sync with iCloud

​

Mobile Browsers

​

Mobile Chrome

• Download Notification: Shows download in notifications
• Download Folder: Files go to device Downloads
• File Manager: Access through file manager app
• Share Options: Can share received files immediately

​

Mobile Safari

• Files App: Downloads go to Files app
• iCloud Drive: May sync with iCloud Drive
• Privacy: Enhanced privacy features
• Storage Management: Storage space management

​

Troubleshooting Receiving Issues

​

Common Problems

​

Transfer Not Starting

• Transfer request not received
• Network connectivity issues
• Browser blocking downloads
• Insufficient storage space

• Check network connection
• Verify browser download settings
• Clear browser cache
• Check available storage

​

Slow Transfer Speeds

• Poor network quality
• Network congestion
• Browser performance issues
• Large file sizes

• Improve network connection
• Close other applications
• Try different browser
• Transfer during off-peak hours

​

File Corruption

• Network interruptions
• Browser crashes during transfer
• Storage issues
• Transfer conflicts

• Re-request transfer
• Check storage health
• Use stable network
• Verify file integrity

​

Download Location Issues

• Browser download settings
• Permission issues
• Storage full
• Folder access problems

• Check browser settings
• Verify folder permissions
• Free up storage space
• Choose different location

​

Performance Optimization

​

Improve Reception Speed

• Wired Connection: Use Ethernet when possible
• 5GHz WiFi: Faster and less interference
• Close Applications: Free system resources
• Update Browser: Latest versions perform better

​

Storage Management

• Regular Cleanup: Remove unnecessary files
• External Storage: Use external drives for large files
• Cloud Backup: Backup important received files
• Monitoring: Monitor storage space usage

​

Best Practices

​

Security Best Practices

• Verify Senders: Only accept from trusted sources
• Scan Files: Use antivirus software
• Preview First: Preview files before opening
• Backup Important: Backup critical received files

​

Organization Best Practices

• Immediate Organization: Organize files as received
• Consistent Naming: Use consistent file naming
• Folder Structure: Maintain logical folder structure
• Regular Cleanup: Remove unnecessary files

​

Transfer Best Practices

• Stable Connection: Ensure reliable network
• Sufficient Storage: Check available space
• Browser Updates: Keep browser current
• Patience: Allow time for large transfers