# FreshRSS Android application

Finally, an Android application specifically dedicated to the awesome [FreshRSS aggregator](https://freshrss.org/)

![splash screen](./fastlane/metadata/android/en-US/images/phoneScreenshots/1-splash-screen.png) ![login page](./fastlane/metadata/android/en-US/images/phoneScreenshots/2-login.png)  

![landing all](./fastlane/metadata/android/en-US/images/phoneScreenshots/3-landing-all.png) ![landing unread](./fastlane/metadata/android/en-US/images/phoneScreenshots/4-landing-unread.png)  

![subscription articles](./fastlane/metadata/android/en-US/images/phoneScreenshots/5-subscription-articles.png) ![article details](./fastlane/metadata/android/en-US/images/phoneScreenshots/6-article-detail.png)

![add feed panel](./fastlane/metadata/android/en-US/images/phoneScreenshots/11-add-feed.png)

## Contact & troubleshoot

If you need help for contributing or using the application, you can contact us by [joining us on Framateam](https://framateam.org/signup_user_complete/?id=e2680d3e3128b9fac8fdb3003b0024ee) or 
anonymously on the [`#freshrss`](https://kiwiirc.com/nextclient/chat.freenode.net:7070/freshrss) IRC channel on Freenode servers.

## Getting started

This project is a fairly standard Android application. As long as you use an correct setup of [Android studio](https://developer.android.com/studio/), 
everything should be fine.

## Running the tests

This project has no tests yet ¯\\\_(ツ)\_/¯
There is an issue [about setting them up](https://git.feneas.org/christophehenry/freshrss-android/issues/16), 
though, as well as one for [setting up a CI](https://git.feneas.org/christophehenry/freshrss-android/issues/17)

## Contributing

 Please refer to the [contributing guide](./CONTRIBUTING.md)

## License

This project is licenced under GNU GPL v.3. See [LICENSE](https://git.feneas.org/christophehenry/freshrss-android/blob/develop/LICENSE).

## Aknowledgments

Thanks to [Marien Fressinaud](https://github.com/marienfressinaud), 
[Alexandre Alapetite](https://github.com/Alkarex) and all the FreshRSS contributors for their awesome work. 
And thanks again to Alexandre for helping in understanding their implementation of Google reader's API.