https://github.com/nongvantinh/bitbucket-delete-git-lfs
This Python script helps you delete Git LFS files from your Bitbucket repository by mimicking browser behavior using session cookies
https://github.com/nongvantinh/bitbucket-delete-git-lfs
delete-git-lfs git-lfs
Last synced: about 1 year ago
JSON representation
This Python script helps you delete Git LFS files from your Bitbucket repository by mimicking browser behavior using session cookies
- Host: GitHub
- URL: https://github.com/nongvantinh/bitbucket-delete-git-lfs
- Owner: nongvantinh
- License: mit
- Created: 2025-05-26T12:38:22.000Z (about 1 year ago)
- Default Branch: development
- Last Pushed: 2025-05-26T13:44:28.000Z (about 1 year ago)
- Last Synced: 2025-05-26T14:22:24.068Z (about 1 year ago)
- Topics: delete-git-lfs, git-lfs
- Language: Python
- Homepage:
- Size: 198 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Bitbucket LFS Cleanup Script
This Python script helps you delete Git LFS files from your Bitbucket repository by mimicking browser behavior using session cookies. It is intended for **personal/admin use only** and is **not affiliated with Atlassian or Bitbucket**.
### Usage
The script provides three options: `--fetch`, `--locate`, and `--delete`.
`--fetch`: Retrieves all the OIDs of the Git LFS objects in the repository and saves them to the file `git-lfs-data.txt`.
`--locate`: Reads all the OIDs from the `git-lfs-data.txt` file and checks against the Git log to determine if any commits still reference them. If none are found, it outputs the information of the Git LFS objects to the file `dangling-git-lfs-data.txt`.
`--delete`: Reads all the OIDs from the `dangling-git-lfs-data.txt` file and performs the delete operation.
### Instructions for Using the Script
Before doing the steps below, remember to install the required dependencies: `pip install -r requirements.txt`
1. Navigate to **Repository Settings** and select **Git LFS**.
2. Open the Chrome browser and press `F12` to access the Developer Tools. Navigate to the **Network** tab and search for the following URL:
`admin/lfs/file-management`
3. In the **Cookies** tab, copy all the cookies and update the `cookies` map in the `config.py` file with the copied values.
4. Perform the cleanup process by executing the following command:
```bash
python git-lfs-bitbucket.py --fetch --locate --delete
```
> **Note:** This is a destructive process. Once files are deleted from Bitbucket Cloud, they are permanently removed. While it is uncertain if the files are completely erased from Bitbucket's backend, this action is irreversible. Proceed with caution.
## Disclaimer
**USE AT YOUR OWN RISK.**
This script:
- Requires you to be logged into Bitbucket in your browser.
- Requires you to manually provide your session cookies.
- Is not an official API client and may stop working if Bitbucket changes their website.
The author is not responsible for any misuse or account issues. Always comply with Bitbucket's Terms of Service.