{"id":15743978,"url":"https://github.com/doowb/downloads-cli","last_synced_at":"2025-07-11T11:35:03.396Z","repository":{"id":57215717,"uuid":"73779734","full_name":"doowb/downloads-cli","owner":"doowb","description":"Commandline application for retrieving npm download counts for the specified repository or maintainer.","archived":false,"fork":false,"pushed_at":"2016-11-15T05:40:17.000Z","size":11,"stargazers_count":4,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T08:40:30.503Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/doowb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"contributing.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-15T05:33:17.000Z","updated_at":"2019-07-15T18:59:34.000Z","dependencies_parsed_at":"2022-08-26T13:41:13.367Z","dependency_job_id":null,"html_url":"https://github.com/doowb/downloads-cli","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/doowb/downloads-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doowb%2Fdownloads-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doowb%2Fdownloads-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doowb%2Fdownloads-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doowb%2Fdownloads-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/doowb","download_url":"https://codeload.github.com/doowb/downloads-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/doowb%2Fdownloads-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264795838,"owners_count":23665241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-10-04T03:22:18.478Z","updated_at":"2025-07-11T11:35:03.164Z","avatar_url":"https://github.com/doowb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# downloads-cli [![NPM version](https://img.shields.io/npm/v/downloads-cli.svg?style=flat)](https://www.npmjs.com/package/downloads-cli) [![NPM downloads](https://img.shields.io/npm/dm/downloads-cli.svg?style=flat)](https://npmjs.org/package/downloads-cli)\n\n\u003e Commandline application for retrieving npm download counts for the specified repository or maintainer.\n\n## Install\n\nInstall with [npm](https://www.npmjs.com/):\n\n```sh\n$ npm install --save downloads-cli\n```\n\n## Usage\n\nOnce installed globally, there will be a `downloads` command that can be run from the command line.\n\nTo see the download counts for a module, specify the module name after the `downloads` command like this:\n\n```sh\n$ downloads micromatch\n```\n\nExample output from running `$ downloads micromatch`:\n\n![image](https://cloud.githubusercontent.com/assets/995160/20294018/1faa9486-aac9-11e6-811c-ad4f99205b13.png)\n\n## Formatting\n\nUse the `--format` option to format the results as a table (this is the default).\n\nRun the following command to the downloads formatted as a table:\n\n```sh\n$ downloads micromatch --format\n```\n\n![image](https://cloud.githubusercontent.com/assets/995160/20294018/1faa9486-aac9-11e6-811c-ad4f99205b13.png)\n\nIf you need to use the results as a JSON object, use the `--format` command with `json` after it:\n\n```sh\n$ downloads micromatch --format json\n```\n\n```json\n[\n  {\n    \"name\": \"micromatch\",\n    \"yesterday\": 298701,\n    \"lastWeek\": 1667018,\n    \"lastMonth\": 7561132,\n    \"total\": 72246952\n  }\n]\n```\n\nThis can be output to a json file using the `bash` `\u003e` character:\n\n```sh\n$ downloads micromatch --format json \u003e micromatch-downloads.json\n```\n\n## Maintainer\n\nTo get downloads for all of the modules maintained by a specific maintainer, use the `--maintainer` or `-m` option:\n\n```sh\n$ downloads --maintainer doowb\n```\n\nThis shows a table with a summary for the maintainer's total counts:\n\n![image](https://cloud.githubusercontent.com/assets/995160/20294121/cfd3aea6-aac9-11e6-93f6-7af233bfd5f1.png)\n\nThe `--format` option will also work with `--maintainer` to return a `json` array of necessary:\n\n```json\n[\n  ...\n  {\"name\": \"micromatch\", \"yesterday\": 298701, \"lastWeek\": 1667018, \"lastMonth\": 7561132, \"total\": 72246952},\n  {\"name\": \"for-in\", \"yesterday\": 302578, \"lastWeek\": 1690801, \"lastMonth\": 7689845, \"total\": 67525375},\n  {\"name\": \"isobject\", \"yesterday\": 312044, \"lastWeek\": 1740065, \"lastMonth\": 7737220, \"total\": 78639385},\n  {\"name\": \"object.omit\", \"yesterday\": 331758, \"lastWeek\": 1861300, \"lastMonth\": 8183602, \"total\": 67385807},\n  {\"name\": \"is-number\", \"yesterday\": 362636, \"lastWeek\": 2010066, \"lastMonth\": 8844787, \"total\": 81522342},\n  {\"name\": \"expand-range\", \"yesterday\": 362678, \"lastWeek\": 2011777, \"lastMonth\": 8856168, \"total\": 79453005},\n  {\"name\": \"braces\", \"yesterday\": 363642, \"lastWeek\": 2016279, \"lastMonth\": 8952292, \"total\": 82014801},\n  {\"name\": \"kind-of\", \"yesterday\": 386582, \"lastWeek\": 2182171, \"lastMonth\": 9699790, \"total\": 106232096},\n  {\"name\": \"is-glob\", \"yesterday\": 404976, \"lastWeek\": 2255831, \"lastMonth\": 9965800, \"total\": 78215744},\n  {\"name\": \"repeat-string\", \"yesterday\": 480270, \"lastWeek\": 2705665, \"lastMonth\": 11891614, \"total\": 107677170},\n  {\"name\": \"window-size\", \"yesterday\": 593891, \"lastWeek\": 3291254, \"lastMonth\": 13714362, \"total\": 141107634}\n]\n```\n\n## About\n\n### Related projects\n\n* [dependents-cli](https://www.npmjs.com/package/dependents-cli): CLI for listing an npm module's dependent projects and their download stats. | [homepage](https://github.com/doowb/dependents-cli \"CLI for listing an npm module's dependent projects and their download stats.\")\n* [downloads](https://www.npmjs.com/package/downloads): Retrieve npm download stats for the specified repository or maintainer. | [homepage](https://github.com/doowb/downloads \"Retrieve npm download stats for the specified repository or maintainer.\")\n* [npm-api](https://www.npmjs.com/package/npm-api): Base class for retrieving data from the npm registry. | [homepage](https://github.com/doowb/npm-api \"Base class for retrieving data from the npm registry.\")\n\n### Contributing\n\nPull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).\n\nPlease read the [contributing guide](contributing.md) for avice on opening issues, pull requests, and coding standards.\n\n### Building docs\n\n_(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_\n\nTo generate the readme and API documentation with [verb](https://github.com/verbose/verb):\n\n```sh\n$ npm install -g verb verb-generate-readme \u0026\u0026 verb\n```\n\n### Running tests\n\nInstall dev dependencies:\n\n```sh\n$ npm install -d \u0026\u0026 npm test\n```\n\n### Author\n\n**Brian Woodward**\n\n* [github/doowb](https://github.com/doowb)\n* [twitter/doowb](http://twitter.com/doowb)\n\n### License\n\nCopyright © 2016, [Brian Woodward](https://github.com/doowb).\nReleased under the [MIT license](LICENSE).\n\n***\n\n_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.2.0, on November 15, 2016._","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoowb%2Fdownloads-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdoowb%2Fdownloads-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdoowb%2Fdownloads-cli/lists"}