dandelion/README.md

[![F-Droid](https://f-droid.org/wiki/images/0/06/F-Droid-button_get-it-on.png)](https://f-droid.org/repository/browse/?fdid=com.github.dfa.diaspora_android)

[![Build Status](https://travis-ci.org/Diaspora-for-Android/diaspora-android.svg?branch=master)](https://travis-ci.org/Diaspora-for-Android/diaspora-android)
[![Join the chat at https://gitter.im/Diaspora-for-Android/diaspora-android](https://badges.gitter.im/Diaspora-for-Android/diaspora-android.svg)](https://gitter.im/Diaspora-for-Android/diaspora-android?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Join the chat (XMPP) at diaspora-android@conference.jabberhead.tk](https://img.shields.io/badge/xmpp-join-blue.svg)](xmpp:diaspora-android@conference.jabberhead.tk)


# Diaspora for Android

This is an unofficial webview based client for the community-run, distributed social network **[Diaspora](https://joindiaspora.com/)**. It's currently under development and should be used with that in mind. Please submit any bugs you might find.  
**Notice:** This is the repo of the latest version of the unoffical Diaspora Android App.

- Download ([F-Droid](https://f-droid.org/repository/browse/?fdid=com.github.dfa.diaspora_android), [Release Archive](https://github.com/Diaspora-for-Android/diaspora-android/releases))
- Watch [Changelog](https://github.com/Diaspora-for-Android/diaspora-android/blob/master/CHANGELOG.md)
- See [Screenshots](https://github.com/Diaspora-for-Android/diaspora-android/blob/master/SCREENSHOTS.md)

## Contributions
We are always open for any kind of contribution. (PR's, bug reports, feature requests, translations, ..)  
If you got any questions feel free to join our XMPP/Jabber conference at `diaspora-android@conference.jabberhead.tk` or [Gitter](https://gitter.im/Diaspora-for-Android/diaspora-android).  
Note that the main project members are mostly busy with their job/university/school and may not react or start coding immediately.

We use Crowdin to translate Diaspora for Android. Join our project here:   <https://crowdin.com/project/diaspora-for-android/invite>  
If your desired language is not listed please contact the maintainers.  

### License
It's released under GNU GENERAL PUBLIC LICENSE (see [LICENCE](https://github.com/Diaspora-for-Android/diaspora-android/blob/master/LICENSE.md)).

### WebApp
The app is developed as an WebApp because currently Diaspora doesn't have an API that can be used to create a native interface to retrieve the user's data, publications, direct messages and so on, that's why there are only WebApps for Diaspora out there.  
API is discussed frequently on Diaspora, but the main developers seem to not give the API and mobile view the attention it needs. [Stay tuned on Diaspora* Issues](https://github.com/diaspora/diaspora/labels/api).

Why a WebApp is better than using the mobile site on a browser?  
Basically it provides better integration with the system (events coming into and going out of the app), notifications, customized interface and functions and a nice little icon that takes you directly to your favorite social network :)

### Device Requirements
The minimum version supported is Ice Cream Sandwich, Android v4.2.0 / API 17

### App Permissions
It requires access to the Internet and to external storage to be able to upload photos when creating a new post and for taking screenshots.

## Maintainers
- gsantner ([GitHub](https://github.com/gsantner), [Web](https://gsantner.github.io))  
- vanitasvitae ([GitHub](https://github.com/vanitasvitae))