blob: 792c7ca19d02878ac874d35b0f107529fa4685e1 (
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://github.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;
* share articles with Google +, 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.6.6 is recommended.
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://github.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://github.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>`_
|
