  Gnometoaster User Manual
  Andreas Eckleder


  an attempt to describe the various features and bugs of Gnome Toaster
  ______________________________________________________________________

  Table of Contents


  1. Introduction

  2. Installing Gnome Toaster

     2.1 Before you install Gnometoaster
     2.2 Compiling and installing Gnometoaster
     2.3 Troubleshooting - What if Gnometoaster wont compile ?

  3. Configuring Gnome Toaster

  4. A Quick guide to Gnometoaster

     4.1 The Source Part
     4.2 The Destination Part
        4.2.1 The Filesystem Editor
           4.2.1.1 adding files to a data cd
           4.2.1.2 creating Directories on a data cd
           4.2.1.3 deleting files and directories from your cd
        4.2.2 The Track Editor
        4.2.3 The Recording Section

  5. FAQs and FOPs (frequently occurring problems ?!?)



  ______________________________________________________________________

  11..  IInnttrroodduuccttiioonn

  Gnometoaster is an attempt to gap a certain lack of intuitive and
  easy-to-use software within the Linux Community. Although most of the
  programs available for the Linux Operating System are very
  powerful,few of them are user-friendly,although with Gtk,Qt etc.
  developers would have the means to create comfortable user interfaces.
  Gnometoaster is intended to be a complete CD Creation Suite rather
  than just a mere front end to cdrecord/cdda2wav,... The way
  Gnometoaster uses those programs could best be described as accessing
  device drivers. Gnometoaster tries to achieve as much as possible by
  itself,relying on its "drivers" only when drivers are necessary,e.g.
  if theres more than one way of creating/writing/reading specific data
  as is the case when reading audiotracks and actually accessing the cd
  writer because there is no single standard describing how to read
  audio tracks from cdroms or how to access cd writers. cdda2wav and
  cdrecord are currently the most common way to access cdwriters and
  audiotracks and so those programs are used for exactly one purpose:
  providing hardware support within the Linux environment.


  FFeeaattuurreess::

  +o  Easy to use GUI including Wheelmouse support

  +o  supports all cd writers supported by CD Record

  +o  CDrewritable support

  +o  (scalable) Audiotrack support for .wav(,.mp3,...)

  +o  copying cdroms on the fly

  +o  precaching of tracks originating from slow data sources

  +o  Joliet and Rockridge support using mkhybrid

     _f_e_a_t_u_r_e_s _i_n _b_r_a_c_k_e_t_s _a_r_e _n_o_t _y_e_t _i_m_p_l_e_m_e_n_t_e_d


  22..  IInnssttaalllliinngg GGnnoommee TTooaasstteerr

  22..11..  BBeeffoorree yyoouu iinnssttaallll GGnnoommeettooaasstteerr

  Before you install Gnometoaster,make sure you have at least gtk 1.2
  plus the development files (the headers)  for gtk installed on your
  system.  gtk-config has to return the right values for your gtk-
  directories and files (test with "gtk-config --cflags --libs").  You
  can get a current version of Gtk from  <http://www.gtk.org>.  (if you
  have Gnome installed on your system youll get some advantages in
  future releases of Gnome Toaster,e.g. Multilanguage support,nice Icons
  etc.You can obtain Gnome from  <http://www.gnome.org>)

  This is really all you need to compile Gnometoaster.  In order to
  actually use it,youll need a copy of the Cdrecord package by Joerg
  Schilling. To read out audiotracks from cds youll additionally need
  cdda2wav or any similar program. Another program called sox enables
  preliminary wav file processing. Configuring Cdrecord etc. should not
  be a problem with the only issue about them being that they have to be
  available in your standard unix search path.At least sox currently has
  to,all other programs locations and settings can be edited in
  Gnometoasters Preferences Menu,a process described more detailed in
  Section ``Configuring Gnometoaster''.


  22..22..  CCoommppiilliinngg aanndd iinnssttaalllliinngg GGnnoommeettooaasstteerr

  to install Gnome Toaster,first get the gtoaster-Archive from
  <http://gnometoaster.home.pages.de> and decompress it into a directory
  of your choice. enter the directory called gtoaster and type "make".
  This should start building your program.After the building process has
  finished type "make install",which will install Gnometoaster in
  /usr/local/bin/gtoaster.


  22..33..  TTrroouubblleesshhoooottiinngg -- WWhhaatt iiff GGnnoommeettooaasstteerr wwoonntt ccoommppiillee ??

  Problems during compilation are at a rate close to 90% caused by a
  misconfigured Gnome/Gtk environment. Make sure gtk-config returns the
  right values.Also ensure you have a recent version of Gtk installed on
  your system.  Youll need at least Gtk1.2 and its corresponding glib1.2
  to run Gnometoaster. For the case you really cant solve your
  compilation problem try compiling other gtk software. If this should
  work pplleeaassee submit a bug report to A.Eckleder@bigfoot.com
  <mailto:A.Eckleder@bigfoot.com>. Do the same thing if you experience
  any unwanted behavior etc. Bugs that arent reported will probably
  never be fixed.


  33..  CCoonnffiigguurriinngg GGnnoommee TTooaasstteerr

  The preferences setup of Gnometoaster is probably still the worst-
  implemented part of the whole project.  Generally,you click
  Edit/Preferences to open up the preferences window. This window
  contains a few control buttons on its bottom and a few
  configuration"pages".You can toggle between those pages by clicking
  the text describing the respective part of the configuration setup.
  The button "Apply" applies all the changes done to the configuration
  and reinitializes parts of Gnometoaster with the new values.  The "Ok"
  Button is pretty much the same,only it hides the preferences box
  afterwards."Undo" restores the preferences entries to the values they
  had before they were edited. "Cancel" does the same and just like "ok"
  hides the preferences box afterwards.  If youre running Gnometoaster
  for the first time you should first of all create two Directories
  Gnometoaster needs for internal purposes.  The first one is the
  directory where Gnometoaster will store its temporary files (e.g.
  tracks that cant be read quickly enough to be written directly to a
  cdrom have to be stored on your harddrive). The drive this directory
  resides in should have at least 650MB of free disc space available
  unless you want to write everything on the fly (without precaching).
  Enter the name of this directory including its full unix path instead
  of the path displayed besides the label "Temp files" on the page
  called "Common".  (Entry locations will be referred to as Page/Label
  from now on.  The Second path you need is entered at ISO9660/"CDfs
  Area". It will usually contain nothing more than a few symbolic links
  to the actual files to be stored on your disc,so you wont need much
  disc space for that directory.  Next,enter a list of the cdrom drives
  your system has in "CDROM Drive Setup"/"valid drives".Simply name the
  device names associated with your drives separated by spaces here.
  Now,enter the device name of your cd recorder in Recorder/"Recorder
  device" and its full scsi id in Recorder/"SCSI ID". The scsi id does
  usually consist of two numbers: the scsi id and the lun(logical unit
  number) of the drive you want to specify. However,if you have more
  than one scsi card installed on your system (the ide2scsi interface
  counts as an additional scsi card),you have to specify three number in
  the order scsi bus,scsi id,lun.  This should usually be it,all the
  other configuration entries should usually contain working default
  values. They mainly describe the way how Gnometoaster calls its client
  programs like cdrecord or cdda2wav,which should be pretty
  consistent,even among different versions of the client software.If you
  should have to change those settings one day,make sure you consult the
  documentation available for the respective client programs.  Variables
  used in those calls are replaced at runtime with their respective
  values.


  44..  AA QQuuiicckk gguuiiddee ttoo GGnnoommeettooaasstteerr

  Generally,the Gnometoaster window is shared between a sourcepart
  filling the upper half and a destination part residing in the lower
  half of your screen.


  44..11..  TThhee SSoouurrccee PPaarrtt

  The Sourcepart contains the various sources files or tracks may come
  from,e.g. your cdrom drives,your filesystem tree and a section called
  "internal structures",where all the structures usually created on the
  fly from meta data reside,e.g. "Isofs track",a virtual iso track
  containing the data edited in your ``filesystem editor''.  Creating a
  data-only cd is merely a matter of editing your Filesystem with the
  ``Filesystem Editor'' and dropping the virtual isotrack onto the
  ``Track editor''.


  44..22..  TThhee DDeessttiinnaattiioonn PPaarrtt

  The destination section of Gnometoaster is shared between the
  Trackeditor,the Filesystem Editor and the recording section. You can
  switch between them by clicking the icons to your left.

  44..22..11..  TThhee FFiilleessyysstteemm EEddiittoorr

  The Filesystem editor is used to create data tracks.  The left part of
  the Filesystem editor section contains the current directory tree of
  your CD.


  44..22..11..11..  aaddddiinngg ffiilleess ttoo aa ddaattaa ccdd

  adding a file to a data cd is rather simple: select the desired file
  from your Filesystem tree displayed in the source Section of
  Gnometoaster.  You can select multiple files by holding down your
  control key when clicking the files. You can also select a whole
  column of files by selecting the first item you want to select,holding
  down the shift key of your keyboard and clicking the last desired
  item.  moving your mouse while still holding the left mouse button
  will solve your selection from the source window (the shape of your
  mouse cursor changes).  Do now move the mouse to the directory of the
  Filesystem Editor you want the selected files to reside.Moving files
  into the filelist displayed on the right of your cds filesystem tree
  will create a copy of your files within the directory displayed there.


  44..22..11..22..  ccrreeaattiinngg DDiirreeccttoorriieess oonn aa ddaattaa ccdd

  Select the directory you want your new dir to reside in and click it
  with your right mouse button. This will show a popup menu at the
  position of your mouse pointer. Select "Create Directory" there and
  enter the desired directory name.


  44..22..11..33..  ddeelleettiinngg ffiilleess aanndd ddiirreeccttoorriieess ffrroomm yyoouurr ccdd

  to delete a specific file or directory (see ``adding files'' about how
  to select multiple files) select the desired file(s) and click your
  right mouse button. Select "delete" in the menu popping up at the
  position of your mouse pointer.


  44..22..22..  TThhee TTrraacckk EEddiittoorr

  Using the track editor is rather simple at the moment as theres not
  much it can currently do. Essentially you drop whatever tracks you
  want to have on your cd onto the track editor in the order you want
  them to be recorded.  You can use all the sources displaying the upper
  half of your Gnometoaster window including CDrom Drives,Internal
  Structures and files.  Gnometoasters preliminary filetype recognition
  currently knows .wav as the only supported cd digital audio format.
  All other filetypes will end up as a data track on your cd.


  44..22..33..  TThhee RReeccoorrddiinngg SSeeccttiioonn

  Within the recording section the actual recording process can be
  initiated.  To do so,simply click the record button. Make sure your
  cdwriter contains an empty cd recordable or cd rewritable medium.  You
  can usually check this by selecting your cd recorder in the source
  section and seeing wether there are any tracks displayed in its
  tracklist.  Additionally,you can use the "clear cdrw" button to strip
  a cd rewritable medium off its previous contents. Enabling the "TOC
  only" option will speed up this process immensely as the TOC (Table of
  contents) of your cd is the only thing being deleted.  During the
  recording process youll see a progress box appearing in front of your
  Gnome Toaster application displaying the current throughput of the
  writing process,the time elapsed since the recording process of the
  current track started and the estimated time remaining for the current
  track.  As this message box is made modal you wont be able to edit
  anything within Gnometoaster during the writing process.


  55..  FFAAQQss aanndd FFOOPPss ((ffrreeqquueennttllyy ooccccuurrrriinngg pprroobblleemmss ??!!??))

  Why does Gnometoaster generate my precache tracks in /tmp or a similar
  directory regardless of what I give it in the preferences setup ?

  The answer is rather simple. Gnometoaster uses a libc call to generate
  the names of its temporary files. However,the corresponding call is
  not very interested in what directory you tell it to create your files
  in if youve set an environment entry called TMPDIR. This entry
  overwrites whatever Gnometoaster gives the libc function as a default.
  Try to unset this environment entry or set it to the directory you
  want your tracks to be created in.


















































