This software is Freeware
© 1994-2000 by Paul D. Cardwell
CMAN v2.0 is in beta testing stage, a demo may soon appear here.
I am working on the "print" routine and putting final touches on the application. All I can say is if you used CMAN the terminal application, you are in for one heck of a surprise! That and a big smile!!! =)
To apply for being on the beta team send me an e-mail.
Remember: You can remap all the keyboard keys to your liking.
|Available for Platforms|
Download CMan 1.6i Released 09-02-1999 (includes buildit.sh script and fixes, for Linux 2.2+, non-gui version)
Download CMan 1.5i Released 10-04-1997 Digital Unix (COFF format alpha dynamically linked)
Download CMan 1.5j Released 05-22-1998 BeOS (R3, Intel) requires ncurses (SHIFT+CLICK to download)
|Platforms to be supported and ported to|
For version 2.0:|
Native versions will be available for: Linux (GTK+ and X11 , Intel), BeOS R4.5 (Intel), Solaris 2.7+ (GTK+ and X11, Sparc)
International users: This release is english only, there will be an international version soon after the release.
|Table of Contents|
How to register
Copying policy and warranty
Description of CMan
List of features/new additions
How do I use CMan and the philosophy behind it
New file format description
Description of the CMan configuration file(settings)
Example of keyboard definitions in cmanrc file
Changes/Bug Fixes/Version information
September 2, 1999.Requirements:
Ncurses 1.9.x should be pre-installed for Linux users, Digital Unix works fine as is.Registration:
If you use this software all I ask is for you to e-mail me.
This software is freeware.
No cost, no obligation to buy, no 7 day 24 hour support, but suggestions are welcomed.
This software can be placed on Linux distribution media and internet archives. It cannot be used to cause harm, damage or any unlawful practices. If you include this in a commmercial package, please do not charge for this portion, since it is free!
The source code will not be made available at this time, this does not mean it can't be obtained at the request of the author. Any source code distributed cannot be changed in any way minus getting it ported to another platform.
CMan is short for Contact Manager, which is a form of a rolodex. It has the ability to be configurable for various terminals, but is limited. The limit is, the field names themselves cannot be altered, this is changed in an up coming version. The newer version will cost money (cost $10.00 USD). It will not be available through this web site, it will be marketed differently. A non-gui version will be made a later time for the 2.0 release.
1. New file format, CMan uses a flat ascii (text) file delimited by ";" semicolons. Look below for a description of the new format.
2. Convert program to convert version 1.1c data files to the new file format. (note: the convert program is called "convert")
3. Support of multiple configuration files, via "-c" command line option. The configuration file is where all settings are kept for CMan. Look below for a detailed description of this file.
4. Support of usernames/accounts for expiration (for ISPs and Administrators). It also has a command line option "-e" to auto- matically expire the data file without going to the interface.
5. Support of Email applications, for instance, if your in the view only mode, you can launch the associated application while your on the Email fields. Note: If you use Netscape, it can use Netscape's Email program.
6. Support of Web Browsers, for instance, if your in the view only mode, you can launch the associated application while your on the Web Site/Page field.
7. Support of FAX software, for instance, if your in the view only mode, you can launch the associated application while your on the Fax field. (note: It can be a shell script, whatever, it will pass the data in the fax field to that program)
8. Customizable keyboard keys and text of: menus, keyboard short cuts and help text.
9. Customizable colors of: menus, text and fields.
10. Arrow key support through-out and yes it works. Look below for custom keyboard definitions.
11. Much improved Find feature. Now you can specify parts of words or phrases in a search. If more than one matches a list will be brought up for you to choose from.
12. Expiration feature. This is very useful for not just Internet Service Providers and system administrators. If you fill in the expiration date only and skip username, etc, it will still expire the data (note: it is marked for expired, doesn't get removed). For instance: If you run a user group and have members that are renewed yearly, just place the date in expires field. When the date comes it will expire it automatically (note: you must run CMan for the expiration logic to take place). Plus, CMan has a command line option of "-e" which if specified will automatically expire the data that needs to be expired without going into the user interface (note: useful for 'cron jobs' or a quick way to expire the data, if need be).
13. It uses the 'Tab' key by default to move between fields. It also uses Ctrl-c to quit without "saving."
14. Help system is available in all screens (windows).
15. Upon reading a data file (specified at runtime) it will check to make sure the data is properly formatted and it *will* stop from running if a field is overrun with data. It will tell you what line and field in the data file it has a problem with.
16. Print/Load/Save features have all been improved. Print no longer uses that bad format anymore.
17. Cycling (moving up/down, moving next/previous) is better, you no longer have to start at the top to get to the bottom item/field.
18. Editing in fields improved and features: Go to end of line, Go to beginning of line, insert mode on/off (defaults off), clear field and start over (press the associated key and then start typing it will clear it), Delete/Backspace works appropriately, arrow keys can be used to move around in a field.
19. Group View features: Use arrow keys (default) to move up/down the list, or press spacebar (default) to toggle which phone number is shown (Office/Home).
20. Lots of problems have been addressed and fixed. This is far more stable than version 1.1c and a heck of a lot better.
CMan was created for the sole purpose of keeping track of groups of people.
First and foremost it had to support multiple configuration files. The reason for multiple configuration (settings) files were due to not all terminals (telnet sessions, physical terminals) support the same features and not everyone speaks the same language. This allows the user to re-define the text on screen for everything minus the actual field names (fixed in an up coming version). The user can re-define what keys to what, what email program to use, what printer to use, what web browser to use and what fax/shell script to use. This was all done to make CMan more understandable by lots of people.
Secondly, CMan had to supply enough fields of information to help leviate the differences amoung groups of people. I tried to make it friendly as possible (limited to time on my part). Certain fields have the ability to fill-in the blanks for you, so you do not need to enter all the fields (mainly: Created Date, Group, Expired and Status fields).
The interface needed to be quick and easy to learn, granted doing text-mode GUIs is not an easy task. For this, CMan is broken up into two main windows and one full screen window. The first two main windows are as such: Command Menu on the Left affects whatever is on the right (down to the cursor position), The right is a list of groups of people. Now the somewhat confusing part, if you select a group it will 'zoom in' on that group and show you the people belonging to it (shows: Last Name, First Name, Middle Name (Initial), and either Home/Office phone number -- which can be toggled).
Once your at this zoomed in level you can then apply the Command Menu options: Show (viewonly), Edit, Delete, Save, Load and Print on them.
Add, Find and Goto commands work on any of these two windows.
The full screen window comes up when you choose: Add, Find, Edit, Delete and Show. From here you can move around and change fields, but 'Show' is viewonly no changes are even allowed. If you can use 'Add' you can use: Find, Edit, Show and Delete.
Special fields are: Fax Line, Email 1, Email 2 and Web Site. These fields are special because you can launch an associated application when your cursor is on (in) these fields. Both text mode applications and graphical applications are supported. So you can use a text-mode emailer/browser or graphical ones, as well as a combo of these.
A built-in Help System is available in all windows (screens). Just press the appropriate key (shown at top of window along the Title bar).
How do you navigate? This is all up to you actually, you can either use the supplied configurations file(s) or make one up for yourself. So have at it, change the keys if they don't work or you'd rather use another one, in fact you can change the help text along with it.
About the Main Menu Commands (note: this may not be in the order you set it up as from the configuration file).
The CMan configuration file is as such, each setting has a particular option(s) for it. Here is a list of setting commands and their options. View either 'cman_dumb' or 'cman_x' for dumb terminals or running CMan in an 'xterm' terminal. Be sure to read the following first:
Before we start, CMan will look in your home directory for a .cmanrc (the old 1.1c version will *not* work, minus color settings). Use the "-c" option from the command line to specify a different configuration (settings) file (example: cman -c pauls.cman datafile). Btw, below is a reference only, look at the example configuration files for more information if the below is of little help.
Note: CMan's configuration file is *case* sensitive!
Changes in CMan 1.6i release 02, 09-2-1999
1. Updated cman.doc
2. Created a shell script "buildit.sh" to basically take the distributed objects files and link them. This was done for library concerns of Linux distributions.
3. Minor fixes.
Changes in CMan 1.5i release 02, 10-4-1997
User interface improvements, mainly in usability.
1. If you add a person to an already existing group it will fill-in the group-name for you.
2. If you add a person with-in an existing group-name it will keep you on that 'Group -- Zoomed in' view. If you add outside of a group name, you will be left where you were before.
3. If you edit someone in a group it will keep you in that group if your changes remain in the same group-name.