README.md 3.44 KB
Newer Older
1
# Pétrolette
yPhil's avatar
yPhil committed
2

yPhil's avatar
yPhil committed
3
*RSS/Atom morning news reader ; Works at night too.*
yPhil's avatar
yPhil committed
4

yPhil's avatar
yPhil committed
5
---
yPhil's avatar
yPhil committed
6

yPhil's avatar
yPhil committed
7
[![pipeline status](https://framagit.org/yphil/petrolette/badges/master/pipeline.svg)](https://framagit.org/yphil/petrolette/-/pipelines)
8
[![License GPLv3](https://img.shields.io/badge/license-GPL_v3-green.svg)](http://www.gnu.org/licenses/gpl-3.0.html)
yPhil's avatar
yPhil committed
9
[![Liberapay](https://framagit.org/yphil/petrolette/-/pipelineshttps://img.shields.io/badge/donate-Liberapay-yellow.svg)](https://liberapay.com/yPhil/donate)
yPhil's avatar
yPhil committed
10
[![PayPal Donate](https://img.shields.io/badge/donate-PayPal.me-ff69b4.svg)](https://www.paypal.me/yphil)
yPhil's avatar
yPhil committed
11

yPhil's avatar
yPhil committed
12
![Pétrolette](https://framagit.org/yphil/assets/-/raw/main/img/petrolette.png)
yPhil's avatar
yPhil committed
13

yPhil's avatar
yPhil committed
14
[Pétrolette Official website](http://petrolette.space)
yPhil's avatar
yPhil committed
15

16
Read about it in French [ici](https://linuxfr.org/users/philippemc/journaux/decollage-de-la-petrolette-de-l-espace) ; Test instance [here](http://petrolette.space/).
yPhil's avatar
yPhil committed
17

18
## Pétrolette is a track-free online news reader
19

20
[Pétrolette](http://takeoff.petrolette.space/) is a #paranoid news reader : home page, usable **right away** (no installation, no registration, nothing) **totally free of charge**. It doesn’t ask you to register or create any sort of account, and won’t even ask your name. What you are reading is nobody’s (and certainly not GAFAM’s) business.
21
22
23
24
25
26
27
28

- Add your sources ([exemple of a source](https://hackernoon.com/feed)) ;
- Organize them by creating groups and dragging & droppin’ sources in them ;
- If you don’t know the address/location of the source, just enter a URL like “http://www.nytimes.com” and Pétrolette will search the NYT domain and find its source: (it’s http://www.nytimes.com/services/xml/rss/nyt/HomePage.xml) ;
- If you don’t have an URL, **you can even enter any term**, like "bitcoin crash" or "Zombie outbreak" and Pétrolette will build a "search source" that gets updated every time something happens.
- Check the code, it’s #open.

Pétrolette is a fantastic #news monitoring tool. Do you have researches to make, do you need to monitor tens of video channels, or you need your animals, flowers, all things nature hi-res pictures fix very day? Do you know that [NASA publishes tons of sources](https://www.nasa.gov/content/nasa-rss-feeds#what)?
yPhil's avatar
yPhil committed
29

30
31
32
Pétrolette helps you discover new sources of information ; you read it everyday on your desktop or your phone/whatnot, this is your. Private News. Portal.

Pétrolette is given to you by the Free, Libre & Open-Source movement. I worked months on it (well, I needed it in the 1st place, I use it every hour of every day) and now I’m offering it to you ; [HELP me make it even better](https://liberapay.com/yPhil/donate) (yes, it’s possible) !!
yPhil's avatar
yPhil committed
33

yPhil's avatar
yPhil committed
34
35
36
### Installation

```sh
yPhil's avatar
yPhil committed
37
git clone https://framagit.org/yphil/petrolette
yPhil's avatar
yPhil committed
38
39
40
cd petrolette
npm install
npm start
yPhil's avatar
yPhil committed
41
xdg-open http://localhost:8000
yPhil's avatar
yPhil committed
42

yPhil's avatar
yPhil committed
43
44
45
46
47
```
#### Testing

```javascript
npm test
yPhil's avatar
yPhil committed
48
```
yPhil's avatar
yPhil committed
49

yPhil's avatar
yPhil committed
50
### LICENSE
yPhil's avatar
yPhil committed
51

yPhil's avatar
yPhil committed
52
53
54
55
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
yPhil's avatar
yPhil committed
56

yPhil's avatar
yPhil committed
57
58
59
60
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
yPhil's avatar
yPhil committed
61

yPhil's avatar
yPhil committed
62
63
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.
yPhil's avatar
yPhil committed
64

yPhil's avatar
yPhil committed
65
*Icon by yPhil*
yPhil's avatar
yPhil committed
66

yPhil's avatar
yPhil committed
67
---