JCARD2

JCARD2

[ Home · Photoblog (Flickr) · Albums · Photography · Woodworking · Software · Search Site ]

JCARD2

Version:	1.2
Author:	Jeffrey Clement
Status:	Active

JCARD is a simple to use multi-user / cross-platform contact management application.

Project Description

JCARD2 is a simple cross-platform / multi-user / web-based contact management application. It is entirely contained except for the Python runtime and (if you want SSL support) the Python OpenSSL libraries.

1. New

Added jcard_lookup_mutt.py script to downloads. This lets you interface jcard2 with the awesome Unix mail client Mutt!
1.1: Rewrote DB code to use Metakit instead of Pickle. This means it will scale better and have better reliability but also means you'll have to upgrade your database. Simply put jcard in a new directory, copy your old data/contacts.db file to the new data/ directory. Then run convert.py/convert.exe in the root of the new distro. This should create contacts.mk. If this works you should be good to go. Note: If you are using a source distribution you will have to install Metakit before any of this will work. It's mostly a matter of grabbing the appropriate library and dropping it in your Python path (or JCard2 directory).

2. Features

Written using Python which means it's cross-platform (ie. runs on Windows and Linux)
Client/Server application. Multiple users can connect to the jcard server using a variety of interfaces and access records within.
Web-based interface for maintaining contact lists (supports SSL and Authentication).
XMLRPC interface allows users to easily connect other applications to JCARD and extract data (comes with demo Excel sheet that builds a nice printable phonelist)

3. Configuration

All JCARD configuation is done through the config file *MainServer.cfg*.Here is an example:

Listing #1
1.   [server]
2.   ## choose which port you would like JCARD to run off of.
3.   socketPort=8012
4.   ## enable threading server.  May as well
5.   threading=1
6.   ## enable XMLRPC?  Leave blank to turn it off
7.   xmlRpc=1
8.   ## SSL Key/Cert if you would like to use SSL
9.   #sslKeyFile=ssl/server.pkey
10.  #sslCertificateFile=ssl/server.cert
11.  
12.  [system]
13.  ## Comma separated list of Categories for filing records
14.  categories=Business,Personal
15.  
16.  [staticContent]
17.  ## don't touch
18.  static=static
19.  
20.  [accounts]
21.  ## List of accounts able to login to web interface
22.  demo=demo
23.  
24.  [rpc_accounts]
25.  ## List of accounts able to use XMLRPC interface (needed for mutt interface, etc)
26.  demo=demo

To start off. Set the port to whatever you wish (default is fine),then make sure the list of categories and users are good. Next start the server.

4. Starting JCARD Server

The JCARD server is written in Python. On most systems you simply run:

Listing #2
1.   python MainServer.py

If you download the standalone Windows version jcard2-x.x-win32.zip then just unzip it to a directory somewhere and run MainServer.exe. You do not need to install Python.

Now that the server is up and running, simply connect your web browser to http://127.0.0.1:8012 (or whatever port you told it to listen to). It will ask you to login. Use whatever account you created or the demo account (demo, demo)).

5. Todo

Add more functions to XMLRPC interface
Add Snazzy GUI client for Windows and Linux written using wxPython.

Click on an image to see it full-size.

	The phonelist view gives the name, prefered contact number, and email address of contacts. Users can filter this list by a search string (on name field) and by selecting a category to view.
	The record editor / viewer lets you make changes to each record.

Requirements

License

This software is licensed under the BSD license. Please make sure you have read and understood this license before downloading this software!

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the Bluesine nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Downloads

File	Size	Last Modified
ChangeLog	0.58 kb	Thu Sep 23 06:09:35 2004
jcard2-1.0-src.tar.gz	64.90 kb	Thu Sep 23 06:09:37 2004
jcard2-1.0-win32.zip	807.24 kb	Thu Sep 23 06:09:41 2004
jcard2-1.1-src.tar.gz	67.07 kb	Thu Sep 23 06:09:41 2004
jcard2-1.1-src.tar.gz.asc	0.18 kb	Thu Sep 23 06:09:36 2004
jcard2-1.1-win32.zip	1010.62 kb	Thu Sep 23 06:09:45 2004
jcard2-1.2-src.tar.gz	67.07 kb	Thu Sep 23 06:09:46 2004
jcard2-1.2-src.tar.gz.asc	0.18 kb	Thu Sep 23 06:09:41 2004
jcard2-snapshot.tar.gz	77.41 kb	Thu Sep 23 06:09:47 2004
jcard_lookup_mutt.py	2.82 kb	Thu Sep 23 06:09:47 2004
shot1.jpg	98.71 kb	Thu Sep 23 06:09:46 2004
shot2.jpg	105.07 kb	Thu Sep 23 06:09:47 2004