Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/djadmin/medium-cli

Medium for Hackers - :computer: A CLI for Medium Stories.
https://github.com/djadmin/medium-cli

Last synced: 5 days ago
JSON representation

Medium for Hackers - :computer: A CLI for Medium Stories.

Host: GitHub
URL: https://github.com/djadmin/medium-cli
Owner: djadmin
Created: 2016-01-21T22:53:36.000Z (almost 9 years ago)
Default Branch: master
Last Pushed: 2024-09-09T09:58:48.000Z (4 months ago)
Last Synced: 2025-01-03T10:01:58.605Z (12 days ago)
Language: JavaScript
Size: 168 KB
Stars: 716
Watchers: 14
Forks: 52
Open Issues: 36
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md

Awesome Lists containing this project

awesome-cli-apps - medium-cli - Read [medium.com](https://medium.com/) stories. (Entertainment / Books)
fucking-awesome-cli-apps - medium-cli - Read 🌎 [medium.com](medium.com/) stories. (Entertainment / Books)
jimsghstars - djadmin/medium-cli - Medium for Hackers - :computer: A CLI for Medium Stories. (JavaScript)

README

        medium-cli [![npm version](https://badge.fury.io/js/mediumcli.svg)](https://www.npmjs.com/package/mediumcli) [![npm](https://img.shields.io/npm/dt/mediumcli.svg)](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.

![](http://i.imgur.com/nO3RyMT.gif)

Installation

------------

`$ npm install -g mediumcli`

Docs

----

    Usage: medium [options] [command]

    Commands:

    top [options]                           lists Medium Top Stories

    tag [options]                      lists trending Medium Stories by tag

    author [options]                lists Medium Stories by author

    search|s [options]      searches for stories

    read                               reads the story right in your terminal

    open [options]                     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 , specify number of stories

    tag [options]

    -n, --number   specify number of stories

    -l, --latest        get latest instead of trending 

    author [options]

    -n, --number , specify number of stories

    search|s [options] 

    -n, --number   specify number of stories

    open [options] 

    -a, --app   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 `

Read the story right in your terminal

#### open command

`$ medium open `

Opens it in your browser

`$ medium open -a firefox `  

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).