Coder Social home page Coder Social logo

pocket-on-term's Introduction

pocket-on-term

Build Status Pocket client in terminal

Installation

Currently only from github:

$ pip install git+https://github.com/jaduse/pocket-on-term

Usage:

Firstly, register new application at http://getpocket.com/developer. You will obtain consumer key, which is important to run this application. Then config your pot.py:

$ pot set pocket consumer_key YOUR_KEY_GOES_HERE
$ pot init

Well, after granting access, you can do whatever you want. Actualy... no.

List articles

Simple list articles by given criterie. Using command get:

$ pot get _state_ _count_ [-t _tag_] [-f] [-s _sort_by_] [-o _offset_]
[0] Article
.
.
.
[_count_] Another article

$ pot get unread 5 -t programming -o 5 # so, you want 5 unread articles, with "programming" tag, and you want start from fifth article. So you want 5 articles that come after article 5, so you get articles 6, 7, 8, 9 and 10. 

Read article

Read one of listed articles by given index from last output:

$ pot read _id_

Reader gui will appear. Controls are easy. Up, Down, Page Up, Page Down, Home and End. You can see links indexed like [5] by pressing "r". Popup will show up with link list. Press "q" to close.

Archive article

Archiving one or many articles by given index from last output:

$ pot archive _ids_
example:
$ pot archive 0 1 2 3
Success!

You can easily archive more articles

Add article

Add an article to your list:

$ pot add _url_
OK - _resolved_title_

Delete article

Delete an article from your list. Permanently:

$ pot delete 5
Success!

Readding article

Revive an article from archive:

$ pot readd 5
Success!

Favorite/Unfavorit article

Make your article favorited. Or take it's favoritness away:

$ pot favorite 5 6
$ pot unfavorite 6

Tags!

Tagging your articles. Examples:

$ pot tag add 1 5 6 --tags rekt smashing_tag puppets
$ pot tag remove 1 --tags rekt
$ pot tag replace 6 --tags kittens
$ pot tag clear 5

Your homework: figure out, what each command does :)

LICENSE

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pocket-on-term's People

Contributors

tcpj avatar

Stargazers

Dave Konopka avatar somename123 avatar Jakub avatar

Watchers

James Cloos avatar  avatar Jakub avatar

pocket-on-term's Issues

Not works with Python2

Since python is on arch linked with python3, users reports that their python with python2 not works.

Possible tiny reader GUI

Maybe add small tiny Qt reader gui with same controls as current reader except References window. It could be more confortable to read with images.

Show urls in output

Add --url parameter to get command for printing url of articles for simple sharing

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.