Ecosyste.ms: Awesome

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

https://github.com/pkrumins/hacker-top

A top-like program for monitoring hacker news from the console
https://github.com/pkrumins/hacker-top

Last synced: 16 days ago
JSON representation

A top-like program for monitoring hacker news from the console

Lists

README 

        
This is the Hacker Top program. It's a top-like program for monitoring stories

on hacker news (news.ycombinator.com) from the console.



It was written by Peteris Krumins ([email protected]).

His blog is at http://www.catonmat.net  --  good coders code, great reuse.



The code is licensed under the GNU GPL license.



The code was written as a part of the article "Follow Hacker News from the

Console" on my website. The whole article can be read at:



    http://www.catonmat.net/blog/follow-hacker-news-from-the-console/



I explained some parts of the code in this program in another article "How

Reddit Top and Hacker Top Programs Were Made". It can be read here:



http://www.catonmat.net/blog/how-reddit-top-and-hacker-top-programs-were-made/



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



Table of contents:



    [1] The Hacker Top program.

    [2] Program's usage.

    [3] Keyboard shortcuts.

    [4] Future TODO improvements.



[1]-The-Hacker-Top-program----------------------------------------------------



This program monitors the Hacker News website ( http://news.ycombinator.com )

for hacker stories and displays them in the console via ncurses.



The program is written in Python programming language and is supposed to

be run on Unix type operating systems, such as Linux.



It uses one external Python module - BeautifulSoup - for parsing HTML.

BeautifulSoup can be downloaded from http://crummy.com/software/BeautifulSoup

or via `easy_install beautifulsoup` 



See my original article for a screenshot:



    http://www.catonmat.net/blog/follow-hacker-news-from-the-console/



[2]-Hacker-Top-usage----------------------------------------------------------



Usage: ./hacker_top.py [-h|--help] - displays help message



Usage: ./hacker_top.py [-i|--interval interval]

          [-u|--utf8 ] [-U|--url ] [-n|--new]



    -i or --interval specifies refresh interval.

    The default refresh interval is 3 minutes. Here are a few

    examples:  10s (10 seconds), 12m (12 minutes), 2h (2 hours). 



    -u or --utf8 turns on utf8 output mode.

    Default: off. Use this if you know for sure that your

    terminal supports it, otherwise your terminal might turn into garbage.



    -U or --url turns on printing of urls.



    Default: off



    -n or --new follows only the newest hacker stories.

    Default: follow front page stories.



[3]-Keyboard-shortcuts--------------------------------------------------------



q - quits the program.

u - forces an update of the stories.

m - changes the display mode.

up/down arrows (or j/k) - scrolls the news list up or down.



Beta shortcuts:

o - open the topmost URL in the default webbrowser

t - open the topmost URL in a new tab in the default webbrowser

c - open the topmost URL's comments in the default webbrowser



[4]-Future-TODO-improvements--------------------------------------------------



* Fix it to work on Windows. (Perhaps try the Console module)



* Merge it with "Reddit Top" program (see below) and create "Social Top"

  program. Then write plugins for Digg, and other websites.



  Reddit Top is here (currently broken, will fix on Sunday 2009.11.29):

  http://www.catonmat.net/blog/follow-reddit-from-the-console/



* Add ability to login and vote for the favorite stories.



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



Have fun using it!



Sincerely,

Peteris Krumins

http://www.catonmat.net