ezdrop

README

EZDrop

Simple and fast web-based file browser and transfer tool.

Install

go install github.com/iamwavecut/ezdrop@latest

Usage

Run the server:

ezdrop -chroot /path/to/serve

Options:

• -chroot (required): Base directory to serve
• -port (optional): Port to listen on (default: 8080)
• -readonly (optional): Enable read-only mode (default: false)

Examples:

# Run with custom port
ezdrop -chroot /home/user/files -port 3000

# Run in read-only mode
ezdrop -chroot /home/user/files -readonly

Features

File Management

• File browser with list/grid views
• Multi-file upload/download with progress tracking
• Chunked file upload support for large files
• Directory upload support
• Sort by name/size/date
• File selection patterns (glob)

Upload Features

• Supports any file type and size
• Chunked upload with automatic size optimization
• Checksum verification for data integrity
• Upload progress tracking:
  • Overall progress across all files
  • Per-file progress with chunk information
  • Visual progress bars
  • File size and transfer speed display
• Automatic retry on failed chunks
• Drag and drop support

Navigation

• Keyboard navigation
  • Arrow keys: Move cursor
  • Space: Toggle selection
  • Enter: Open directory/download file
  • Backspace: Navigate up
  • Home/End: Jump to start/end
  • PageUp/PageDown: Move by page/column
  • Ctrl+A: Select all
  • +/-: Select/deselect by pattern

Interface

• Dark/light theme toggle
• List and grid view modes
• Responsive design
• Progress indicators
• File size formatting
• Date/time display

Selection

• Single click: Set cursor
• Double click: Open/download
• Shift+click: Range select
• Ctrl+click: Toggle selection
• Drag select: Multiple files
• Pattern selection (.txt, doc, etc.)

Security

• Enforced chroot directory
• Path traversal protection
• Rate limiting
• Security headers
• Read-only mode

Development

Built with:

• Go 1.23+
• Modern JavaScript (no frameworks)
• CSS Grid/Flexbox

License

MIT License