||6 months ago|
|.github||6 months ago|
|hackertray||2 years ago|
|test||2 years ago|
|.editorconfig||8 years ago|
|.gitignore||2 years ago|
|.travis.yml||2 years ago|
|CHANGELOG.md||2 years ago|
|LICENSE||2 years ago|
|MANIFEST.in||9 years ago|
|README.md||2 years ago|
|screenshot.png||9 years ago|
|setup.py||2 years ago|
HackerTray is a simple Hacker News Linux application that lets you view top HN stories in your System Tray. It uses appindicator where available, but provides a Gtk StatusIcon fallback in case AppIndicator is not available.
The inspiration for this came from Hacker Bar, which is Mac-only.
HackerTray is distributed as a python package. Do the following to install:
sudo pip install hackertray OR sudo easy_install hackertray OR #Download Source and cd to it sudo python setup.py install
After that, you can run
hackertray from anywhere and it will run. You can
now add it to your OS dependent session autostart method. In Ubuntu, you can
access it via:
- System > Preferences > Sessions (OR)
- System > Preferences > Startup Applications
depending on your Ubuntu Version. Or put it in
if you are running OpenBox. Here is how the
configuration should look like in Ubuntu and its derivatives.
You can check which version you have installed with
To upgrade, run
pip install -U hackertray. In some cases (Ubuntu), you might
need to clear the pip cache before upgrading:
sudo rm -rf /tmp/pip-build-root/hackertray
HackerTray will automatically check the latest version on startup, and inform you if there is an update available.
HackerTray accepts its various options via the command line. Run
hackertray -h to see all options. Currently the following switches are supported:
-c: Enables comments support. Clicking on links will also open the comments page on HN. Can be switched off via the UI, but the setting is not remembered.
--chrome PROFILE-PATH: Specifying a profile path to a chrome directory will make HackerTray read the Chrome History file to mark links as read. Links are checked once every 5 minutes, which is when the History file is copied (to override the lock in case Chrome is open), searched using sqlite and deleted. This feature is still experimental.
--firefox PROFILE-PATH: Specify path to a firefox profile directory. HackerTray will read your firefox history from this profile, and use it to mark links as read. Pass
autoas PROFILE-PATH to automatically read the default profile and use that.
-r). Switches the order for the elements in the menu, so Quit is at top. Use this if your system bar is at the bottom of the screen.
Note that the
--firefox options are independent, and can be used together. However, they cannot be specified multiple times (so reading from 2 chrome profiles is not possible).
Google Chrome Profile Path
Where your Profile is stored depends on which version of chrome you are using:
- [Chrome Stable]
- [Chrome Beta]
- [Chrome Dev]
Profile 2 or so on if you use multiple profiles on Chrome. Note that the
--chrome option accepts a
PROFILE-PATH, not the History file itself. Also note that sometimes
~ might not be set, so you might need to use the complete path (such as
Firefox Profile Path
The default firefox profile path is
* denotes a random 8 digit string. You can also read
~/.mozilla/firefox/profiles.ini to get a list of profiles. Alternatively, just pass
auto and HackerTray will pick the default profile automatically.
- Minimalist Approach to HN
- Opens links in your default browser
- Remembers which links you opened, even if you opened them outside of HackerTray
- Shows Points/Comment count in a simple format
- Reads your Google Chrome/Firefox History file to determine which links you've already read (even if you may not have opened them via HackerTray)
If the app indicator fails to show in Ubuntu versions, consider installing python-appindicator with
sudo apt-get install python-appindicator
Note that appindicator is no longer supported in non-Ubuntu distros, because it only works on Python2.
To develop on hackertray, or to test out experimental versions, do the following:
- Clone the project
(sudo) python setup.py developin the hackertray root directory
hackertraywith the required command line options from anywhere.
On every launch, a request is made to
https://pypi.python.org/pypi/hackertray/json to check the latest version.
No more tracking. All data every collected for this project has been deleted. You can see the wiki for what all was collected earlier (Version
- Mark Rickert for Hacker Bar (No longer active)
- Giridaran Manivannan for troubleshooting instructions.
- @cheeaun for the Unofficial Hacker News API
Licenced under the MIT Licence. See the LICENSE file for complete license text.