Noki v1.7 ReadMe

copyright(c) 2007~2008 Han Zhao (abrash_han@hotmail.com)

www.nokisoft.com

Noki is an explorer for Nokia PC Suite backup 
files. It can explor and extract SMS, Phone 
book, Calendar, Memo, Bookmark and other files 
from the backup file of Nokia phone (via Nokia 
PC Suite).

You can choose to save the Noki-extracted SMS, 
Phone book, Calendar, Memo or Bookmark in 
 * one text file, 
 * multi text files, 
 * excel .xls file, 
 * html file 
 * or just remain their format. 
Media files (3gp, images, mp3, mp4 etc) extracted 
remains their original format.

Compatible with Nokia PC Suite 6.5 ~ 7.0 (.nfc,
.nfb or .nbu format backup file).

Buy from http://www.nokisoft.com

The unregistered version has extract limiation:
 * 50 entries of Phonebook
 * 50 entries of SMS
 * 30 entries of Calendar
 * 50 entries of Memo
 * 30 user files (image preview supported)
 * 30 entries of phonebook in Contacts.cdb
 * 20 entries of bookmark
 * 30 entries for .cdb (Symbian phonebook database)
 * 50 user files for .arc (SD card/mass storage)

For old backup file - .nfc and .nfb - only phone
book and SMS extracting is available. You can 
upgrade your PC Suite to 6.82 or later to extract
other files.

More details in noki-help.chm.

How to use
----------
I) To extract all phonebook, sms, calendar and memo 
   into a single text file or an excel .xls file:
1. [Browse...] to open the backup file, which you'd 
   saved using Nokia PC Suite.

2. All the four supported formats (.nfc, .nfb, .nbu
   or .cdb) are listed by default; you can change 
   the type filter to narrow down the number of files 
   to show.

3. [Save As...] to save the converted phone book,
   sms, calendar and memo into a txt, xls or html 
   file(select .txt, .xls or .html in the file 
   type filter) The default name is current-date; 
   rename if necessary. Old format .nfb and .nfc 
   can only save as .txt. nbu file can save into 
   .txt, .xls or .html format.

4. Click [Save] to start the conversion. The 
   converted txt will be opened in Notepad if success. 

Now the SMS, Phone book and Calendar are all ready
for editing, copying, sharing and printing.

II) To extract files(phonebook, sms, calendar, memo,
    image, audio, video etc)
1. [Browse...] to open the backup file which you'd 
   saved using Nokia PC Suite.

2. If your .nbu file contains backuped user files
   there'll be a directory tree slide down. You
   can begin to explore: single click to preview,
   double click to extract or right click on selected
   file(s) to choose action from the popped menu, the
   choices are:
    1) convert selected item(s) into text file(s),
    2) merge all selected items into a single text file,
    3) merge all selected items into a single excel file,
    4) merge all selected items into a single html file,
    5) extract selected items - remain their own format.
   
3. Image files(jpg, gif, png, bmp and ico) can be
   previewed in the thumbnail list left to the 
   directory tree by single click on the according item.

4. You can select multiple files via:
    1) mouse left-down then drag
    2) ctrl down with mouse left click
    3) shift down with mouse left click
   and the actions can perform in the popped menu is 
   context sensitive.

The .txt, .xls, .html file or the directory you'd 
chosen to save will be opened after all files are
successfully extracted.

III) To generate bug report
when Noki failed to parse certain segments of the .nbu 
file it will prompt an error message:
 * error, Ctrl+F1 to create bug report
Then you can press Ctrl key combined with F1 key to 
generate a bug report in trace.txt in the installation
directory(usually C:\Program Files\Noki). 

The bug report only contains parsing info and the context 
where the error happens. And it's quite small - less than 
100k after compressing. Please send the report to me for
an analysis.

IV) Explore and Restore Contacts.cdb

Contacts.cdb is the phone book database for Symbian
phones located in C:\System\Data directory. It can be copied to
PC or backuped using PC Suite. Noki support both.

1) if you'd save Contacts.cdb in a separate file and want to view
the content.

Just browse and open the .cdb file as stated in "Extract
phonebook, sms, calendar and memo into a single text, excel or
html file" then save the .cdb in your preferred format.

After opening the .cdb, Noki will parse the phone book database
and convert the phone book entry to standard vCard
files (.vcf). You can then extract them to single vCard files and
copy the vCards back to your phone via PC Suite's contacts
manager to safely restore your phone book database.

2) if Contacts.cdb is packed in the backup file (.nbu)

If Contacts.cdb is backuped in a .nbu file, you can view it in
Noki's explorer:

The Contacts.cdb is under "contacts database" directory. It can
be converted just like all other files. .cdb can also be
converted into vCard files for restoring back to the phone via PC
Suite.

To view the content of the .cdb file, you can choose "extract
to..." in the right click menu to extract the Contacts.cdb
file. Then reopen it using Noki as stated in 1) above.

Compatibility
-------------
Noki is targeted to support all versions of PC Suite 
from v6.5 to v7.0. But it might fail due to the 
compatibility between different phone models 
and different versions of PC Suite - it's hard to 
perform a thorough test for all of them.

Please kindly send the backup file via email for 
further analysis and following information is preferred:
 1. phone model
 2. version number of Nokia PC Suite
 3. bug report (generated by Ctrl+F1 in trace.txt)
 4. the backup file if you prefered

Here is a list of already tested models:
----------------------------
2865	3100	3110 	5200
6020	6021	6070	6080
6100	6101	6102	6111
6120	6131	6133	6170
6220	6230	6230i	6233
6260	6270	6280	6290
6300	6310i	6600	6610
6610i	6630	6670	6680
6822	7360	7390	7610
7710	8310	8800	9300
9300i	E50		E60		E62
E65		E70		E90		N70
N72		N73		N75		N80
N90		N91		N95		N95 8gb
Siemens X1
----------------------------	
Please generously contribute to this list your
phone model and pc suite version if you'd tried
Noki.

History
-------
v1.8 plan
@ mms support
@ vbookmarks

v1.7 on the road:
* russian pdu sms has an extra/(one more) number fix
* merge vcalendar (.vcs) file into one .vcs to import into outlook (thanks Geoff Browne)
* generalized pdu sms reader for both chn and ru
* .cdb porland support
* add .aac, .rsc, .bin, .ota, .txt, .db, .html, .doc, .jar, .jad extension file type icon
* recursive text item embedded in file and directory hierachy
* sorted sms box
* export .cdb contact database as outlook, outlook express and thunderbird .csv file
* fix bug: invalid path name stop sms(vsystem/vmails) saving
* extreme large file support (2GB to 64GB)
* sd card and mass storage backup file: .arc
* gF .arc: another format of arc
* SD card in .nbu
* smart hint for contacts.cdb and SMS in sd card private folders
* version 2 .nfb and .nfc file support (version 2 .nfb and .nfc are pre PC Suite 6.5 formats)
* pc suite 7.0 support
* more models tested

v1.6 release 2.23 2007 (major upgrade to v1.5):
* thunderbird .csv phonebook export (for .nfb and .nbu backup file)
* outlook .csv phonebook for .nfb
* vcalendar for .nfc/.nfb
* Greek support for contacts in .cdb
* both microsoft oulook and outlook express are tested for .csv export
* sms number and name matching (add leading zero for some italy phone numbers)
* recover from invalid entry in Contacts.cdb
* robust and multi registration key reader
* more entry types for vcalendar: AALARM, PRIORITY
* phonebook without name in .nfc bug fix
* more entry types for vcard: ADR, URL, X-SIP
* remove encoding, charset, internet field in tooltip
* use ORGnization name as vCard display name when name field is not provided
* incomplete .cdb extracting
* filter out invalid characters in contact entry of .cdb
* more models tested

v1.5 release 12.15 2007 (major upgrade to v1.4)
* bookmark easy explore
* outlook compatible vcard
* user file date time tooltip (forensic investigation)
* outlook .csv phonebook exporting
* nbu sms bug fix
* symbian sms bug fix
* gsm to unicode converter
* nfb sms parsing fix
* file extension upper case (.CDB->.cdb) fix
* .xls lib's saving bug fix: i18n file name conversion
* tested with Nokia PC Suite 6.85
* more models tested
* help updated on the new functions:
   1) how-to-use, 
   2) tips and tricks.

v1.4 release on 7.20 2007 (major upgrade to v1.3)
* extra large backup file(>500Mb) support
* .nfb/.nfc file explorer and extractor
* compatiblity upgrade for Nokia PC suite 6.84.10
* sorted-by-date sms list
* better support for media files
* vCard converter for contacts in .nfb/.nfc file
* more models tested

v1.3 release on 6.24 2007 (major upgrade to v1.2)
* phonebook(Contacts.cdb/vContacts.cdb) support for .nfb
* symbian short message for .nfb
* compatiblity test with Nokia PC Suite 6.84
* more models tested: 
  6101 6260 6300 E50 E62 E70 N75
* bugs fixing since v1.2

v1.2 release on 5.30 2007 (major upgrade to v1.1)
* Contacts.cdb file explorer
* Contacts.cdb file converter and extractor in .nbu
* fix phonebook and sms name mapping re-entry bug
* more phone models tested: Nokia 7710

v1.1 release on 5.15 2007 (major upgrade to v1.0)
* convert backup file (.nbu) to Microsoft Excel workbook (.xls) file
* convert backup file (.nbu) to Html file
* iconed windows XP style menu with hotkey support
* bug fixing for phonebook entry parsing
* more phone models tested
  6070, 6080, 6233, N91

v1.0.2 release on 5.10 2007 (minor upgrade to v1.0)
* fix phone book quoted printable string error for 6822
* fix user file folder name pattern parsing error
* add icons for .zip, .png and .ico file type

v1.0.1 (beta release) on 5.7 2007 (pre-release of v1.1)
* convert or merge to excel .xls (workbook)
* polished menu
  1) icons for command
  2) hotkeys for command

v1.0 release on 5.2 2007 (final release v1.0)
* add [buy] button in [about] dialog
* registration code viewer
* chm help

v0.8.1 release on 4.29 2007 (minor upgrade)
* fix bug: fail to read Symbian archived SMS in Simplified Chinese(N70)
* add Symbian phone book database support(Contacts.cdb and cntmodel.ini)
* bug reporter polished

v0.8 release on 4.27 2007 (major upgrade)
* generate bug report(in trace.txt) by Ctrl + F1
* polished user interface
* phone book quoted printable encoding bug fix
* image previewer error handler
* more models and languages tested: 
  German for 6270
  Simplified Chinese for 6131
  and Hungary

v0.7 release on 4.22 2007 (major upgrade)
* phonebook, sms, calendar and memo exploerer and extractor
* tooltips in the explorer for preview
* multiple item selection(extract or merge)
* context sensitive menu for explorer
* symbian archived sms date/time support
* support latest version (6.83.14) of pc suite
* packed sms and packed picture support
* more models tested

v0.6 release on 4.11 2007 (major upgrade)
* .nbu file explorer and extractor
* image preview (jpg, gif, png, bmp, ico)
* support Memo (up to 50 entries)
* UI upgrade - more interactive/cute
  - hint
  - progress ring (instead of a bar)
  - mapped tree and thumbnail list
  - fade out
  - slide and auto layout of tree and thumbnail list
* unicode support
* more robust vCard and vCalendar parser
* stress tested with several 10 ~ 30+ MB 
  .nbu via feedbacks
* more models tested

v0.5.0 release on 4.2 2007 (major upgrade)
* vCalendar support; up to 30 entries
* support symbian SMS archived in in system\Mail
* associate SMS sender/receiver to the name in phonebook
* msvcr71d.dll install to system dir
* readme.txt button in 'About' dialog
* improve tab stop order: default focus is [Browse...]
  and [OK] button
  
v0.4.1 release on 3.29 2007
* minor patch according to feedback: 
  replace msvcr71.dll with msvcr71d.dll

v0.4 release on 3.28 2007
* vCard support (both v2.1 and v3.0)
* better phonebook layout
* msvcr71.dll

v0.3 release on 3.27 2007
* add model, version and language header
* sms boxes format beautifier
* increase entry limit to 50

v0.2 release on 3.21 2007
* .nbu format(pc suite 6.82) support
* 30 entries limit

v0.1 release on 3.16 2007
* .nfc, .nfb support

Contact
-------
Visit Noki site at http://www.nokisoft.com (old site at: http://nokisms.googlepages.com).

Comments, bugs or feature request? You can post to 
the discussion board:
 http://groups.google.com/group/noki-sms/topics
 
or send me via email: abrash_han@hotmail.com

-------

