mediumcli
Version:
Medium for Hackers - A CLI to Medium Stories
110 lines (68 loc) • 2.77 kB
Markdown
medium-cli [](https://www.npmjs.com/package/mediumcli) [](https://www.npmjs.com/package/mediumcli)
==========
Medium for Hackers - A CLI for reading [Medium](https://medium.com) Stories.
It helps you read awesome medium articles right in your terminal.

Installation
------------
`$ npm install -g mediumcli`
Docs
----
Usage: medium [options] [command]
Commands:
top [options] lists Medium Top Stories
tag [options] <tag> lists trending Medium Stories by tag
author [options] <author> lists Medium Stories by author
search|s [options] <searchTerms...> searches for stories
read <url> reads the story right in your terminal
open [options] <url> opens it in your browser
Options:
-h, --help output usage information
-V, --version output the version number
-o, --open open story in browser
-m, --markdown render selected story as markdown in the terminal
top [options]
n, --number <int>, specify number of stories
tag [options]
-n, --number <int> specify number of stories
-l, --latest get latest instead of trending
author [options]
-n, --number <int>, specify number of stories
search|s [options] <searchTerms...>
-n, --number <int> specify number of stories
open [options] <url>
-a, --app <application> specify app to open the url. Eg: firefox
Usage
-----
The commands available are: `medium top`, `medium read`, `medium open` and more..
#### top command
`$ medium top`
List Medium Top Stories
`$ medium top -n 5`
List only top 5 Medium Stories
#### read command
`$ medium read <url>`
Read the story right in your terminal
#### open command
`$ medium open <url>`
Opens it in your browser
`$ medium open -a firefox <url>`
Opens it in the given application, like it opens the url using firefox in above example.
#### Also, you can search by **Author, Tags or Keyword**
`$ medium author _ericelliott`
`$ medium tag javascript`
`$ medium tag javascript --latest`
`$ medium search security`
#### Another Example
`$ medium author dheerajhere --open` will open the selected story in browser
Issues
------
Feel free to submit issues and enhancement requests.
Contributing
------------
medium-cli is written in NodeJs and would love to accept pull requests for any issues or feature request.
[Read more on contributing](./CONTRIBUTING.md).
License
-------
Copyright (c) 2017 Dheeraj Joshi
Licensed under the [MIT license](http://opensource.org/licenses/MIT).