Reader YC is a native hackernews client built with Cascades and Python (using Blackberry-tart). Instead of using often unstable APIs, this app directly scrapes Hackernews for posts, and optionally comments, to ensure maximum uptime. Currently the app is at V1.5.4 (don't usually update the readme), and is available on BlackBerry World
To fetch comments, the user has a choice to either use BeautifulSoup scraping or the HN Search API. The api is much faster, so I recommend it. However it can be unreliable, and doesn't sort comments properly until a few days after the post was submitted. Since 1.5, the scraping is faster and works better. A setting to enable Legacy Scraping can be found within the app.
An up to date signed BAR file is almost always available at this repo.
I recommend you use virtualenv for this, makes the process much easier
`pip install bs4`
`pip install requests`
`pip install /path/to/bbtart/`
The bbtart package is available on my github.
Steps to build:
Since making bbtart an installable package, building is a lot easier.
First Step First create a root directory, I called mine 'apps', then
Install Blackberry Tart To do this you'll need to download the bbtart package here
REQUEST DEBUG TOKEN BAR FILE
blackberry-debugtokenrequest -storepass STOREPASS -devicepin DEVICEPIN debugtoken.bar
note: the storepass is the password you used to first register for debug tokens with RIM
BUILD DEBUG BAR:
after installing bbtart with pip, run
packager.py package -mdebug
BUILD RELEASE BAR:
Same as above, except specify the
-mrelease flag after
SIGN BAR FILE IF RELEASE:
blackberry-signer -storepass STOREPASS NAMEOFBAR
INSTALL APP TO DEVICE:
blackberry-deploy -installApp -password DEVICEPASS -device DEVICEIP -package NAMEOFBAR
I've defined an INI file called deploy.ini, where you can set up all your parameters for building/installing.
Then install becomes a one liner:
packager.py deploy -c path/to/deploy.ini
I've uploaded my deploy.ini file, which describes all the parameters.
NOTE: The bars will be placed in the current directory
- Get the main hackernews pages in a nice tabbed format
- Infinite scrolling
- View articles, comments, and text posts
- Different sections of the apps accessible by tabs
- Threading of all requests
- Login, and edit profile
- View about/help pages, email the dev (me)
- Select method to retrieve comments with
- Post comments to any story
- Active frame showing recent stories
- Settings to always open in browser, and to use reader mode
- Clear cached stuff (No clue why you'd want to)
- Post stories
- Favourite posts to save for later
- dark theme
Huge thanks to all the developers of The BBPY project (Peter Hansen, Xitij Ritesh Patel, etc.) and special thanks to Jerónimo Barraco for helping with the comment API.