NOTE: As of June 1, 2011 the current Ubuntu One contacts sync for mobile will no longer be active. We’re stopping support for our current service so we can focus our energy on launching a much better service sooner than we could otherwise.

= Contacts phone sync, public alpha =

For questions about the service, see [[UbuntuOne/PhoneSync/FAQ]]

=== Set up your phone ===
==== Instructions ====
 * Go to: https://one.ubuntu.com/phones/ (if the link is down, check our [[http://twitter.com/ubuntuone|twitter status]])
 * Select your phone model. If the model isn't listed, but you know it works, then proceed. We will give you a username and password to authenticate your phone with your Ubuntu One account.
  * iPhone and Android phones can download the app directly from their respective app stores (web links for Android available at [[http://www.cyrket.com/p/android/com.funambol.androidsync/|Cyrket]], [[http://www.appbrain.com/app/com.funambol.androidsync|AppBrain]], [[http://code.google.com/p/funambol/|Google project site]]).
 * '''Don't''' configure calender/notes sync or anything else that isn't contacts, no matter what the instructions tell you to do
 * If your phone doesn't support syncml, download the client from here: https://www.forge.funambol.org/download/
 * The host is: '''http://syncml.one.ubuntu.com'''
 * DB name: '''card'''

==== Model gotchas ====
 * iPhones, download the Ubuntu One app from the Apple app store
 * Android phones, only 2.0x models are supported. Download the app from the Android Marketplace. 


=== Resetting your contacts ===
'''WARNING: THIS COMPLETELY DELETES EVERYTHING FOR EVER'''
 * Download [[attachment:ubuntuone-couchdb-query]]
 * Run: 
{{{
python ubuntuone-couchdb-query --http-method=DELETE contacts
python ubuntuone-couchdb-query --http-method=PUT contacts
}}}
 * Delete your local contacts db from the couchdb admin:
{{{
firefox .local/share/desktop-couch/couchdb.html
}}}

==== Email clients ====
 * Thunderbird 2: https://addons.mozilla.org/en-US/thunderbird/addon/8616
 * Thunderbird 3 ''32 bit'': [[https://mozilla-plugin.forge.funambol.org/files/documents/89/367/funambol-mozilla-sync-client-linux-v20100317.xpi|Download]] and install the add-on
 * Thunderbird 3 ''64 bit'': [[https://mozilla-plugin.forge.funambol.org/files/documents/89/368/funambol-mozilla-sync-client-linux-20100129-64bit.xpi|Download]] and install the add-on
 * Evolution: https://wiki.ubuntu.com/UbuntuOne/Tutorials/Contacts

== Testing ==
Please give us feedback in this structured format, so we can understand what needs to be worked on.
We would like the test to be done in a certain order so we can understand where things fail.
To add your feedback, copy and paste the following:

## So we can ping you on IRC
|| Nickname: || ||
## Model and manufacturer
|| Phone: || ||
## Username generated for phone sync
|| Username: || ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || ||
## yes/no
|| Did your phone sync without errors? || ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || ||
## yes/no/comments
|| Do they seem to have all the correct data? || ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || ||
## yes/no/comments
|| Do they seem to have all the correct data? || ||
|| Other observations || ||

=== Test results ===
'''Your test results here!'''

## So we can ping you on IRC
|| Nickname: || pashka_r ||
## Model and manufacturer
|| Phone: || Asus P535 ||
## Username generated for phone sync
|| Username: || 16394705 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 08 Apr 2010 21:12 (UTC) ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || almost. Some of my contacts are in Russian. All of them are shown in the last category 'O' ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || n/a. did not test ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || n/a. did not test ||
## yes/no/comments
|| Do they seem to have all the correct data? || n/a. did not test ||
|| Other observations || ||


## So we can ping you on IRC
|| Nickname: || dpossner ||
## Model and manufacturer
|| Phone: || Nokia 5310 XpressMusic ||
## Username generated for phone sync
|| Username: || 78360914 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 11.30pm GMT ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || no, synching stopped after 48 of 118 contacts (error was: data transfer not possible) ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || I see 48 new contacts ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|| Other observations || Synchronization with memotoo (also uses syncml) worked fine. ||

## So we can ping you on IRC
|| Nickname: || animaster ||
## Model and manufacturer
|| Phone: || Apple iPhone 3GS ||
## Username generated for phone sync
|| Username: || 28701936 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 04:20am GMT ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no16394705
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || e-mail addresses from phone contacts did not get sync'ed to Ubuntu One ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|| Other observations || I have been using Google Sync (MS Exchange) and it works well for a free service ||

## So we can ping you on IRC
|| Nickname: || sergek ||
## Model and manufacturer
|| Phone: || Motorola L9 ||
## Username generated for phone sync
|| Username: || 08745169 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 10:30am GMT ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || Yes, in general. All contacts (the are in russian) in web UI are in one last category. Not divided by letters as contacts that are in english. ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|| Other observations || Great service, but I doubt I will use it if it will be paid. But depends on price. ||

## So we can ping you on IRC
|| Nickname: || mattgriffin ||
## Model and manufacturer
|| Phone: || iPhone 3G ||
## Username generated for phone sync
|| Username: || 89127405 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| Apr 15 14:13 ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || I added a contact with an international phone number to Evolution. The contact synced file to the webui but the contact did not have the phone number when I synced my phone. ||
|| Other observations || Seems to be some sync strangeness when switching the type of email from 'other' to 'work'. Sometimes the sync causes it to switch back to 'other' even though I've changed it to 'work' in Evolution. The iPhone has a phone type of "iPhone". Assigned phone numbers to this type are not displayed in the webui. Editing a contact in the webui adds values (blank) to empty address fields. Recreate by adding a new contact on your phone (just phone # and no addresses). Sync. Edit the phone # in the webui. Save. Sync. Contact on phone now has blank address values. ||

## So we can ping you on IRC
|| Nickname: || VladNistor ||
## Model and manufacturer
|| Phone: || Nokia N900 ||
## Username generated for phone sync
|| Username: || 38204957 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 22:00 ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || no ||
## yes/no
|| Did your phone sync without errors? || NO, 401 ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || N/A ||
## yes/no/comments
|| Do they seem to have all the correct data? || N/A ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || N/A ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || N/A ||
## yes/no/comments
|| Do they seem to have all the correct data? || N/A ||
|| Other observations || Since N900 was not available on the list I chose N97 to get user/password. I used SyncEvolution app on the phone. I also chose to only send contacts as an option and not receive in case this did not work properly. ||

## So we can ping you on IRC
|| Nickname: || errno ||
## Model and manufacturer
|| Phone: || Nokia E61i ||
## Username generated for phone sync
|| Username: || 62875913 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 08 Apr 2010 23:03 (UTC) ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || no ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || no ||
## yes/no/comments
|| Do they seem to have all the correct data? || no, it's empty ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes, but all Ukrainian names are in group "0" (zero) ||
|| Other observations || "System error!" ||

## So we can ping you on IRC
|| Nickname: || ben-8409 ||
## Model and manufacturer
|| Phone: || Nokia 6300i ||
## Username generated for phone sync
|| Username: || 20781643 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 15:45 (DST) ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || no ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || It only synced parts of my contacts ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || no ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || ||
## yes/no/comments
|| Do they seem to have all the correct data? || ||
|| Other observations || Error Message: Data transfer not possible occurs after about 30% ||

## So we can ping you on IRC
|| Nickname: || N/A - Not on IRC ||
## Model and manufacturer
|| Phone: || IPhone 3G ||
## Username generated for phone sync
|| Username: || 07524683 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| April 9 2010 14:30 ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes on previous run, cancelled on this run||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || Started with all contacts in Web UI (loaded via evolution) & empty phone contact list, loaded into ubuntu one from evolution ||
## yes/no/comments
|| Do they seem to have all the correct data? || Web UI almost. The Sync from evolution to ubuntu one contacts has put the Job Title field from the Evolution Contact into the contact Name Title field, giving contacts with job titles the wrong name.  Phone contacts are incorrect.  Addresses are being created that aren't in the Web UI (SyncML record contains them even though they don't exist on the contact & ubuntu one iphone app creates them in the phone contact).  Phone numbers are not being created in most cases, although it looks like if a contact record has multiple phone numbers, the second one does get created. ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || N/A - Didn't merge contacts ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? ||N/A - Didn't merge contacts ||
## yes/no/comments
|| Do they seem to have all the correct data? || N/A - Didn't merge contacts||
|| Other observations || Covered above ||

## So we can ping you on IRC
|| Nickname: || N/A ||
## Model and manufacturer
|| Phone: || iPhone 3Gs ||
## Username generated for phone sync
|| Username: || 96712085 ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 09/04/2010 22:00 UTC ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || no... data is not appearing in the correct fields.  Most significantly, Home Phone is appearing as Mobile on the iPhone and Mobile Phone isn't appearing at all.  Home email address is appearing as Other email.  Work Phone isn't appearing at all either.  On the whole, these issues make the app unusable in the current form, the Mobile # not appearing being the most significant issue.  ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || yes ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || yes ||
## yes/no/comments
|| Do they seem to have all the correct data? || yes ||
|| Other observations || phone -> ubuntu syncing seems to be working.  In the small tests I've done, changing contact info on the iPhone gets correctly propagated back to Evolution ||

## So we can ping you on IRC
|| Nickname: || stub ||
## Model and manufacturer
|| Phone: || Motorola V360 ||
## Username generated for phone sync
|| Username: || ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 2010-04-16 11:25 UTC ||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? || yes ||
## yes/no
|| Did your phone sync without errors? || yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || no ||
## yes/no/comments
|| Do they seem to have all the correct data? || n/a ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || n/a ||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || n/a ||
## yes/no/comments
|| Do they seem to have all the correct data? || n/a ||
|| Other observations || Contacts not uploaded. Doesn't appear to support contacts stored on SIM card. ||

## So we can ping you on IRC
|| Nickname: || skutter||
## Model and manufacturer
|| Phone: || iPhone 3gs||
## Username generated for phone sync
|| Username: || ||
## Please specify in UTC, approximate time is ok
|| Date/time synced:|| 21:30||
|||| ''Test results - basic phone sync'' ||
## yes/no
|| Is your phone supported? ||Yes ||
## yes/no
|| Did your phone sync without errors? ||Yes ||
## yes/no (and what error)
|| Can you see all your contacts on the web ui? || Yes||
## yes/no/comments
|| Do they seem to have all the correct data? ||Contacts missing all email addresses ||
|||| ''Test results - merging with email contacts'' ||
## yes/no
|| Did your email client sync without errors? || Yes||
## yes/no
|| Can you see all contacts merged with the phones' on the web ui? || Yes||
## yes/no/comments
|| Do they seem to have all the correct data? || ||
|| Other observations ||Worth noting that my contact list is synced from Exchange also and used the Ubuntu One App. ||