README.md
<p align="center">
<a href="https://github.com/hello-efficiency-inc/raven-reader/">
<img alt="raven reader logo" src="https://github.com/hello-efficiency-inc/raven-reader/blob/master/src/assets/raven-logo.svg?raw=true" width="400">
</a>
</p>
<p align="center">
<strong>All your articles in one place. Beautiful.</strong>
</p>
<p align="center">
<img src="https://img.shields.io/github/package-json/v/hello-efficiency-inc/raven-reader">
<a href="https://deepscan.io/dashboard#view=project&tid=10825&pid=13709&bid=237952"><img src="https://deepscan.io/api/teams/10825/projects/13709/branches/237952/badge/grade.svg" alt="DeepScan grade"></a>
<a href="https://travis-ci.org/mrgodhani/raven-reader">
<img src="https://travis-ci.org/mrgodhani/raven-reader.svg?branch=master">
</a>
<a href="https://david-dm.org/hello-efficiency-inc/raven-reader" title="dependencies status">
<img src="https://david-dm.org/hello-efficiency-inc/raven-reader/status.svg"/>
</a>
<a href="https://david-dm.org/hello-efficiency-inc/raven-reader?type=dev" title="devDependencies status">
<img src="https://david-dm.org/hello-efficiency-inc/raven-reader/dev-status.svg"/></a>
<a title="MadeWithVueJs.com Shield" href="https://madewithvuejs.com/p/rss-reader-v2-0/shield-link"> <img src="https://madewithvuejs.com/storage/repo-shields/12-shield.svg"/></a>
<a href="https://snapcraft.io/raven-reader">
<img alt="raven-reader" src="https://snapcraft.io/raven-reader/badge.svg" />
<img src="https://img.shields.io/github/downloads/hello-efficiency-inc/raven-reader/total.svg" />
</a>
</p>
## NOTE
Working on the new version completely re-written. This version of Raven Reader would no longer be maintained. Stay tuned for more announcements and new repo.
## Download
To download, please visit https://ravenreader.app.
[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/raven-reader)
## Install via [Homebrew](https://formulae.brew.sh/cask/raven-reader) (macOS)
To use Homebrew-Cask you just need to have [Homebrew](https://brew.sh/) installed.
```bash
brew install --cask raven-reader
```
## Install via [Chocolatey](https://community.chocolatey.org/packages/raven) (Windows) (Thanks to [@A-d-r-i](https://github.com/A-d-r-i))
```
choco install raven
```
![darkscreenshot](/darkscreenshot.png)
![video](/video.png)
![podcast](/podcast.png)
## Features
- [x] Full Article Read
- [x] Subscribing to news feed
- [x] Marking as read/unread
- [x] Marking as favourite
- [x] Dark mode
- [x] Configurable cron job for refresh interval of feeds
- [x] Minimize app to tray and run in background
- [x] Open article link in external browser
- [x] Responsive
- [x] Exporting feed in OPML format
- [x] Importing feeds
- [x] Windows support
- [x] Linux support
- [x] Offline reading
- [x] Keyboard Shortcuts
- [x] Sidebar count
- [x] Text size configuration
- [x] Text font style configuration (Currently has Playfair Display, Muli, Open Sans and Roboto Slab)
- [x] Supports categorizing of the feeds.
- [x] macOS touchbar shortcuts
- [x] Integration with read it later apps: Pocket, Instapaper
- [x] Podcast support. Subscribe to podcast rss feed and listen within app.
- [x] Accessibility Friendly
- [x] Feedbin integration (Folders are WIP)
- [x] Inoreader integration
- [x] Google Reader API support. Supports self hosted RSS Services like FreshRSS.org etc. (Folders are WIP)
- [x] Support for subscribing Youtube channels and viewing within app.
- [x] Flexible resizing of columns/panes
Please feel free to suggest more ideas to improve this app.
## Supported Platforms
- Feedbin
- Inoreader
- Self hosted RSS Services compatible with Google Reader API (OldReader, Bazqux, FreshRSS)
- Fever
## Supported Locale
| Language | Contributor |
|-----------|--------------|
| English | |
| French | |
| Catalan | [alexhoma](https://github.com/alexhoma)|
| Turkish | [ahmetcadirci25](https://github.com/ahmetcadirci25)|
| Chinese | [@LinWhite2333](https://github.com/@LinWhite2333)|
| Dutch | [@Vistause](https://github.com/Vistause) |
| Russian | [@vanja-san](https://github.com/vanja-san) |
| Polish | [@konhi](https://github.com/konhi)|
| Brazilian Portuguese | [@gabrielgomeso](https://github.com/gabrielgomeso)|
| Italian | [@luverolla](https://github.com/luverolla)|
| German | [@nebulon42](https://github.com/nebulon42)|
## Contributions
We're excited that you're wanting to help us make Raven Reader even better! Contributions of all sizes are welcome, if you'd like to work on something take a look through the current [GitHub issues](https://github.com/hello-efficiency-inc/raven-reader/issues). If it's a new feature or potential bugs, please make a new issue ticket for it and populate it accordingly.
## Contributors Wall
<a href="https://github.com/hello-efficiency-inc/raven-reader/graphs/contributors">
<img src="https://contrib.rocks/image?repo=hello-efficiency-inc/raven-reader" />
</a>
_Note: It may take up to 24h for the [contrib.rocks](https://contrib.rocks/image?repo=hello-efficiency-inc/raven-reader) plugin to update because it's refreshed once a day._
## Developer Notes
For setup instructions and configuration follow https://github.com/nklayman/vue-cli-plugin-electron-builder
#### Build Setup
``` bash
# install dependencies
yarn install
# serve with hot reload at localhost:9080
yarn electron:serve
# build electron application for production
yarn electron:build
# lint all JS/Vue component files in `src/`
yarn run lint
```
## Powered by
- [Bootstrap](https://getbootstrap.com)
- [Vue](https://www.vuejs.org) & [Vuex](https://vuex.vuejs.org)
- [Lovefield](https://github.com/google/lovefield)
- [Mercury Parser](https://mercury.postlight.com/web-parser/)
## License
[MIT](https://github.com/mrgodhani/rss-reader/blob/master/LICENSE)