{"id":14978999,"url":"https://github.com/jvrck/bb-ripper","last_synced_at":"2026-03-08T01:02:36.106Z","repository":{"id":65774682,"uuid":"482739183","full_name":"jvrck/bb-ripper","owner":"jvrck","description":"Bitbucket Repo Ripper - Backup your Bitbucket repositories","archived":false,"fork":false,"pushed_at":"2026-03-05T06:42:19.000Z","size":60,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-03-05T11:22:03.687Z","etag":null,"topics":["backup","bitbucket","docker","docker-image","git","python","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jvrck.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-04-18T06:26:16.000Z","updated_at":"2026-03-05T06:42:07.000Z","dependencies_parsed_at":"2023-10-15T18:55:58.434Z","dependency_job_id":"de431a31-feb9-4947-8d75-2a322b1b4074","html_url":"https://github.com/jvrck/bb-ripper","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"be1865c69d271442230ef809c8f54cebd22841d8"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/jvrck/bb-ripper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvrck%2Fbb-ripper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvrck%2Fbb-ripper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvrck%2Fbb-ripper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvrck%2Fbb-ripper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jvrck","download_url":"https://codeload.github.com/jvrck/bb-ripper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jvrck%2Fbb-ripper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30240268,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T00:58:18.660Z","status":"ssl_error","status_checked_at":"2026-03-08T00:55:48.608Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","bitbucket","docker","docker-image","git","python","python3"],"created_at":"2024-09-24T13:58:53.468Z","updated_at":"2026-03-08T01:02:36.051Z","avatar_url":"https://github.com/jvrck.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bb-ripper - Bitbucket Repo Ripper\n\nThis project downloads all Bitbucket repositories and every branch for each repository. The resulting downloads are compressed with `tar`.\n\n## Bitbucket Authentication\n\nThis application supports two authentication methods:\n\n### API Tokens (Recommended)\n\n**Required after June 9, 2026** when app passwords are deprecated.\n\nAPI tokens provide:\n- Expiration control\n- Centralized management for admins\n- Modern security scopes\n\n[Create an API token](https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/)\n\n### App Passwords (Legacy - Deprecated)\n\n⚠️ **App passwords will stop working on June 9, 2026**\n\nExisting app passwords will continue to work until that date, but no new app passwords can be created as of September 9, 2025.\n\n[More about app password deprecation](https://www.atlassian.com/blog/bitbucket/bitbucket-cloud-transitions-to-api-tokens-enhancing-security-with-app-password-deprecation)\n\n## Environment Settings\n\nThe application requires the following environment variables to run.\n\n### For API Token Authentication (Recommended)\n\n`BB_EMAIL` Your Atlassian account email.\n\n`BB_API_TOKEN` Your Bitbucket API token.\n\n`BB_WORKSPACE` The name of the Bitbucket workspace.\n\n`BB_RIPPER_EXPORT_DIRECTORY` The path of the output.\n\n### For App Password Authentication (Legacy)\n\n`BB_USER` The username component of the Bitbucket App Password.\n\n`BB_PASSWORD` The password component of the Bitbucket App Password.\n\n`BB_WORKSPACE` The name of the Bitbucket workspace.\n\n`BB_RIPPER_EXPORT_DIRECTORY` The path of the output.\n\n### Optional Settings\n\n`BB_TEST_COUNTER` Limit the number of repositories to process (useful for testing). All values that are non-integer or less than 1 will be ignored.\n\n## Running the ripper\n\n### Local Environment\n\nThe application was developed and tested on MacOS with the [Python 3.11 package](https://formulae.brew.sh/formula/python@3.11) managed with [Homebrew](https://brew.sh/).\n\nTo install Python dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n### Set the environment variables\n\nTo set the environment variables: Rename `env_setup.sh.example` to `env_setup.sh` after adding values for your environment, then source the environment variables to add them to your session.\n\n```bash\nsource env_setup.sh\n```\n\n### Run\n\nTo run the application\n\n```bash\ncd bb-ripper\npython3 .\n```\n\n### Running the docker image\n\nTo run the docker image: Create a Docker environment file with the variables required, named `docenv`. Create a directory named `data` to store the repositories. This directory will be mounted to the `/data` volume in the container.\n\nThe repository contains a file named `docenv.example` that is a template for the `docenv` file.\n\n```bash\ndocker pull jvrck/bbripper\ndocker run --env-file dockenv -v $(pwd)/data:/data  --rm -it  jvrck/bbripper:latest\n```\n\n### Building and running the docker image\n\nTo build the docker image\n\n```bash\ndocker build --no-cache -t ripper .\n```\n\nTo run the image, create a docker environment file with the variables required named `docenv`. Create a directory named `data` to store the repositories. This directory will be mounted to the `/data` volume in the container.\n\n```bash\n docker run --env-file dockenv -v $(pwd)/data:/data  --rm -it  ripper:latest\n```\n\n## Docker image with AWS CLI\n\nA variant of the image that has the AWS CLI preinstalled. This can be done during the build by passing a build argument to the Docker `build` command.\n\n```bash\ndocker build --no-cache -t bbripper-aws --build-arg AWSCLI=TRUE .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvrck%2Fbb-ripper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjvrck%2Fbb-ripper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjvrck%2Fbb-ripper/lists"}