> Your favorite *news* (RSS feed) directly from your [*LaMetric*](https://store.lametric.com/?rfsn=853404.8b38b6) 🎩

[![Travis](https://img.shields.io/travis/rust-lang/rust.svg)](https://travis-ci.org/FGRibreau/rss-to-lametric) [![codecov](https://codecov.io/gh/FGRibreau/rss-to-lametric/branch/master/graph/badge.svg)](https://codecov.io/gh/FGRibreau/rss-to-lametric)
[![Cargo version](https://img.shields.io/crates/v/rss-to-lametric.svg)](https://crates.io/crates/rss-to-lametric) [![Crates.io](https://img.shields.io/crates/l/rss-to-lametric.svg)](https://crates.io/crates/rss-to-lametric) [![Crates.io](https://img.shields.io/crates/d/rss-to-lametric.svg)](https://crates.io/crates/rss-to-lametric) [![Slack](https://img.shields.io/badge/Slack-Join%20our%20tech%20community-17202A?logo=slack)](https://join.slack.com/t/fgribreau/shared_invite/zt-edpjwt2t-Zh39mDUMNQ0QOr9qOj~jrg)

<p align="center">
  <a href="http://bit.ly/2zyD4SA">
  <img src="https://media.giphy.com/media/3ohs7VLXzJNpgZNtPG/giphy.gif"/>  
  </a>
</p>


## 📱 LaMetric apps

### French news

- 🇫🇷 [Ouest-France 👌](http://bit.ly/2zyD4SA)
- 🇫🇷 [Actu.fr](http://bit.ly/2lQ7TfO)
- 🇫🇷 [Presse Ocean](http://bit.ly/2zxGZiN)
- 🇫🇷 [Voiles Et Voiliers](http://bit.ly/2lQ2Bkm)
- 🇫🇷 [Courrier de l'Ouest](http://bit.ly/2lRj5so)

### World news

- 🇺🇸 [New York Times](http://bit.ly/2yuBMYO)
- 🇺🇸 [Washington Post](http://bit.ly/2zdXQq8)
- 🇬🇧 [The Guardian](http://bit.ly/2y0bXvA)
- 🇩🇪 [Der Spiegel](http://bit.ly/2hb0ia1)

### Tech/Startup

- 🇫🇷 [BFM Business](http://bit.ly/2zeGdGZ)
- 🇺🇸 [Tech Crunch](http://bit.ly/2ze84qM)
- 🇺🇸 [Mashable](http://bit.ly/2hc9fQn)
- 🇺🇸 [Lifehacker](http://bit.ly/2xZbc5H)
- 🇺🇸 [Engadget](http://bit.ly/2lRyRTZ)


<p align="center">
  <a href="http://bit.ly/2zyD4SA">
  <img src="/docs/lametric-app.jpg"/>  
  </a>
</p>

## ⏲ Setup

```bash
cargo install rss-to-lametric
```


## 🤓 Self-documentation

```bash
rss-to-lametric
curl --silent http://localhost:8080/
```

```json
{
  "description": "🛫 Fastest way to expose a RSS feed to your LaMetric - https://store.lametric.com/?rfsn=853404.8b38b6 🎩",
  "homepage": "https://github.com/FGRibreau/rss-to-lametric",
  "name": "rss-to-lametric",
  "usage": [
    {
      "path": "/convert?<query>",
      "query": {
        "icon": "icon number, e.g. i14532",
        "limit": 10,
        "title": "title of your feed",
        "url": "http://my-domain.com/my-rss.xml"
      }
    }
  ],
  "version": "0.1.0"
}
```

## 🎩 Convert any RSS to LaMetric `TextFrame`

```bash
curl --silent "http://localhost:8080/convert?title=Ouest-France&icon=i14532&limit=3&url=https://www.ouest-france.fr/rss-en-continu.xml"
```

```json
{
  "frames": [
    {
      "text": "Ouest-France",
      "icon": "i14532"
    },
    {
      "text": "France. Des personnalités signent contre les agressions sexuelles",
      "icon": null
    },
    {
      "text": "NRJ Music Awards. Qui sont les gagnants de la soirée ?",
      "icon": null
    },
    {
      "text": "Des dizaines de morts dans un attentat de Daech en Syrie",
      "icon": null
    }
  ]
}
```

## ⚙️ Deployment 
- Deploy it (the fastest way is to use [Clever-cloud](https://www.clever-cloud.com/doc/rust/rust/) thanks to their awesome native Rust support)
- [Create and configure your app](http://bit.ly/2hcJobb)
- Done!

## ❤️ Shameless plug

- [**Charts, simple as a URL**. No more server-side rendering pain, 1 url = 1 chart](https://image-charts.com)
- [Looking for a free **Redis GUI**?](https://www.redsmin.com) [Or for **real-time alerting** & monitoring for Redis?](http://redsmin.com)
- [**Mailpopin**](https://mailpop.in/) - **Stripe** payment emails you can actually use

## 🦄 You love it? Donate :)

<span class="badge-patreon"><a href="https://patreon.com/fgribreau" title="Donate to this project using Patreon"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" /></a></span>
<span class="badge-gratipay"><a href="https://www.gratipay.com/fgribreau" title="Donate weekly to this project using Gratipay"><img src="https://img.shields.io/badge/gratipay-donate-yellow.svg" alt="Gratipay donate button" /></a></span>
<span class="badge-flattr"><a href="https://flattr.com/profile/fgribreau" title="Donate to this project using Flattr"><img src="https://img.shields.io/badge/flattr-donate-yellow.svg" alt="Flattr donate button" /></a></span>
<span class="badge-paypal"><a href="https://fgribreau.me/paypal" title="Donate to this project using Paypal"><img src="https://img.shields.io/badge/paypal-donate-yellow.svg" alt="PayPal donate button" /></a></span>
<span class="badge-bitcoin"><a href="https://www.coinbase.com/fgribreau" title="Donate once-off to this project using Bitcoin"><img src="https://img.shields.io/badge/bitcoin-donate-yellow.svg" alt="Bitcoin donate button" /></a></span>