aboutsummaryrefslogtreecommitdiff
path: root/README.rst
blob: 5dcf7e214e2d36f62dd59a19519baa54c7a9fb83 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
========
Newspipe
========

Presentation
------------

`Newspipe <https://gitlab.com/newspipe/newspipe>`_ is a web-based news
aggregator and reader.

Main features
-------------

* can be easily deployed on Heroku or on a traditional server;
* multiple users can use a Newspipe instance;
* a RESTful API to manage your articles (or connect your own crawler);
* data liberation: export and import all your account with a JSON file;
* export and import feeds with OPML files;
* favorite articles;
* detection of inactive feeds;
* Pinboard and reddit;
* personal management of bookmarks (with import from Pinboard).

The core technologies are `Flask <http://flask.pocoo.org>`_,
`asyncio <https://www.python.org/dev/peps/pep-3156/>`_ ,
`SQLAlchemy <http://www.sqlalchemy.org>`_
and `React <https://facebook.github.io/react/>`_.

Python >= 3.7.0 is required.


Documentation
-------------

A documentation is available `here <https://newspipe.readthedocs.io>`_ and
provides different ways to
`install Newspipe <https://newspipe.readthedocs.io/en/latest/deployment.html>`_.

Test Newspipe on Heroku:

.. image:: https://www.herokucdn.com/deploy/button.png
    :target: https://heroku.com/deploy?template=https://github.com/newspipe/newspipe.git

It is important to specify an application name and the URL of your instance
(*PLATFORM_URL*) through the Heroku form.


Contributions
-------------

Contributions are welcome. If you want to contribute to Newspipe I highly
recommend you to install it in a Python virtual environment. For example:


.. code-block:: bash

    sudo apt-get install postgresql npm

It seems that today a proof of good taste is to install first
`pyenv <https://github.com/pyenv/pyenv>`_,
then `pipsi <https://github.com/mitsuhiko/pipsi>`_, and finally
`pew <https://github.com/berdario/pew>`_ and
`pipenv <https://github.com/pypa/pipenv>`_ with pipsi.

.. code-block:: bash

    git clone https://gitlab.com/newspipe/newspipe.git
    cd newspipe/
    pipenv install
    ✨🍰✨
    npm install
    cp src/conf/conf.cfg-sample src/conf/conf.cfg
    pipenv shell
    python src/manager.py db_create
    python src/runserver.py
      * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)


License
-------

`Newspipe <https://gitlab.com/newspipe/newspipe>`_ is under the
`GNU Affero General Public License version 3 <https://www.gnu.org/licenses/agpl-3.0.html>`_.


Contact
-------

`Cédric Bonhomme <https://www.cedricbonhomme.org>`_
bgstack15