Etar-Group/Etar-Calendar
1
1
Fork 0
mirror of https://github.com/Etar-Group/Etar-Calendar.git synced 2024-09-11 10:05:47 +03:00
Code Issues Packages Projects Releases Wiki Activity

Update readme. Fix #336 (#427)

Browse Source 
Update README.md
This commit is contained in:
Gitsaibot 2019-03-03 13:43:59 +01:00 committed by GitHub
parent 7052956797
commit 18e16b6e8b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 44 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
README.md
View File

@ -22,9 +22,41 @@ this app would be just a dream. So thanks to them!
- Material designed.
- -Agenda widget.- (disabled until #373 and #374 are fixed. Use [Calendar Widget](https://f-droid.org/de/packages/com.plusonelabs.calendar/) as an alternative.)
## How to use Etar
Store your calendar on the phone only:
- Use offline calendar to create a local calendar on your phone.
Sync your calendar to a server:
- A cloud-synched calendar could be a google calendar, but you can also use
any other public Caldav-server or even host your own (which would be the
only way to keep full control over your data and still have ONE calendar
usable from different devices.) To sync such a calendar to some server you
need yet another app, e. g. DAVx5. That’s necessary because a Caldav client
isn't included in Etar.
The following [link](https://ownyourbits.com/2017/12/30/sync-nextcloud-tasks-calendars-and-contacts-on-your-android-device/) provides a tutorial how to use Nextcloud + DAVx5 + Etar.
### Technical explanation
On Android there are "Calendar providers". These can be calendars that are
synchronized with a cloud service or local calendars. Basically any app
could provide a calendar. Those "provided" calendars can be used by Etar.
You can even configure in Etar which ones are to be shown and when adding
an event to which calendar it should be added.
### Important permissions Etar requires
- READ_EXTERNAL_STORAGE & WRITE_EXTERNAL_STORAGE
->import and export ics calendar files
- READ_CONTACTS
->allows search and location suggestions when adding guests to an event
- READ_CALENDAR & WRITE_CALENDAR
->read and create calendar events
## Contribute
### Translations in Google Play app description
You can update/add your own language [here](metadata). Also, all artwork files are available [here](metadata)
### Translations
Interested in helping to translate Etar? Contribute here: https://hosted.weblate.org/projects/etar-calendar/strings/
##### Google Play app description:
You can update/add your own language and all artwork files [here](metadata)
### Build instructions
Install and extract Android SDK command line tools.
@ -34,9 +66,14 @@ export ANDROID_HOME=/path/to/android-sdk/
git submodule update --init --remote
gradle build
```
## License
### How this was done
- see ``build.gradle`` and the modifications to ``AndroidManifest.xml``
- ``fix_strings_and_import.py`` was created to fix a build problem and rename imports of R.java
- get time zone data from http://www.iana.org/time-zones write ``backward`` and ``zone.tab`` to assets and to assets of https://github.com/dschuermann/standalone-calendar-timezonepicker
- comment out code in https://github.com/dschuermann/standalone-calendar-frameworks-ex
Copyright (c) 2005-2013, The Android Open Source Project
Copyright (c) 2013, Dominik Schürmann
Copyright (c) 2015-, The Etar Project
Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0
Google Play and the Google Play logo are trademarks of Google Inc.