aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: ca03af710ff759c517576656ecb984e836430d2d (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
# Newspipe

## Presentation

[Newspipe](https://git.sr.ht/~cedric/newspipe) is a web-based news
aggregator and reader.

For reporting issues, visit the tracker here:
https://todo.sr.ht/~cedric/newspipe

For contributions the list is here:
https://lists.sr.ht/~cedric/newspipe

## Main features

* easy to deploy;
* multiple users can use a Newspipe instance;
* an API to manage your feeds (you can connect your own crawler);
* data liberation: export and import your account with a JSON file;
* export and import feeds with OPML files;
* search and favorite articles;
* detection of inactive feeds;
* share on Pinboard and reddit;
* 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).


## Deployment

### Requirements

```bash
$ sudo apt-get install postgresql npm
```

##  Configure and install the application

```bash
$ git clone https://git.sr.ht/~cedric/newspipe
$ cd newspipe/
$ poetry install
$ npm install
$ cp newspipe/conf/conf.cfg-sample newspipe/conf/conf.cfg
$ poetry shell
$ python newspipe/manager.py db_create
$ python newspipe/runserver.py
  * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
```

## License

[Newspipe](https://git.sr.ht/~cedric/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