djadmin/medium-cli

README

medium-cli

Medium for Hackers - A CLI for reading Medium 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.

License