- 1 General
- 2 Setup under Mozilla Thunderbird
- 3 Setup under Android
- 4 Setup under iOS and Mac
- 5 Setup under Windows
- 6 Setup under Linux
To present provider independent data for an event, with description, start time, end time, location and other properties a standard called iCalendar exists. To distribute (subscribe to) the iCalendar data, a standard called CalDAV exists. When configured properly, CalDAV allows to integrate the events somebody published in your calendar, on your device. Most commercial software vendors try to lock users somehow in their systems, so they are not interested in using standards, that will let users easily switch the vendor. That's why you have likely not heard about iCalendar or the WebDAV extension CalDAV.
For the AGORA İstanbul you can subscribe to the Agenda using the URL https://mail.aegee.org/dav/calendars/user/chair/agenda , user name anonymous, and any password. You have to enter useless username, because some applications do not register you without username. Other applications don’t let users authenticate (something we will do later), if the server does not force them always to enter user name.
The above URL can be accessed in two ways: with HTTP GET, where one big file is downloaded with all data in iCalendar format. Some applications can only this. The second way is download over CalDAV (HTTP PROPFIND). With it, only the changes since the last synchronisation are downloaded. The idea is not only to get the shedule once, but your device is supposed to synchronise in the background regularly, presenting you always accurate information.
The server where this service runs is kind of slow. It doesn’t take ethernity, but also is not instant. Give it some time, be patient
When you upload a meeting with participants, the server sends invitations to the participants per email. You can use any email address for the recipients, except @aegee.org . Use instead @mail.aegee.org . The reason is, that for local deliveries the server uses a protocol (CalDAV Scheduling), the invitations are not delivered per Email, and no client yet understands that protocol.
Please update this wiki yourself, if you find something is missing.
Below is described how you can use some of the clients. Check https://en.wikipedia.org/w/index.php?title=Comparison_of_CalDAV_and_CardDAV_implementations for a fuller, yet incomplete catalogue.
Since 1st October 2018 you can log in with your Intranet account, and not only with the “anonymous user”. All the explanations on this page for the “anonymous” user apply also for your Intranet login. For the first login you will need a “full” CalDAV client, like AgenDAV, Evolution or davDroid. Aftrewards you can use even clients that do not have a notion of “many calendars per user”, like Thunderbird/Lightning or Caldav Sync Free Beta. For the setup of the latter you will need the calendar address.
One possibility to obtain the CalDAV-calendar address is to login at https://mail.aegee.org/agendav. Then on the other right click on calendars and then or the ⚙ on the right. Behind the “Calendar URL for CalDAV clients” is a link to the full calendar CalDAV address.
Another possibility is to visit https://mail.aegee.org/dav/calendars/user/your-user-name (don’t just click on the link, but replace the last segment with your username). After authenticating with your user name, behind the text “Download” is the link to your calendars. Disadvantage ot this second possibillty is, that it does not show any shared calendars.
You can store under personal data whatever you want, it does not have to be related to AEGEE. These data is yours and it is by default neither analyzed nor shared with anybody. One day these data can be scanned for viruses or spam-probability, just as mail is scanned, but that will be everything.
If you want to share a calendar with another user, contact the mail team to arrange this.
Concerning security, best efforts are done not to leak anything, but practice shows that data leakage can happen to every service provider.
The service is provided as-is. You can use it, if you want, or not.
In the future, there will be a notion of groups, extracted from the intranet, that can share calendars or address books.
For now, if any of you want to share data, just create the calendar/addressbook and let mail(on)aegee.org know who shall have access to it. Please note, that the notion of shared calendars is not yet standardized, and server-side sending of invitations uploaded invitations there is unclear.
For real groups, like Antennae, a new calendar will be created on the server, that is not attached to a particular personal account.
AEGEE Calendar of Events
At https://mail.aegee.org/dav/calendars/calendar-of-events/ waits a calendar, that is meant to hold information about the events in AEGEE. Members can subscribe it, after login either with their Intranet credentials, or using username “anonymous” with any password. Upon “real” login members can upload there events.
Near CalDAV there is another protocoll CardDAV used for distributing contacts.
A good CalDAV/CardDAV client, like Evolution or davDroid, will find two additional resources for email@example.com:
- A CardDAV collection https://mail.aegee.org/dav/addressbooks/public/ with email addresses of some AEGEE bodies, URL https://mail.aegee.org/dav/addressbooks/public/
- An additional CalDAV collection, that can be used as mirror of the “AEGEE Calendar of Events” - URL https://mail.aegee.org/dav/calendars/calendar-of-events/ . You can add this one also “manually” in the not so good clients, just use this address instead of the Agenda one.
One can try to present the downloaded iCalendar data on a web server, suitable for showing in browsers.
Setup under Mozilla Thunderbird
The AGORA Agenda
If the Lightning calendar plugin is not installed yet, click on the menu ☰ -> Addons -> Addons, search for lightning and follow the instructions to install lightning (Lightning is included in recent versions of Thunderbird, you can directly continue adding the calendar)
Once installed click on the calendar button on the right part of the window bar. The calendar tab is opened. In the calendar column right-click and choose "New Calendar".
Choose "On the network". Choose the "CalDAV" radio button and for location enter https://mail.aegee.org/dav/calendars/user/chair/agenda/
Choose a Name for instance "Agora". For Authentication use firstname.lastname@example.org as email address and a random password.
Click on "Synchronize" to download the agenda of the Agora
The AEGEE-wide public address book
Setup under Android
Android needs some adapters to synchronize calendar data with the local calendars.
Android Open Source Project Calendar
Whatever adapter you install, you need to grant it access to your calendars.
The setup is successful, if at the end you see in your calendars for the begin of October some interesting entries.
All the software shall offer a way to manually force re-synchronisation, try to find it out where this function is hidden.
DAVdroid is the best choice and is open source When installed from the Google Play Store, a donation of 4 € must be paid for the work authors put in it.
Once started, click on the plus “+” sign.
Enter under “Login with email address” email@example.com, any text as password.
Select “Groups are separate VCards” on the next page and “Create account”.
Click on the account
Make a tick before “Agenda” and click on the synchronization symbol at the top.
Eventually select the ⚙ gear under the created account and from there for “Past event time limit” delete the content, so that “All events will be synchronized”. This in theory will speed up the synchronization.
This is the only option mentioned here, for which a permanent setup that does not cost money. Once installed, go to ⚙ Settings → “Users & Accounts” → “Add account”. Select as type “CalDav Sync Adapter”.
Type as user “anonymous’, at least four characters as password, and as URL https://mail.aegee.org/dav/calendars/user/chair/agenda/ → “Sync in or register”.
You are back in the “User & accounts” menu. Select from there the new account. Click on “Account sync”.
Switch the calendar from “Sync is OFF” and wait for the synchronization to complete.
To manually trigger an update select ⋮ from the top.
This application provides two weeks free for testing. If you plan to use it until the end of the Agora, activate it on 24th September 2018 or later. Choose from the menu “SYNC - CALDAV”, click on the “+” and select “Not listed provider or own server”. As address enter https://mail.aegee.org/dav/calendars , username anonymous and any password. Select the “Agenda” calendar, click → and make sure to start the synchronization.
The first two weeks after the installation this can be used for free: to use it during the Agora make sure you install it after 24th September.
From ⋮ select “Create a new WebiCal” → “Start the guided CalDAV setup” → “Yes, I want to select my server to automatically configure my servers url” → “Unknown/Not at the list”. As server URL https://mail.aegee.org/dav/calendars, username anonymous, password anything. Click on “Test connection/configuration to continue”. Once the three tests are OK go to “Search available calendars”. Set a tich at after “Agenda” and then “Configure selected calendars”. Go bach to the main menu and from ⋮ select “Display created WebiCals”. There should be only one Agenda. Click on the synchronization symbol.
Setup under iOS and Mac
You can use the default Mac OS's Calendar application. To do it, follow these instructions:
- Open Calendar app, go to Menu -> 'Calendar' -> 'Preferences'
- Open the 'Accounts' tab and press '+' button under the accounts list.
- In the pop-up window, select 'Other CalDAV account' and press 'Continue'.
- Select 'Manual' as account type, put in these credentials: 'https://mail.aegee.org/dav/calendars' as a server name, 'anonymous' as a user name and any password, then press 'Sign in'.
- You're all done!
Setup under Windows
(not tested, but based on tutorials in Internet) Go to “Windows Settings” → Accounts. Add new iCloud account. Enter firstname.lastname@example.org as user name and anything as password. Try to login and you will get an error. Click on Modify→Advanced and enter as CalDAV and CardDAV servers https://mail.aegee.org/ and localhost as IMAP and SMTP server. Clich Done and retry. Yes, it is that stupid, because MS wants it to be like this. Once configured you can see on your computer the Calendar App. Your People App should also have received some AEGEE contacts.
See https://www.ctrl.blog/entry/how-to-win10-webdav-syncengine for details, enter https://mail.aegee.org as server instead. Onge you finish the procedure
Select Menu → Tools → Accounts
Calendar → CalDAV
As account address enter https://mail.aegee.org/dav/calendars/, username anonymous, and any password.
Give this account a name_
… and finish.
The overview at the end
To add address books, choose Contacts → CardDAV and enter as URL https://mail.aegee.org/dav/addressbooks/ .
With the Outlook CalDav Synchronizer plug-in for Desktop Outlook you can integrate the data in your Outlook.
Setup under Linux
Go to Edit › Accounts › Add › Collection Account , enter as email email@example.com. Click twice on “Next”. Select only “Collections“, de-select “Mail Receive” and “Mail Send”. This imports in fact two Calendars, two Task Lists, two Memo Lists and one Address Book. Click on the properties of each of them and select “Copy content for local operation” to speed up operations.