The File Mover Express command-line interface provides powerful scripting capabilities and advanced control over file transfers.
The daemon must be running for GUI connectivity:
filemoverexpress daemonOptions:
--remote: Start as remote daemon for multi-user access--address=<address>: Specify listening address--ports=<ports>: Specify listening ports
Upload files from your local system to Amazon S3:
filemoverexpress upload [remote-configuration] [paths...]Examples:
# Upload a single file
filemoverexpress upload my-config ./video.mp4
# Upload a directory
filemoverexpress upload my-config ./project-files/
# Upload multiple items
filemoverexpress upload my-config ./file1.mov ./file2.mov ./folder/Download files from Amazon S3 to your local system:
filemoverexpress download [remote-configuration] [local-destination] [s3-prefix]Examples:
# Download specific file
filemoverexpress download my-config ./downloads/ my-folder/video.mp4
# Download entire folder
filemoverexpress download my-config ./downloads/ project-files/
# Download to current directory
filemoverexpress download my-config ./ important-file.txtRelative Paths (Recommended for Uploads):
- Don't start with
/(forward slash) - Preserve directory structure in S3
- Example:
dir/file.txtuploads asdir/file.txtin S3
Absolute Paths:
- Full file path from root
- File Mover Express strips path and uploads file only
- Example:
/Users/username/dir/file.txtuploads asfile.txtin S3
Important Notes:
- Cannot mix relative and absolute paths in same command
- Relative paths with
..are not supported - For downloads, use relative destination paths only
| Flag | Description | Example |
|---|---|---|
--help |
List available flags and commands | filemoverexpress --help |
--profile |
AWS named profile | --profile my_profile |
--prefix |
S3 prefix path | --prefix my/s3/path |
| Flag | Description | Example |
|---|---|---|
--force |
Force transfer regardless of conflicts | --force |
--retry-count |
Number of retry attempts on error | --retry-count 4 |
--max-active-transfers |
Max concurrent file transfers | --max-active-transfers 10 |
--max-active-checksums |
Max concurrent checksums (upload only) | --max-active-checksums 5 |
| Flag | Description | Example |
|---|---|---|
--auto-tuning |
Enable automatic performance tuning | --auto-tuning true |
--chunk-size |
Chunk size in MB | --chunk-size 50 |
--threads |
Number of threads per transfer | --threads 10 |
| Flag | Description | Example |
|---|---|---|
--checksum-algorithm |
Checksum algorithm (md5, xxhash, xxhash64, xxh3) | --checksum-algorithm xxhash64 |
--enable-metadata-filter |
Filter system metadata files | --enable-metadata-filter |
--filter |
Regular expression file filter | --filter "^.*\.(mov)$" |
--max-age |
Only process files within time window | --max-age "2d" |
| Flag | Description | Example |
|---|---|---|
--no-sleep |
Prevent macOS sleep during transfers | --no-sleep true |
By File Extension:
# Only upload .mov files
filemoverexpress upload my-config ./footage/ --filter "^.*\.(mov)$"
# Upload video files only
filemoverexpress upload my-config ./media/ --filter "^.*\.(mov|mp4|avi)$"By Age:
# Upload files from last 2 days
filemoverexpress upload my-config ./daily-footage/ --max-age "2d"
# Upload files from last 3600 seconds
filemoverexpress upload my-config ./recent/ --max-age "3600"Metadata Filtering:
# Exclude system files (.DS_Store, Thumbs.db, ._* files)
filemoverexpress upload my-config ./project/ --enable-metadata-filterHigh-Performance Upload:
filemoverexpress upload my-config ./large-files/ \
--max-active-transfers 20 \
--threads 15 \
--chunk-size 100 \
--max-active-checksums 8Conservative Settings:
filemoverexpress upload my-config ./files/ \
--max-active-transfers 5 \
--threads 5 \
--chunk-size 25Auto-tuned (Recommended):
filemoverexpress upload my-config ./files/ --auto-tuning trueBatch Upload Script:
#!/bin/bash
REMOTE_CONFIG="production-bucket"
SOURCE_DIR="/media/daily-footage"
# Upload today's footage
filemoverexpress upload $REMOTE_CONFIG $SOURCE_DIR \
--max-age "1d" \
--filter "^.*\.(mov|mp4)$" \
--enable-metadata-filter \
--retry-count 3Backup Script with Error Handling:
#!/bin/bash
set -e
REMOTE_CONFIG="backup-bucket"
BACKUP_DIR="/important-data"
LOG_FILE="/var/log/backup.log"
echo "Starting backup at $(date)" >> $LOG_FILE
if filemoverexpress upload $REMOTE_CONFIG $BACKUP_DIR --force; then
echo "Backup completed successfully at $(date)" >> $LOG_FILE
else
echo "Backup failed at $(date)" >> $LOG_FILE
exit 1
fiConfigure hot folders in the configuration file for automatic uploads:
hotFolders:
- enabled: true
localSourceFolder: /Users/user/watch-folder
name: auto_upload
remoteConfigurations:
- remoteConfigurationName: my-config
s3DestinationFolder: auto-uploads/hotFolders:
- enabled: true
localSourceFolder: /media/camera-1
name: camera_1_upload
remoteConfigurations:
- remoteConfigurationName: production
s3DestinationFolder: camera-1/
- remoteConfigurationName: backup
s3DestinationFolder: camera-1-backup/
- enabled: true
localSourceFolder: /media/camera-2
name: camera_2_upload
remoteConfigurations:
- remoteConfigurationName: production
s3DestinationFolder: camera-2/Test your AWS configuration:
filemoverexpress validate-credentials [remote-configuration]Create diagnostic information for troubleshooting:
filemoverexpress support-fileOutput location:
- Windows:
C:\Users\username\.filemoverexpress\support-files\ - macOS/Linux:
~/.filemoverexpress/support-files/
Generate detailed bucket reports:
filemoverexpress inventory [remote-configuration] [options]Options:
--output-format: Format (json, yaml, csv, xml)
Example:
filemoverexpress inventory my-config --output-format csvOverride default configuration location:
export filemoverexpress_CONFIG_DIR=/custom/config/path
filemoverexpress upload my-config ./files/Default Locations:
- Windows:
C:\Users\username\.filemoverexpress\ - macOS/Linux:
~/.filemoverexpress/
0: Success1: General error2: Configuration error3: Network/AWS error
Enable detailed logging by setting log level in configuration:
logging:
log_severity: info # debug, info, warn, error, fatal
directory: /path/to/logs/# Test with minimal settings
filemoverexpress upload my-config ./test-file.txt \
--max-active-transfers 1 \
--threads 1 \
--retry-count 1# In your build script
if [ "$BUILD_SUCCESS" = "true" ]; then
filemoverexpress upload artifacts-bucket ./build-output/ \
--prefix "builds/$BUILD_NUMBER/" \
--force
fi# Daily backup at 2 AM
0 2 * * * /usr/local/bin/filemoverexpress upload backup-config /data/daily/ --max-age "1d"FROM alpine:latest
RUN apk add --no-cache ca-certificates
COPY filemoverexpress /usr/local/bin/
COPY config.yaml /root/.filemoverexpress/configuration.yaml
ENTRYPOINT ["filemoverexpress"]- Hot Folders - Automated file monitoring and uploads
- Remote Daemon - Multi-user and high-performance setups
- Performance Optimization - Tune for your workload
- Troubleshooting - Resolve common issues