Settings

The Feedability configuration settings are stored as a JSON file named settings.json in the application directory. It is possible and currently recommended to create a user_settings.json file to overwrite the default settings, this way there is no need to merge the settings file after the git version changes.

http_server

The HTTP server/proxy has currently no user authentication you can use the bind setting to restrict the server to the local network or loopback device (as it is per default).

• bind: IP address or hostname the server should listening on (use 0.0.0.0 for all interfaces) (Default: 127.0.0.1)
• port: The port the server is listening for, use port numbers greater than 1024 (or use iptables) (Default: 1912)
• banner: The response header (Server:) the server is sending to identify itself (Default: Feedability/0)

http_client

The HTTP client is used to fetch the feed and articles.

• headers: Contains a array of request headers that are used. Default:

"User-Agent": "Feedability/0", 
"Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
"Accept-Language": "en-us,en;q=0.5",
"Accept-Charset": "ISO-8859-1,utf-8;q=0.7,*;q=0.7",
"Pragma": "no-cache"

feed_parser

The feed parser is subject to change and is not included in documentation.

filter

The filter is used to strip specific elements from the article html that are known to be causing false positive matches of main content by readability. It is currently one of the slowest parts of readability, but it is only used when matching filters are present.

activate: Set to false to deactivate the filter (Default: true)
jquery_url: The url to jquery that is used to create a context for selecting elements (Default: http://code.jquery.com/jquery-1.4.2.min.js)
jquery_filters: Array of filter rules, the keys are used to match with the url of the articles to filter. The value is a array of jQuery Selectors used to determine the elements to be removed. Example:
bc. “jquery_filters”: {
“sixserv.org”: [“#sidebar”, “.commentlist”]
}

For a short tutorial on how to create filter rules read Filter Tutorial.

cache

Read the developer documentation on Caching for more information.

path: Specify a directory feedability should store cache files. It gets created at startup if it does not exist (Default: ./cache)