This guide will help you get up and running with File Mover Express quickly.
Before starting, ensure you have completed:
- Installation — Download and install File Mover Express
- IAM Permissions — AWS credentials and S3 access
- Configuration — Add a Remote Configuration for your S3 bucket
Using single sign-on? Instead of an AWS named profile or access keys, you can authenticate a Remote Configuration with your organization's identity provider. See OIDC / SSO Authentication to set it up.
GUI Mode:
Open File Mover Express from your Applications folder (macOS), Start Menu (Windows), or wherever you installed it.
If you built from source, you can also launch it from the dist/ folder or run the daemon directly:
filemoverexpress daemonThe GUI will be accessible at http://localhost:4200 when running ng serve from the src/gui folder. See Development for details.
CLI Mode:
filemoverexpress daemon- Open File Mover Express
- Check that your remote configuration shows a green checkmark (connected status)
- If not connected, verify your configuration settings
filemoverexpress validate-credentials [remote-configuration-name]- Select source files: In the Local file browser (left side), navigate to and select files/folders
- Choose destination: In the S3 Bucket file browser (right side), select your remote configuration
- Start transfer: Drag and drop files from left to right
- Monitor progress: View transfer status in the Jobs tab
filemoverexpress upload [remote-configuration] [local-path]Example:
filemoverexpress upload my-config ./my-video-files/- Select source files: In the S3 Bucket file browser (right side), select files/folders
- Choose destination: In the Local file browser (left side), navigate to destination
- Start transfer: Drag and drop files from right to left
- Monitor progress: View transfer status in the Jobs tab
filemoverexpress download [remote-configuration] [local-destination] [s3-prefix]Example:
filemoverexpress download my-config ./downloads/ my-folder/video.mp4The File Mover Express GUI consists of three main areas:
-
Local File Browser (Left): Browse your local file system
- File System dropdown: Select local drives, favorites, or remote daemons
- Navigation: Click folders to browse, use breadcrumbs to go back
-
S3 Bucket File Browser (Right): Browse your S3 buckets
- Remote Configuration dropdown: Select configured S3 destinations
- Navigation: Browse S3 objects and prefixes
-
Bottom Panel Tabs:
- Jobs: Monitor active transfers, pause/resume/cancel operations
- Logs: View detailed transfer logs and application messages
- Bucket Reports: Generate and view S3 bucket inventory reports
In the Jobs tab, you can:
- View Progress: See real-time transfer progress, speed, and ETA
- Control Transfers:
- Pause/Resume individual jobs
- Cancel unwanted transfers
- Rename jobs for better organization
- Generate Reports: Create detailed transfer reports
- View Details: Click Action button for detailed job information
- Connect camera storage device
- Select footage in Local file browser
- Choose production S3 bucket in Remote Configuration
- Drag and drop to start upload
- Monitor progress and verify checksums
- Set up Hot Folder monitoring for active project directory
- Configure automatic upload to designated S3 prefix
- Files automatically upload when added/modified
- Team members can download latest versions
- Select final project files
- Choose appropriate S3 storage class (e.g., Glacier for long-term archive)
- Upload with checksum verification
- Generate bucket report for delivery confirmation
- Set up remote daemon on high-bandwidth machine
- Connect GUI from multiple workstations
- Centralize transfers through daemon
- Share access to common project buckets
Large Files (>1GB):
- Enable autotuning (recommended)
- Use higher thread counts if manually tuning
- Ensure adequate local disk I/O
Many Small Files:
- Increase max active transfers
- Consider lower thread counts per file
- Use file order prioritization for critical files
Mixed File Sizes:
- Keep autotuning enabled
- Monitor transfer speeds and adjust if needed
- Use S3 Transfer Acceleration for geographically distant buckets
- Set bandwidth throttling if you need to limit network usage
- Choose nearest AWS Region for your S3 bucket
- Verify AWS credentials:
aws --profile [profile-name] sts get-caller-identity - Check IAM policy permissions
- Confirm S3 bucket exists and is accessible
- Check network bandwidth utilization
- Verify disk I/O isn't bottlenecked
- Consider adjusting thread/transfer settings
- Enable S3 Transfer Acceleration if geographically distant
- Ensure
apiServer.enabledistruein configuration - Restart File Mover Express daemon
- Check for port conflicts (default: 50005)
Now that you're familiar with the basics:
- Using the GUI - Detailed GUI features and workflows
- Using the CLI - Advanced CLI usage and scripting
- Hot Folders - Set up automated monitoring and uploads
- Remote Daemon - Configure multi-user or high-performance setups
- Best Practices - Optimize performance and security
- Checksums - Understand file integrity verification
If you need assistance:
- Check the Troubleshooting guide
- Review logs in the GUI Logs tab or CLI output
- Generate a support file: GUI Settings → Support, or
filemoverexpress support-file - Open an issue on GitHub with:
- Your configuration (remove sensitive information)
- Error messages or logs
- Steps to reproduce the issue