Skip to main content

Clone, fetch, pull user's Github repositories

Project description


A command line utility to clone all user repositories from Github or Bitbucket. If the repositories are already cloned, the utility receives the changes in all branches and tries to merge the changes in the current branch with the local repository.

How to install

  • $ cd ~
  • $ mkdir ghcopy
  • $ cd ghcopy
  • $ virtualenv --python=python3 .
  • $ source bin/activate
  • $ pip install git+git:// (recommended) or
  • $ pip install ghcopy

You can not use a virtual environment if you do not need it. When installing without git (last line), you will have to clone the repository, create directory ~/.ghcopy and copy the configuration files and locales:

  • $ git clone
  • $ cd github-copier/ghcopy/data
  • $ mkdir ~/.ghcopy
  • $ cp config.json ~/.ghcopy
  • $ cp -r locale ~/.ghcopy
  • $ cd ../../..
  • $ rm -rf github-copier

See ~/.ghcopy/config.json:

    "environment": "",
    "user": "",
    "password": "",
    "token": "",
    "type": "github",
    "type": "bitbucket",
    "locale_domain": "ghcopy",
    "language": "en",
    "locale_dir": "~/.ghcopy/locale",
    "log_file": "~/.ghcopy/ghcopy.log",
    "log_format": "%(levelname)-10s|%(asctime)s| %(name)s --- %(message)s (%(filename)s:%(lineno)d)"

You can change parameter values and specify a username and password or token if you do not want to specify them on the command line, but then the password and token will be stored in clear text. On July 1st, 2020, basic authentication using password to Github will no longer work, use a personal access token (PAT) with the appropriate scope to access repositories (parameter -t --token or token in config file). Visit for more information.

Command Line Tool

ghcopy [-h] [-c CONFIG] [-o OUTPUT] [-u USER] [-p PASSWORD] [-t token]
          [-l LOG_LEVEL]

optional arguments:
  -h, --help show this help message and exit
  -c CONFIG, --config CONFIG config file (default: ~/.ghcopy/config.json)
  -o OUTPUT, --output OUTPUT output directory (default: ~/RemoteCopies)
  -u USER, --user USER user name (default: parameter user from config file)
  -p PASSWORD, --password PASSWORD password (default: parameter password from config file)
  -t TOKEN, --token TOKEN personal access token (PAT) (default: parameter token from config file)
  -b HUB, --hub HUB repository type: github, bitbucket (default: parameter type from config file)
  -l LOG_LEVEL, --log_level LOG_LEVEL logging level: CRITICAL, ERROR, WARNING, INFO, DEBUG or NOTSET (default: INFO)


  • GitPython>=3.0.8
  • PyGithub>=1.46
  • bitbucket-python>=0.2.2

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ghcopy-0.0.3.tar.gz (6.4 kB view hashes)

Uploaded Source

Built Distribution

ghcopy-0.0.3-py3-none-any.whl (8.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page