• Home
• Projects
  • PyCoCuMa
  • BambooInvoice
  • WikipediaESA
  • Old Stuff
• Articles
• About
• Contact

PyCoCuMa

Pythonic Contact and Customer Management

Current Version: 0.4.5-6 (2005-09-13 23:25 CET)

Download Py2Exe-Binary for Win32:
PyCoCuMa-0.4.5-5-win32.zip (3030674 Bytes)
(Requires no Python installation to run!)

Download Source Distribution:
PyCoCuMa-0.4.5-6.tar.gz (147169 Bytes)

See the PyCoCuMa Screenshots

PyCoCuMa README

PyCoCuMa (Pythonic Contact and Customer Management) provides an personal information system for addresses, telephone numbers and other data associated with personal contacts.

PyCoCuMa is purely written in Python with a Tk graphical interface. PyCoCuMa is based on an XML-RPC client-server architecture. The server stores it's data in compatible vCard (ver. 3.0) files (*.vcf) which can be read by all modern address programs (Evolution, KAddressbook, Outlook, GnomeCard, etc).

For Installation Instructions see the file named 'INSTALL'.

You can..
..open vCard files directly or over PyCoCuMa's XML-RPC server
..define unlimited mail/email-addresses and tel-numbers for a contact
..designate addresses/tel-numbers as 'preferred', 'home', 'work', 'mobile', etc
..filter the contact list by category (e.g. 'Business', 'Personal', ..)
..search in all vCard fields for regular expressions ("Query"->"Find Contact.." or CTRL-F)
..start your favourite mail-agent or web-browser by clicking on an Email/URL
..get a list of persons birthdays ("Query"->"Birthdays")
..export your contacts to CSV files (KSpread and Microsoft Excel compatible).
..import from CSV files
..create a PDF document (for print-out) via LaTeX ("File"->"Page View")
..keep a journal of actions (Appointments, Phone Calls, etc; with calendar)
..compose letters (requires pdfLaTeX)
..stick photo images (e.g. JPEG) to vCards (requires PIL)
..do a lot more ;-)

CONFIGURATION:

PyCoCuMa stores it's preferences in ~/.pycocuma (INI-File) by default. Leave the option "url_viewer" blank to use Python's internal 'Webbrowser' interface-module. Set "autostart_server" to "yes" (this is the default) if you are using PyCoCuMa only locally and don't wan't to hassle with the server (you could also start the server at boot time or run it on another machine).

COMMAND-LINE OPTIONS:

Usage: pycocuma [options] [connection-string]

connection-string addressbook filename / server url
-h or --help show this help
-c or --config location of configuration file (default: ~/.pycocuma)
--noconf do not save configuration / preferences
-t or --type connection type: xmlrpc or file (default: file)
--finder start with QuickFinder

Example:
'pycocuma --type=file ./addressbook.vcf' will open the file ./addressbook.vcf from disk without starting any server.

PyCoCuMa was programmed by Henning Jacobs <henning@jacobs1.de>. PyCoCuMa's Homepage: http://www.srcco.de

---

Installation Instructions:

Prerequisites:
You need at least Python 2.3 with Tk 8.3 and Tkinter. You will also need the Pmw Megawidget package (Pmw 1.2) and the Python Imaging Library (PIL). Tk and Tkinter are shipped with Python by default, so for Windows users: Just download the current Python Distribution from http://www.python.org . PyCoCuMa was tested on the following platforms:
- GNU/Linux Debian (Sarge), Python 2.3
- Windows 2000 with Python 2.3.3 and Pmw 1.2

INSTALLATION ON UNIX/LINUX:

1.) Unpack the tarball:
~/tmp$ tar -xzvf PyCoCuMa-<VER>.tar.gz

2.) Enter the newly created directory:
~/tmp$ cd PyCoCuMa-<VER>

3.) Simply run the setup script:
~/tmp/PyCoCuMa-<VER>$ python setup.py install

Where <VER> is the version number of your downloaded package, e.g. 0.3.1. This will install the PyCoCuMa libraries into your local Python installation (usually something like /usr/lib/python2.3/site-packages/) and copies the two executable scripts 'pycocuma' and 'pycocuma-server' to your /usr/bin directory (or /usr/local/bin, see below).

Try 'setup.py --help install' for a list of available install options. If you prefer installing to /usr/local rather than /usr, try 'setup.py install --prefix=/usr/local' for example.

To start PyCoCuMa run 'pycocuma'.

INSTALLATION ON WINDOWS:

1.) Unpack the tarball to any directory you like (e.g. c:\Program Files\)

2.) Double-clicking 'pycocuma.pyw' should do.

---

TODO (Wish List):

- better journal/calendar support
- customer handling, invoice printing
- server security (host-/ password authentication)
- integration with other programs like GnuCash
- address syncronization
- import XML files (?)
- world map for TimeZone and GlobalPosition
- needs a lot of optimization (filtering, server comm., ..)
- import from CSV (done!)
- export to vCard (done! 2004-01-29)
- filter contact list by category (done! 2004-02-06)
- contact/customer journal (entries like Appointment, Phone Call, ..) (done! 2004-02-26)
- settings dialog (fonts, colors, sorting, and other preferences) (done! 2004-03-06)
- integrated letter composer with LaTeX printing and auto. address handling (done! 2004-03-17)
- support picture(s) in vCards (e.g. photo, company logo) (done! 2004-11-28)