<?xml version="1.0" ?> <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY kiso "<application>KIso 0.8</application>"> <!ENTITY kappname "&kiso;"> <!ENTITY package "kde-module"> <!ENTITY % addindex "IGNORE"> <!ENTITY % English "INCLUDE"> ]> <book lang="&language;"> <bookinfo> <title>The &kiso; Handbook</title> <authorgroup> <author> <firstname>Stephan</firstname> <othername></othername> <surname>Gans</surname> <affiliation> <address><email>mephistoki@users.sourceforge.net</email></address> </affiliation> </author> </authorgroup> <copyright> <year>2003</year> <year>2005</year> <holder>Stephan Gans</holder> </copyright> <legalnotice>&FDLNotice;</legalnotice> <date>2005-05-18</date> <releaseinfo>0.8</releaseinfo> <abstract> <para> &kiso; is an application which makes it easy to extract, create and manipulate ISO-Images. </para> </abstract> <keywordset> <keyword>KDE</keyword> <keyword>KIso</keyword> <keyword>ISO</keyword> <keyword>CD-Images</keyword> <keyword>CD</keyword> </keywordset> </bookinfo> <chapter id="introduction"> <title>Introduction</title> <para>&kiso; is a program that makes it easy to handle ISO/NRG-Images.</para> <para>Please report any problems or feature requests to kiso@linuxmail.org. </para> </chapter> <chapter id="using-kiso"> <title>Using &kiso;</title> <sect1 id="creation"> <title>Creating a new image</title> <mediaobject> <imageobject> <imagedata fileref="Images/New_Image.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> <para> 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. </para> </sect1> <sect1 id="open"> <title>Opening an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Open.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="extraction"> <title>Extracting an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Extract.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="add"> <title>Adding a file to an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Add.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="save"> <title>Saving an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Save.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="conversion"> <title>Converting an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Convert.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="encrypt"> <title>Encrypt an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Encrypt.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="burning"> <title>Burning an image</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Burn.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="hex"> <title>Open in Hexeditor</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Hex.png" format="PNG"/> </imageobject> </mediaobject> <para> Use this entry to open the actual image in an hexeditor. </para> </sect1> <sect1 id="boot"> <title>Adding a bootimage</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Boot.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="label"> <title>Setting the lable for a CD/DVD</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Label.png" format="PNG"/> </imageobject> </mediaobject> <para> 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. </para> </sect1> <sect1 id="publisherid"> <title>Setting the publisher id</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Publisher.png" format="PNG"/> </imageobject> </mediaobject> <para> Choose the Set publisher id entry within the extras menu. Now you can enter a new publisher id for the image. </para> </sect1> <sect1 id="renamefile"> <title>Renaming a file or directory</title> <para> To rename a file or directory just make a rightclick on it and choose "Rename" from the contextmenu. </para> </sect1> <sect1 id="information"> <title>Show image information</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Information.png" format="PNG"/> </imageobject> </mediaobject> <para> This dialog shows information about the current image such as: System Id, Volume Id, Publisher Id, Preparer Id and Application Id. </para> </sect1> <sect1 id="cdscan"> <title>Scan drive</title> <mediaobject> <imageobject> <imagedata fileref="Images/ScanCD.png" format="PNG"/> </imageobject> </mediaobject> <para> This dialog shows information about the CD/DVD drive chosen and inserted media. </para> </sect1> <sect1 id="prefs"> <title>Preferences</title> <mediaobject> <imageobject> <imagedata fileref="Images/Image_Preferences.png" format="PNG"/> </imageobject> </mediaobject> <para><emphasis>--General--</emphasis></para> <para>After choosing this entry, a window appears, where you can choose the general settings of KIso.</para> <para>Standart Drive: Here you can choose which drive KIso shall normaly use to read from.</para> <para>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.</para> <para>KIso Skin: Here you can choose a skin for KIso. If this field is empty, KIso uses it's standart surface.</para> <para>To learn how to create a skin for KIso please read the manual.</para> <para>Show hidden files: This determines if hidden files within the filesystem shall be shown.</para> <para>Button sounds: Here you can choose wether or not KIso shall play sounds when hovering over a button.</para> <para><emphasis>--Helping Applications--</emphasis></para> <para>Burn Program: Here you can tell KIso which program to use to burn images.</para> <para>Audio Ripper: Here you can choose which program KIso shall use to rip Audiotracks.</para> <para>Hexeditor: Here you can choose which hexeditor KIso shall make use of.</para> <para> Through confirmation with "OK", KIso will save and activate the new settings. A new skin will become active after the next start. </para> </sect1> </chapter> <chapter id="commands"> <title>Command Reference</title> <sect1 id="kiso-mainwindow"> <title>The main &kiso; window</title> <sect2> <title>The <guimenu>CD Image</guimenu> Menu</title> <para> <variablelist> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>New image</guimenuitem> </menuchoice></term> <listitem><para><action>Begin a new ISO-Image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Open image</guimenuitem> </menuchoice></term> <listitem><para><action>Open an ISO-Image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Extract image;</guimenuitem> </menuchoice></term> <listitem><para><action>Extracts the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Add file;</guimenuitem> </menuchoice></term> <listitem><para><action>Adds a file to the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Save image;</guimenuitem> </menuchoice></term> <listitem><para><action>Saves the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Convert image</guimenuitem> </menuchoice></term> <listitem><para><action>Converts a BIN/CUE, C2D, CDI, IMG, MDF or NRG-Image to an ISO-Image. </action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Y</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Encrypt image</guimenuitem> </menuchoice></term> <listitem><para><action>Create a GPG encrypted copy of an image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </shortcut> <guimenu>CD Image</guimenu> <guimenuitem>Leave KIso;</guimenuitem> </menuchoice></term> <listitem><para><action>Quits</action> &kiso;</para></listitem> </varlistentry> </variablelist> </para> </sect2> <sect2> <title>The <guimenu>Extras</guimenu> Menu</title> <para> <variablelist> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Burn image</guimenuitem> </menuchoice></term> <listitem><para><action>Lets you burn the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Open in Hexeditor</guimenuitem> </menuchoice></term> <listitem><para><action>Opens the actual Image within an hexeditor.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>I</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Bootimage</guimenuitem> </menuchoice></term> <listitem><para><action>Lets you add an bootimage to the current ISO-Image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Set label</guimenuitem> </menuchoice></term> <listitem><para><action>Set the label of the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Set publisher id</guimenuitem> </menuchoice></term> <listitem><para><action>Set the publisher id of the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Image information</guimenuitem> </menuchoice></term> <listitem><para><action>Show information about the current image.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Scan drive</guimenuitem> </menuchoice></term> <listitem><para><action>Shows information about the CD/DVD drive and inserted media.</action></para></listitem> </varlistentry> <varlistentry> <term><menuchoice> <shortcut> <keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo> </shortcut> <guimenu>Extras</guimenu> <guimenuitem>Preferences</guimenuitem> </menuchoice></term> <listitem><para><action>Open the preferences of KIso.</action></para></listitem> </varlistentry> </variablelist> </para> </sect2> <sect2> <title>The <guimenu>Help</guimenu> Menu</title> &help.menu.documentation; </sect2> </sect1> </chapter> <chapter id="faq"> <title>Questions and Answers</title> <para> If you have discovered any bug or problem please report it to: </para> <para> <email>mephistoki@users.sourceforge.net</email> </para> <qandaset id="faqlist"> <qandaentry> <question> <para>My Mouse doesn't work. How do I quit &kiso; ?</para> </question> <answer> <para>Take a look at the <link linkend="commands">Commands Section</link> for the answer.</para> </answer> </qandaentry> <qandaentry> <question> <para>KIso wants me to start it as root first. How do I do that ?</para> </question> <answer> <para>You have to start a KDE session as root and start KIso. Sudo in the console won't work.</para> </answer> </qandaentry> <qandaentry> <question> <para>Why can't I start KIso as normal user even if I already started it as root once ?</para> </question> <answer> <para>Make sure you have sudo installed on your system.</para> </answer> </qandaentry> <qandaentry> <question> <para>Why do some files and directorys disappear in the image ?</para> </question> <answer> <para>Make sure you have readaccess to them.</para> </answer> </qandaentry> <qandaentry> <question> <para>Why do audiotracks disappear in the image ?</para> </question> <answer> <para>A CD image cannot contain audiotracks.</para> </answer> </qandaentry> </qandaset> </chapter> <chapter id="credits"> <title>Credits and License</title> <para> &kiso; </para> <para> Program copyright 2005 Stephan Gans <email>mephistoki@users.sourceforge.net</email> </para> <para> Contributors: <itemizedlist> <listitem><para>Konqui the KDE Dragon <email>konqui@kde.org</email></para> </listitem> <listitem><para>Tux the Linux Penguin <email>tux@linux.org</email></para> </listitem> </itemizedlist> </para> <para> Documentation copyright 2005 Stephan Gans </para> <para> <email>mephistoki@users.sourceforge.net</email> </para> &underFDL; &underGPL; </chapter> <chapter id="law"> <title>Law and order</title> <para> 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. </para> </chapter> <appendix id="installation"> <title>Installation</title> <sect1 id="getting-kiso"> <title>How to obtain &kiso;</title> <para> The newest release of &kiso; can be downloaded at <ulink url="http://kiso.sourceforge.net">http://kiso.sourceforge.net</ulink>. </para> </sect1> <sect1 id="requirements"> <title>Requirements</title> <para> 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. </para> <para> &kiso; can be found on <ulink url="http://kiso.sourceforge.net">The KIso homepage</ulink>. The package sudo and mkisofs should be part of your distribution. The libcdio can be found <ulink url="http://www.gnu.org/software/libcdio/">here</ulink>. </para> <para> A Full list of changes can be found in the Changelog. </para> </sect1> <sect1 id="compilation"> <title>Compilation and Installation</title> &install.compile.documentation; </sect1> </appendix> &documentation.index; </book>
