simply-hg / delirious

Delirious° is a Javascript client for the feed reader Fever° by Shaun Inman. It is started, because a mobile interface for Fever° is not coming to Android any time soon.
3 stars 2 forks source link

Delirious°

Delirious° is a Javascript client for the feed reader Fever by Shaun Inman. It is started, because a mobile interface is not coming to Android any time soon. While there is Meltdown, an excellent native client on Android, it currently does not show Hot items. And what about all those other plattforms like Windows Phone, BB10, Firefox OS? If this project gets it right, they all benefit from a nice and usable fever-client for the mobile world. Delirious° is designed to run in any browser out there.

Delirious° is based on jQuery Mobile, undescore.js and jStorage. It hasn't been fully tested for browser compatibility. It works on Dolphin (with Jetpack), Chrome on Android and on the desktop version of Firefox. There are still bugs but all in all I find it working quite ok - it hasn't been aggressively tested, though.

You may be interested in screenshots. You can find them on my personal site with more information on Delirious°.

How to download and run it

Download this repo as .zip file and unpack it on your server which runs your installation of Fever° installation. If possible, Delirious° should get its own directory. As far as I can tell, it needs to be on the same domain as your Fever° installation.

All files offered in this repository are considered open source and are licensed by MIT terms.

Delirious°: A small introduction

Call the directory you unpacked the files into with your browser. You should now see a dialog screen, which leads you to your settings. There you can fill in your server and user credentials. Save them and you will be forwarded to the homescreen. To show favicons please click the button refresh favicons. They are cached and survive a restart of the app. If Delirious° does not show your groups or behaves strange, please reload it. Now everything should work fine. You can customize your homescreen and show different buttons or put content blocks to a different position.

Delirious° has to load a good amount of data (unread items) from your server. Due to limitations of the Fever API, we have to load at least all unread items including their contents to do anything useful. Depending on how many items are being loaded you will have to wait some moments before all items are shown in your groups. Hot link items get loaded seperately and on demand.

You should now see your custom groups. Fever° signature feature, Hot items work very well ith Delirious°. It shows your hot items with their respective links. You can adjust the range of your hot links and you can also load more. Items that are also in your Fever° database do show a bit more of their content. You can see unread items in your groups and you can mark a whole group as read.

Of course the usual warnings apply: This software comes with no guarantees. It might fry your phone, server and anything else. Please report any bugs you encounter. I want add this as well: Fever°s very own API should take care of user authentification and not return anything, when an unauthorised user tries to access your content. This is being checked for. An attacker might still be able to find a security breach, so be careful when using this app.

Feature list

Change log