Home

Awesome

NewsBlur

<a href="https://f-droid.org/repository/browse/?fdid=com.newsblur" target="_blank"> <img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="80"/></a> <a href="https://play.google.com/store/apps/details?id=com.newsblur" target="_blank"> <img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="80"/></a>

   <a href="https://apps.apple.com/us/app/newsblur/id463981119"><img src="https://tools.applemediaservices.com/api/badges/download-on-the-app-store/black/en-us?size=250x83" alt="Download on the Apple App Store" height="55"></a>

Features

  1. Shows the original site (you have to see it to believe it).
  2. Hides stories you don't want to read based on tags, keywords, authors, etc.
  3. Highlights stories you want to read, based on the same criteria.

Technologies

Server-side

Client-side and design

Prerequisites

* Docker
* Docker-compose

Installation Instructions

  1. Clone this repo

  2. Run make nb to build all of the NewsBlur containers. This will set up all necessary databases, front-end django apps, celery tasks, node apps, flask database monitor and metrics, nginx, and a haproxy load balancer.

  3. Navigate to:

     https://localhost
    

    Note: You will be warned that you are using a self signed certificate. In order to get around this warning you must type "thisisunsafe" as per this blog post.

Using a custom domain

  1. Run the custom domain script

    bash ./utils/custom_domain.sh <domain name>
    

    This script will do the following:

    • Change NEWSBLUR_URL and SESSION_COOKIE_DOMAIN in newsblur_web/docker_local_settings.py
    • Change the domain in config/fixtures/bootstrap.json

You can also change domains: bash ./utils/custom_domain.sh <old domain> <new domain>

  1. If you're using a custom subdomain, you'll also want to add it to ALLOWED_SUBDOMAINS in apps/reader/views.py

  2. A way to make sure you updated all the correct places:

    • Go to the website address in your browser
    • Open developer tools and look at the network tab
    • Try to login
    • Look again at the developer tools, there should be a POST call to /login
    • Observe the Response headers for that call
    • The value of the "set-cookie" header should contain a "Domain=" string

    If the string after Domain= is not the domain you are using to access the website, then your configuration still needs your custom domain.

    You can also confirm that there is a domain name mismatch in the database by running make shell & typing Site.objects.all()[0] to show the domain that NewsBlur is expecting.

Making docker-compose work with your existing database

To make docker-compose work with your database, upgrade your local database to the docker-compose version and then volumize the database data path by changing the ./docker/volumes/ part of the volume directive in the service to point to your local database's data directory.

To make docker-compose work with an older database version, change the image version for the database service in the docker-compose file.

Contribution Instructions

Running unit and integration tests

NewsBlur comes complete with a test suite that tests the functionality of the rss_feeds, reader, and feed importer. To run the test suite:

`make test`

Running a performance test

Performance tests use the locust performance testing tool. To run performance tests via CLI, use make perf-cli users=1 rate=1 host=https://localhost. Feel free to change the users, rate, and host variables in the command to meet you needs.

You can also run locust performance tests using a UI by running make perf-ui and then navigating to http://127.0.0.1:8089. This allows you to chart and export your performance data.

To run locust using docker, just run make perf-docker and navigate to http://127.0.0.1:8089

Author

License

NewsBlur is licensed under the MIT License. (See LICENSE)