# s3cmd

> Python command line client for uploading, retrieving and managing data in Amazon S3 and S3-compatible storage such as Google Cloud Storage and DreamObjects.

Stars: 4.9k · Language: Python · License: GPL-2.0 · Categories: File Management

- Repository: https://github.com/s3tools/s3cmd
- Website: https://s3tools.org/s3cmd
- Page: https://www.trmn.sh/tools/s3cmd

## Overview

s3cmd is a command line client written in Python for managing data in Amazon S3 and other storage services that speak the S3 protocol, including Google Cloud Storage and DreamHost DreamObjects. It addresses remote data with URIs of the form s3://BUCKET and s3://BUCKET/OBJECT.

Setup starts with `s3cmd --configure`, which prompts for the Access Key and Secret Key. Core commands include `ls` (with `--recursive`), `mb` to create a bucket, `put` and `get` (both with `--recursive`), and `sync` for directory trees. ACLs can be set at upload time with `--acl-public` or `--acl-private` on `put` and `sync`, or changed later with `s3cmd setacl`. The README also lists multipart uploads, encryption, incremental backup, metadata management, bucket size reporting and bucket policies among its more than 60 command line options. The project description also mentions CloudFront support.

It is aimed at power users who are comfortable on the command line. The README also names batch scripts and automated backups to S3 triggered from cron as typical uses. It is released under GPLv2.

## Alternatives

- [trash-cli](https://www.trmn.sh/tools/andreafrancia-trash-cli.md): Command-line interface to the freedesktop.org trashcan: trash, list, restore, and empty files using the same trash as KDE, GNOME, and XFCE. (Python, 4.6k stars)
- [PathPicker](https://www.trmn.sh/tools/pathpicker.md): Command-line tool (fpp) that parses piped output for file paths, shows a curses selector, and opens the selected files in $EDITOR or runs a command on them. (Python, 5.2k stars)
- [beets](https://www.trmn.sh/tools/beets.md): Command-line music library manager that catalogs collections and autocorrects tags using MusicBrainz, Discogs, and Beatport, extensible through Python plugins. (Python, 16.0k stars)
- [ranger](https://www.trmn.sh/tools/ranger.md): Console file manager with VI key bindings, multi-column display, and file preview capabilities (Python, 17.5k stars)
- [xplr](https://www.trmn.sh/tools/xplr.md): Terminal-based file explorer with Lua scripting, keyboard controls, and plugin system for command-line integration (Rust, 4.9k stars)

---

Canonical: https://www.trmn.sh/tools/s3cmd
