Welcome to Katalog Documentation

Table of Contents

Katalog is a CD organizer for the K Desktop Environment

If you have many Cds and tons of downloaded files, but you aren't able to remember where you put a file when you need it, then Katalog may help you.

This application scans a folder and stores infos about each file, the results are put in tree called Catalog, you can add as many catalogs as you like and search them all in seconds.

The folder to search can be on your drive or on a removable media, such a CD, ZIP or floppy.

Katalog use XML as save format, the resulting file it's compressed on the fly using bzip2.

I start to write this application tring to port the excellent KDE 1.x application kdiskcat to KDE 3.x, but the part of the KDE API involved is changed radically so I write Katalog from scratch, anyway from kdiskcat I take the idea for the the graphic interface and some of the features. Katalog is similar (but less mature) to gtktalog, an application for GNOME.

Return to Table of Contents

Brief description of the interface

The main view of the application is the Viewer, here you can add a new catalog or edit an entry. In the Viewer you can see a tree and a detailed list, the former shows the structure of directories in the catalog, the second shows the contents of the currently selected entry in the tree view.

To search an entry you can use the Search View, it works in a simplified mode where you can select only the name of the file and the catalog to search, or in a more detailed mode where you can provide size, date and categories of the file.

In the Categories View you can add, edit or remove categories, a category is a pair Name-Description that you can associate with an entry in the catalog.

In the Documentation View you can browse the documentation. When you first launch the application you start here.

Return to Table of Contents

Scanning a folder

Add a Catalog Now lets start with your first Katalog, click the add button in the bottom of the Viewer, fill the name of the catalog and select the mount point (the folder to start the scan). Now click Done, wait some moment and the new catalog is ready!

If you change idea and you don't want to add a new catalog, simply click the add button another time and the dialog disappears.

Optionaly you can add some category before opening the dialog, so you can select the categories which the catalog belongs, furthermore you can check the "Propagate categories to children" Check Box to automaticaly set the categories of all the entries of the catalog.

Return to Table of Contents

Modifing an entry

Once you have added a catalog you may want to modify an entry, to do this select the entry to modify (in the view that you like more), click the corresponding edit button and modify whatever you want, the dialog shows all the categories available and preselects those belonging to the current entry. If the entry is a folder you can use the "Propagate categories to children" Check Box to recoursively set the categories in each file of the folder.

The Done button applies the change, instead, if you click the edit button another time, the dialog disappears and the changes are discarted.

Deleting an entry is even simplier: select the entry that you want to delete and click the Remove button, Be carefull: there's no undo button if you make a mistake.

Return to Table of Contents

Searching a file

In the Search View you can search an entry in all the catalogues. In the default mode you can search only using name and catalog criteria, but clicking the More >> button activates more sofisticated criteria: Search View

If you leave a criteria to the default value it will be ignored.

Return to Table of Contents

Adding and Modifing categories

In the Categories View you can easily add, edit or remove a category: Categories View

Return to Table of Contents