A modern, feature-rich FTP/SFTP command-line client written in Rust.
RustyFTP is a powerful terminal-based file transfer client designed for developers and power users. It combines the speed and safety of Rust with a modern, user-friendly interface featuring auto-completion, background transfers, and robust error handling.
⚠️ Disclaimer: This project is a study case and educational project developed with AI assistance. It demonstrates Rust programming concepts, network protocols, and modern CLI design patterns. While functional, it is intended primarily for learning purposes. For detailed feedback and lessons learned from this case study, see STUDY.md.
- FTP: Standard File Transfer Protocol support.
- FTPS: Secure FTP over TLS/SSL (Explicit & Implicit).
- SFTP: SSH File Transfer Protocol (v3).
- Interactive REPL: Full shell-like experience with command history (persisted).
- Smart Auto-completion: Context-aware completion for local/remote paths and commands.
- Visual Feedback: Colorized output, progress bars with ETA and speed.
- Job Control: Run transfers in background (
&), list jobs, and cancel them.
- Batch Operations:
mgetandmputwith wildcard support (*.rs,src/*). - Recursive Transfers: Upload/Download entire directories with
-r. - Resilience: Automatic resume of interrupted transfers and connection retry logic.
- Bookmarks: Save and manage your favorite connections.
- Security: Secure password handling in memory using
zeroize.
git clone https://github.com/yourusername/rustyftp.git
cd rustyftp
cargo build --releaseThe binary will be available at target/release/rustyftp.
# Connect to FTP
rustyftp ftp --host ftp.example.com --user myuser
# Connect to SFTP
rustyftp sftp --host sftp.example.com --user myuser
# Connect to FTPS (Secure)
rustyftp ftp --host secure.example.com --user myuser --secure| Command | Description | Example |
|---|---|---|
ls, lls |
List remote/local files | ls -l |
cd, lcd |
Change remote/local directory | cd /var/www |
get, put |
Transfer single file | get backup.zip |
mget, mput |
Batch transfer (supports wildcards) | mput -r src/ |
jobs |
List background transfers | jobs |
bookmark |
Manage saved connections | bookmark save myserver |
Contributions are welcome! See TODO.md for the current roadmap.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ in Rust