A personal track-free online RSS news reader
PHP CSS ApacheConf
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
img
libs
.gitignore
.htaccess
README.org
feeds.xml
index.php
nws-clean-cache.php
nws-favicon.php
nws-load-feed.php
nws-manage.php
nws-style.css
screenshot.png

README.org

NWS

NWS is an online news reader

NWS is a php CMS to manage various XML (RSS, aTom, etc) news feeds and present them in a nice, ergonomic fashion. I made it to replace the online news services that I use up until around 2007, when they became bloated and crippled with spyware. It’s really a barebones system, but I’ve been using it for weeks years now, and it basically does what I want.

Features

  • AJAX (asynchronous) loading of the feeds (ie reload one single feed w/o reloading the whole page)
  • Handles any charset encoding/langage
  • Grabs the most out of the description text and displays it as standard tooltip on mouse hover
  • Does its best to parse any given feed and identify it w/o questions
  • Plays nice with different resolutions & ergonomics, ie phones, tablets, etc
  • Directly links to any included image (and sound file)
  • If any, displays item image, wrapped around text (displays it full width if it’s the only item’s element, or if it comes from a photoblog - set those up here)
  • Totally self-contained. No linked librairies, online commodities or, heaven forbid, “statistics” trackers
  • Lightweight and standard (valid HTML5 code)

Installation

  • Copy the files in a directory within a webserver root.
  • Point your browser to that webserver’s directory. That’s it.
  • Oh, if you want to use the favicon caching feature (those favicons can take a loong time to get) make sure that the web server has the right to write to our directory:
    • On the average web server (Debian / Apache) it’s generally just a matter of, in the root folder: ‘sudo chown .www-data .’
  • or create it yourself : sudo mkdir favicon_cache/ (NWS works perfectly w/o caching, only a little less fast)
  • Recommended : Protect (restrict access to) the back-office
    • Use a trusted online htpassword generator (You can also create user/password pair(s) directly on the server with the command “htpasswd -b .access username password”)
    • Paste this user/password pair in a file, and upload it as nws/.access (or another - secure - location, see below)
    • Optional : Move the .access out of the http server root, and edit .htaccess to reflect this change.

Usage

  • Navigate the tabs with < left and > right arrow keys (and r & t)
  • Click the big “►” to view all tabs’s images in a gallery
  • Click the small, item’s “►” to view all feed’s images in a gallery
    • Navigate the gallery’s images with < left and > right arrow keys
    • Exit the gallery by clicking outside it, or pressing the ESC key
  • Use the “Manage feeds” link to access the “back office”
    • Use the “add a new feed” text entry field at the bottom to enter a new feed
    • Use the “new tab” text entry field to create a new category
    • Use the “change this feed’s tab” menu to re-categorize the feed
    • Use the “promote this feed” (^) link to bump up a feed as 1st of its tab
    • Use the “delete this feed” (x) link to delete a feed
  • Or directly edit feeds.xml (way faster).
  • Use “Pin tab” in your browser to prevent tab clutter
  • Use Back is close to quickly go back to where you were

LICENSE

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.