Menu Close

Unix/Linux installation

Unix installation:

  1. Download the g-zipped tar archive: cd2browse_105.tgz
  2. Make sure Perl, ImageMagick and Perl Magick is installed
  3. Make sure xpdf is installed – this is the case on most linux dist.
  4. If you want to index MS Office files, make sure catdoc is installed – if not, download and install from: and compile it according to the package information
  5. Install the necessary perl modules. Depending on the distribution, your Perl packages may be installed using your  pagage manager. For OpenSuse for example the Packages are on the Installation DVD and can be installed using “yast”. If your distribution does not contain various perl modules, you can download them from cpan.
    In this case Type:
    cpan <enter>
    when you do this for the first time, you need to answer some questions – in most cases, the default settings should be sufficient.
    When cpan shows its prompt, type:
    cpan> install CGI::FastTemlate <——- The Module will be searched on the internet and installed
    cpan> install File::Mirror <——- same
    cpan> install Module::Load::Conditional <——- same
    cpan> install HTML::Strip <——- same
    cpan> install Tk <——- same
    cpan> install MP3::Info <——- same
    cpan> quit
  6. Unpack the gnu zipped tar archive to the root (/) directory.
  7. Install the file, and CD2browse.hlp somewhere in your file tree. By default it goes to /var/opt/cd2browse  – you may copy the perl scripts to /usr/local/bin
    Alternatively you can instruct your shell to search for executables also in /var/opt/cd2browse by adding this path in the “path” variable of your shell.
  8. Install the skeleton and template files to /var/opt/cd2browse – this is the default path – to change the default path, change the variable section of or create a Environment Variable named “C2BPATH” containing the path to the templates.

With perl <path to>/ you start the GUI (if the PATH has not been set it may help to first change the directory to /var/opt/cd2browse

To test, type: perl <path to>/

If you see the following message, you have successfully installed cd2browse:

usage: perl -p <path to index> [-n -m -t -s -i -x -r -q -v]

-i  do not index images(all over the file tree)
-m  maxwidh of the preview image (default=800)
-n  (re) calculate no images to save cpu time
-q  be quiet – do not output progress information
-r  do not use offline sort – needs a different template page.tpl
-s  size of the thumbnails (default=90×90)
-t  title
-v  do not create folder navigation in the page section
-x  do not extact title from pdf file (all over the file tree)

Leave a Reply

Your email address will not be published. Required fields are marked *