# The &kiso; Handbook

## Introduction

&kiso; is a program that makes it easy to handle ISO/NRG-Images.

Please report any problems or feature requests to kiso@linuxmail.org.

## Using &kiso;

### Creating a new image

After selecting this action, KIso asks, if you would like to create an image of a CD. If so, please insert a CD into your CD-Drive an click "Yes". If you want to create an own image click "No". Now you can add files to your image with the help of the button "Add File", the corresponding entry in the menu or the contextmenu within the filebrowser.

Through drag'n drop with the help of the directorytree on the left hand side of the mainwindow or the contextmenu directorys can be added. If you wish to create a new directory, this can also be done with the contextmenu. Images can be merged through dragging them from the directorytree to the mainwindow. Through selection of files or directories in the filebrowser and pressing the Del-Key or the contextmenu within the filebrowser files and directories can be removed.

### Opening an image

After selecting this function, a filedialog will appear in which you can select the image to be opened. After pressing "OK" KIso will open the selected image.

### Extracting an image

To extract an image the image has to be opened first. For this purpose use the corresponding menu entry or button in the mainwindow. If an image was opened and the action extract image was chosen, a filedialog will appear, in which you can choose, where to extract the image to. Through pressing "OK", KIso will extract the image.

### Adding a file to an image

The addition of a file or directory to an image is done with the help of a filedialog. To add an entire directory use drag it from the directorytree on the left hand side of the mainwindow to the filebrowser. By dragging an image from the directorytree to the mainwindow you can merge images. Alternatively you can make use of the contextmenu.

### Saving an image

A filedialog appears, where you have to choose, where and under which name the actual image shall be saved. By pressing "OK", KIso begins to create the image.

### Converting an image

Choose image which you want to convert to an ISO image in the filedialog that will appear. After pressing "OK" the conversion begins. The resulting ISO-Image can be found in the same directory as the original file or if you don't have write access to this directory it is posed into your home directory. Currently supported formats are: BIN/CUE, C2D, CDI, IMG, MDF and NRG.

### Encrypt an image

Choose this entry to create a copy of an image encrypted with the algorithm rijndael-128. This is useful for backups with critical content. The encryption makes use of the program mcrypt which thus has to be installed on your system. Please be aware that the work with encrypted images consumes double of the space on your harddisk.

### Burning an image

With the help of a filedialog you can choose the image to be burned. After pressing "OK", KIso starts the burning program, and passes over the image file.

### Open in Hexeditor

Use this entry to open the actual image in an hexeditor.

### Adding a bootimage

Just choose the Add bootimage entry within the extras menu or push the corresponding button. You will then be given a filedialog where you can choose the bootimage to add. If added an image, this will be indicated by an icon on the upper left corner of the file window. The bootimage can be removed with the contextmenu. You can obtain a bootimage from every bootable diskette by using the dd command for example.

### Setting the lable for a CD/DVD

Choose the Set label entry within the extras menu. Now you can enter a new label for the image. Otherwise the label is the same as the name of the image.

### Setting the publisher id

Choose the Set publisher id entry within the extras menu. Now you can enter a new publisher id for the image.

### Renaming a file or directory

To rename a file or directory just make a rightclick on it and choose "Rename" from the contextmenu.

### Show image information

This dialog shows information about the current image such as: System Id, Volume Id, Publisher Id, Preparer Id and Application Id.

### Scan drive

This dialog shows information about the CD/DVD drive chosen and inserted media.

### Preferences

--General--

After choosing this entry, a window appears, where you can choose the general settings of KIso.

Standart Drive: Here you can choose which drive KIso shall normaly use to read from.

CD Size: Here you can choose a CD Size, so that KIso can estimate how full a CD would be with your current selection, if you create or manipulate an image.

KIso Skin: Here you can choose a skin for KIso. If this field is empty, KIso uses it's standart surface.

To learn how to create a skin for KIso please read the manual.

Show hidden files: This determines if hidden files within the filesystem shall be shown.

Button sounds: Here you can choose wether or not KIso shall play sounds when hovering over a button.

--Helping Applications--

Burn Program: Here you can tell KIso which program to use to burn images.

Audio Ripper: Here you can choose which program KIso shall use to rip Audiotracks.

Hexeditor: Here you can choose which hexeditor KIso shall make use of.

Through confirmation with "OK", KIso will save and activate the new settings. A new skin will become active after the next start.

## Command Reference

### The main &kiso; window

#### The CD Image Menu

&Ctrl;N CD Image New image

- Begin a new ISO-Image.

&Ctrl;O CD Image Open image

- Open an ISO-Image.

&Ctrl;E CD Image Extract image;

- Extracts the current image.

&Ctrl;A CD Image Add file;

- Adds a file to the current image.

&Ctrl;S CD Image Save image;

- Saves the current image.

&Ctrl;C CD Image Convert image

- Converts a BIN/CUE, C2D, CDI, IMG, MDF or NRG-Image to an ISO-Image.

&Ctrl;Y CD Image Encrypt image

- Create a GPG encrypted copy of an image.

&Ctrl;Q CD Image Leave KIso;

- Quits &kiso;

#### The Extras Menu

&Ctrl;B Extras Burn image

- Lets you burn the current image.

&Ctrl;H Extras Open in Hexeditor

- Opens the actual Image within an hexeditor.

&Ctrl;I Extras Bootimage

- Lets you add an bootimage to the current ISO-Image.

&Ctrl;L Extras Set label

- Set the label of the current image.

&Ctrl;D Extras Set publisher id

- Set the publisher id of the current image.

&Ctrl;G Extras Image information

- Show information about the current image.

&Ctrl;R Extras Scan drive

- Shows information about the CD/DVD drive and inserted media.

&Ctrl;P Extras Preferences

- Open the preferences of KIso.

#### The Help Menu

&help.menu.documentation;

## Questions and Answers

If you have discovered any bug or problem please report it to:

mephistoki@users.sourceforge.net

My Mouse doesn't work. How do I quit &kiso; ?

Take a look at the Commands Section for the answer.

KIso wants me to start it as root first. How do I do that ?

You have to start a KDE session as root and start KIso. Sudo in the console won't work.

Why can't I start KIso as normal user even if I already started it as root once ?

Make sure you have sudo installed on your system.

Why do some files and directorys disappear in the image ?

Make sure you have readaccess to them.

Why do audiotracks disappear in the image ?

A CD image cannot contain audiotracks.

## Credits and License

&kiso;

Program copyright 2005 Stephan Gans mephistoki@users.sourceforge.net

Contributors:

- Konqui the KDE Dragon konqui@kde.org

- Tux the Linux Penguin tux@linux.org

Documentation copyright 2005 Stephan Gans

mephistoki@users.sourceforge.net

&underFDL; &underGPL;

## Law and order

The only purpose of KIso is to help making backups of not copyprotected and free optical media. The author is not to take into regress on copying of copyprotected CD's/DVD's and/or CD's/DVD's with copywrighted content with KIso and/or their further spread. This completely lies in the resposibility of the user.

## Installation

### How to obtain &kiso;

The newest release of &kiso; can be downloaded at http://kiso.sourceforge.net.

### Requirements

In order to successfully use &kiso;, you need &kde; 3.0 or higher. In addition &kiso; makes use of the package sudo, mkisofs and the libcdio which have to be installed.

&kiso; can be found on The KIso homepage. The package sudo and mkisofs should be part of your distribution. The libcdio can be found here.

A Full list of changes can be found in the Changelog.

### Compilation and Installation

&install.compile.documentation;
&documentation.index;