AWS S3 Navigator is a web-based UI for browsing and interacting with files stored in Amazon S3 buckets — including private ones. It securely generates pre-signed URLs to allow direct access to files via the browser, without making your bucket public.
This tool is designed to simplify navigation through an S3 bucket using a browser interface. It leverages your AWS access and secret keys to list files and folders, and allows secure file access using pre-signed URLs valid for 1 hour.
Whether you're managing internal assets or building a private file delivery tool, this project provides a simple and secure solution.
- 📁 Browse and navigate S3 bucket contents
- 🔐 Supports access to private buckets
- 🔗 Pre-signed URL generation for secure file access (1-hour validity)
- 🔍 File search functionality
- ⬆️ Upload files to the bucket
- ⬇️ Download files and folders
- 🧭 Breadcrumb navigation
- 🧾 Dynamic content display for files and folders
-
Clone the repository:
git clone <repository-url>
-
Navigate to the project folder:
cd <folder>
-
Install dependencies:
pip install -r requirements.txt
To start the application, run the following command:
python3 app.py- Python 3.x
- AWS access keys with S3 permissions
Ensure your AWS access keys and secret keys are configured properly for the tool to access your S3 bucket.
- Select the desired S3 bucket from the dropdown menu.
- Use the search bar to find specific files or folders.
- Navigate through folders by clicking on them.
- Click on files to open them using a presigned URL.
- Use the upload section in the header to upload files directly to the selected bucket and current path.
- Download files or folders using the download button provided.
We welcome contributions from the community. To contribute, please follow these steps:
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch). - Make your changes and commit them (
git commit -m 'Add some feature'). - Push to the branch (
git push origin feature-branch). - Open a pull request to the
mainbranch.