S3 Web Browser is a Flask-based web application that allows users to browse AWS S3 buckets and their contents via a simple web interface. It leverages Boto3, AWS's SDK for Python, to interact with S3.

• List S3 Buckets: View all S3 buckets available to the AWS account in a card-based grid layout.
• Browse Bucket Contents: Navigate through folders and files with breadcrumb navigation.
• Search Bucket Contents: Recursively search for files and folders within any bucket or subdirectory (case-insensitive).
• Generate Presigned URLs: Securely download S3 objects via temporary 1-hour presigned URLs.
• Pagination: Browse large buckets efficiently with configurable page sizes.
• Copy S3 Paths: One-click copy of S3 paths (s3://bucket/key) to clipboard.
• Responsive UI: Modern interface with loading indicators and smooth navigation.

All configuration is done via environment variables (or a .env file):

See .env.example for a template.

docker run -it --rm -p 8000:8000 --env-file .env romanzdk/s3-web-browser

1. Create a .env file with your AWS credentials (see .env.example).
2. docker build -t s3-browser .
3. docker run -it --rm -p 8000:8000 --network=host --env-file .env s3-browser
4. Open http://127.0.0.1:8000/

1. Install dependencies: poetry install
2. Export AWS credentials:

   export AWS_ACCESS_KEY_ID="your_access_key_id"
   export AWS_SECRET_ACCESS_KEY="your_secret_access_key"

3. Run code quality checks: make cq
4. Run tests: make test
5. Start the app: poetry run python run.py
6. Open http://127.0.0.1:8000/

• S3 Commander — Total Commander-style dual-pane S3 file browser with server-side move/copy.

This project is licensed under the MIT License - see the LICENSE file for details.

• Flask for providing the web framework.
• AWS Boto3 for interfacing with Amazon S3.