Easily download Github repos without dependencies such as Git, Tar, Unzip, etc.
Latest commit 50d4311 May 4, 2016 @jprichardson jprichardson 0.5.0
Failed to load latest commit information.
lib Fixed linting issues May 4, 2016
test JavaScript Standard Style Aug 30, 2015
.gitignore Initial commit. Jan 17, 2013
.travis.yml travis: update May 4, 2016
CHANGELOG.md 0.5.0 May 4, 2016
LICENSE Initial commit. Jan 17, 2013
README.md readme: update travis badge and copyright dates May 4, 2016
package.json 0.5.0 May 4, 2016


Node.js - github-download

build status

Easily download Github repos without any external dependencies such as Git, Tar, Unzip, etc.


I really like the concept of managing user defined projects, repos, file structures (package management) on Github like the way that Component does package management. I have a package management system Rock that I use to create skeleton/templates of projects. I wanted Rock to use Github as a package management system. I also didn't want any dependencies amongst any 3rd party programs like Git, Tar, or Unzip. Pure Node.js JavaScript is what I wanted.


npm install github-download


ghdownload(params, dir)

Downloads the latest copy of some Github reference (branch, tag, or commit), or the master branch by default (specifically the master branch, it does not honor Github's default branch configuration). This will still work even if the Github API limit has been reached.

  • params: Can either be:
    • a Github URL string such as:
      • https://github.com/jprichardson/node-vcsurl.git
      • git@github.com:jprichardson/node-vcsurl.git
      • git://github.com/jprichardson/node-vcsurl.git
      • and even including a reference, e.g. https://github.com/jprichardson/node-vcsurl.git#master
    • or an object like so: {user: 'jprichardson', repo: 'vcsurl', ref: 'master'}
  • dir: The output directory. Uses the current working directory if nothing is specified.

Returns a GithubDownloader object that emits events on dir, file, and end.


var ghdownload = require('github-download')
  , exec = require('exec')

ghdownload({user: 'jprichardson', repo: 'node-batchflow', ref: 'master'}, process.cwd())
.on('dir', function(dir) {
.on('file', function(file) {
.on('zip', function(zipUrl) { //only emitted if Github API limit is reached and the zip file is downloaded
.on('error', function(err) {
.on('end', function() {
  exec('tree', function(err, stdout, sderr) {


├── README.md
├── lib
│   └── batchflow.js
├── package.json
└── test
    ├── batchflow-par-array.test.js
    ├── batchflow-par-limit.test.js
    ├── batchflow-par-object.test.js
    ├── batchflow-seq-array.test.js
    ├── batchflow-seq-object.test.js
    ├── batchflow.test.js
    ├── mocha.opts
    └── resources

3 directories, 12 files


(MIT License)

Copyright 2013-2016, JP Richardson jprichardson@gmail.com