JCataloger v1.0 beta

An archive program 

1. Introduction
2. Terminology
3. Usage of the program
3.1 Main Screen
3.2 Creating A New Catalog
3.3 Opening A Catalog
3.4 Saving A Catalog
3.5 Adding An Image
3.6 Deleting An Image
3.7 Searching
4. Keyboard Shortcuts

1. Introduction

JCataloger is a program that you can use it for cataloging your archive CDs, DVDs, disk drives... For example you have a 1000 cd collection. You want to find a program that in the archive but you do not remember where it is. JCataloger helps you to find it. It stores the directory structure of your CDs and indexes them. So you can search the file you want and JCataloger says where the file is.
It uses Apache lucene project for indexing in the background. Lucene is a fast indexer. It uses several algorithms in background to increase. In JCataloger, finding what you want is important but find it fast is more important. Therefore lucene is used in background intead of implenting indexing part myself.

2. Terminology

Before explaining the program, i want to talk about the terminology the program used.
Catalog: Every project that you created in the program is a catalog. Catalog consists of images.
Image: A CD, DVD, disk drive or a usb disk is an image source for the program. Program takes the directory structure of these elements and stores them. So the directory structure is the image.

3. Usage of The Program

3.1 Main Screen

In Figure 1 you can see the main screen of the program.

Figure 1. Main Screen

3.2 Creating A New Catalog

In the main screen when you click the new button () or when you select the "New" item in the "File" menu you create a new catalog project.

3.3 Opening A Catalog

Catalog projects are saved into a file. The file has an extension .cat. When you want to open a catalog, you can click the open button () or you can select the "Open" item in the "File" menu.

3.4 Saving A Catalog

When you want to save a catalog, you can click the save button () or you can select the "Save" item in the "File" menu.
Also you can select "Save As..." item from the File menu and save the catalog into a different file.
A save dialog opens in saving operation. You select the directory that you want to save the file. Saved file's extension is "cat".

3.5 Adding An Image

When you want to add an image to the catalog, you can click the add button () or you can select the "Add..." item in the "Tools" menu. Then "Root Selection Screen" appears as in Figure 2.


Figure 2. Root Selection Screen

In the screen you select a root directory for the image. This screenshot is from Linux operating system. So it is different from windows. In windows, it will appear like C:, D:, E: ... After selecting a directory program add the image to the catalog and indexes the image.

3.6 Deleting An Image

When you want to delete an image from the catalog, you can click the delete button () or you can select "Delete" menu item from the "Tools" menu.

3.7 Searching

When you want to search a file in your catalog, you can click search button () or you can select "Search..." menu item from the "Tools" menu. After you select search, the search screen appears like in Figure 3.


Figure 3. Search Screen

On the search screen you enter the key word in the text field and click the search button to search the keyword. If you want case sensitive search, check the match case check box. For example; when you want to search "a" for the catalog that shown in Figure 1. The resul are like in Figure 4.


Figure 4. Search Results

In the results name of the file, type of it (directory or file), real path of the file in your disk, image name, length of the file (i.e. gb, mb, kb or bytes), extension of the file are shown.

4. Keyboard Shortcuts

  • CTRL-N: Creates a new catalog.
  • CTRL-O: Opens an existing catalog.
  • CTRL-S: Saves a catalog to a file.
  • CTRL-A: Add a disk image to the catalog.
  • CTRL-D: Deletes a disk image from the catalog.
  • CTRL-F: Searchs the catalog for a file.
  • F1: Opens help.