Skip to content
Prints the number of downloads for a given npm package and the packages that directly depend on it
JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
bin
lib
test
.gitignore
.travis.yml
History.md release 0.0.1 Dec 28, 2012
LICENSE inital commit Dec 28, 2012
Makefile
README.md
index.js
package.json release 0.0.1 Dec 28, 2012

README.md

Not currently maintained or working. Pull requests / project adopters welcome

npm-downloads

Prints the number of downloads for a given npm package and the packages that directly depend on it.

Usage: npm-downloads [options] <package>

Options:

  -h, --help             output usage information
  -V, --version          output the version number
  -s, --start [date]     Start date (defaults to a month ago)
  -e, --end [date]       End date (defaults to yesterday)
  -f, --format [format]  Output format (json, tab, pretty)
  -S, --subtract         Subtract dependents downloads from <package> total
  -p, --no-progress      Disable the progress bar
  -q, --quick            Prints only the total number of <package> downloads

Formats

There are three output formats available: tab, json, and pretty (tab is the default).

tab

$ npm-downloads ms
=========================================================== 100%
ms  68009
mocha 72979
mongoose  42450
zombie  5509
jog 1731
up  1009
satisfy 109
hoarders  60
workforce 45
cloud-switch  30
component-search  29
situation 24
racker  20
animation 15
mongoose-ttl  14
npm-research  10
authors 5
fnoc  5
simple-queue-service  4
cache22 3
jotan 3
jog2  1

json

$ npm-downloads -f json -p ms
[{"name":"ms","count":68009},{"name":"mocha","count":72979},{"name":"mongoose","count":42450},{"name":"zombie","count":5509},{"name":"jog","count":1731},{"name":"up","count":1009},{"name":"satisfy","count":109},{"name":"hoarders","count":60},{"name":"workforce","count":45},{"name":"cloud-switch","count":30},{"name":"component-search","count":29},{"name":"situation","count":24},{"name":"racker","count":20},{"name":"animation","count":15},{"name":"mongoose-ttl","count":14},{"name":"npm-research","count":10},{"name":"authors","count":5},{"name":"fnoc","count":5},{"name":"simple-queue-service","count":4},{"name":"jotan","count":3},{"name":"cache22","count":3},{"name":"jog2","count":1}]

pretty

$ npm-downloads -f pretty ms
=========================================================== 100%
┌──────────────────────┬───────────┐
│ Package              │ Downloads │
├──────────────────────┼───────────┤
│ ms                   │ 68009     │
├──────────────────────┼───────────┤
│ mocha                │ 72979     │
├──────────────────────┼───────────┤
│ mongoose             │ 42450     │
├──────────────────────┼───────────┤
│ zombie               │ 5509      │
├──────────────────────┼───────────┤
│ jog                  │ 1731      │
├──────────────────────┼───────────┤
│ up                   │ 1009      │
├──────────────────────┼───────────┤
│ satisfy              │ 109       │
├──────────────────────┼───────────┤
│ hoarders             │ 60        │
├──────────────────────┼───────────┤
│ workforce            │ 45        │
├──────────────────────┼───────────┤
│ cloud-switch         │ 30        │
├──────────────────────┼───────────┤
│ component-search     │ 29        │
├──────────────────────┼───────────┤
│ situation            │ 24        │
├──────────────────────┼───────────┤
│ racker               │ 20        │
├──────────────────────┼───────────┤
│ animation            │ 15        │
├──────────────────────┼───────────┤
│ mongoose-ttl         │ 14        │
├──────────────────────┼───────────┤
│ npm-research         │ 10        │
├──────────────────────┼───────────┤
│ authors              │ 5         │
├──────────────────────┼───────────┤
│ fnoc                 │ 5         │
├──────────────────────┼───────────┤
│ simple-queue-service │ 4         │
├──────────────────────┼───────────┤
│ cache22              │ 3         │
├──────────────────────┼───────────┤
│ jotan                │ 3         │
├──────────────────────┼───────────┤
│ jog2                 │ 1         │
└──────────────────────┴───────────┘

Dependents

We might be curious about how many programs are using <package> as a direct dependency. It turns out that this isn't really possible. We can however get a very rough (mostly worthless) idea by enabling the -S flag which will subtract dependents downloads from <package> downloads. Note that this is just an estimate as are all download counts.

$ npm-downloads -s 12-25-2012 -S -p ms
ms  0
mocha 4703
mongoose  2632
zombie  262
up  91
jog 68
satisfy 7
hoarders  4
situation 3
workforce 2
simple-queue-service  1
component-search  0
fnoc  0
jog2  0
cloud-switch  0
authors 0
cache22 0
racker  0
jotan 0
npm-research  0
animation 0
mongoose-ttl  0

Installation

$ npm install -g npm-downloads

License

MIT

Something went wrong with that request. Please try again.