Bitbucket Cloud Backup Tool

A simple yet powerful web application to connect to your Bitbucket Cloud workspace and download your repositories as ZIP archives. This tool provides an easy-to-use interface for backing up multiple repositories at once, directly from your browser.

Features

• Secure Authentication: Connects to the Bitbucket API using a Bitbucket App Password for enhanced security. Your credentials are never stored.
• Repository Fetching: Automatically lists all repositories you have access to within a specified workspace.
• Selective Backup: Choose to back up all repositories at once or select specific ones.
• Real-time Progress: Monitor the status of your downloads (Pending, Downloading, Completed, Failed).
• Client-Side Operation: All actions are performed directly in your browser. No data (other than API requests) is sent to any server.
• Responsive Design: Clean and easy-to-use interface that works on both desktop and mobile devices.

How to Use

Follow these steps to back up your repositories:

1. Create a Bitbucket App Password

For security reasons, this tool requires a Bitbucket App Password instead of your regular account password.

1. Log in to your Bitbucket account.
2. Go to Personal settings > App passwords.
3. Click Create app password.
4. Give the password a descriptive label (e.g., backup-tool).
5. Grant it the necessary permissions. You only need Repositories: Read.
6. Click Create. Bitbucket will show you the password. Copy it immediately, as you won't be able to see it again.

For more details, see the official Atlassian documentation on App Passwords.

2. Enter Your Credentials in the Tool

Once you have the app running:

1. Workspace ID: This is the unique ID for your workspace, often found in the URL (e.g., bitbucket.org/{workspace_id}/...).
2. Username or Email: The username or email associated with your Bitbucket account.
3. App Password: The app password you created in the previous step.

3. Fetch, Select, and Download

1. Click Fetch Repositories. The tool will connect to Bitbucket and list your repos.
2. Use the checkboxes to select the repositories you want to download. You can also use the "Select All" option.
3. Click the Backup Repositories button.
4. Your browser will begin downloading a .zip file for each selected repository. The progress will be shown in the "Backup Progress" section.

Tech Stack

• Framework: React
• Language: TypeScript
• Styling: Tailwind CSS
• API: Bitbucket Cloud REST API

Security Notice

• Your credentials (username and App Password) are stored in your browser's memory only for the duration of your session. They are never stored permanently or transmitted to any server other than the official Bitbucket API.
• All API communication happens directly between your browser and Bitbucket.
• We strongly recommend using an App Password with the minimum required permissions (Read-only on repositories).

Disclaimer

This is an unofficial, third-party tool and is not affiliated with, endorsed, or supported by Atlassian. Use at your own risk.