BookListGen GUI is a graphical version of BookListGen (A BookList generator
for the Sony LIBRIe e-book reader). BookListGen GUI can add/delete LRF e-book 
files from a mounted memory stick, as well as create the directory structure 
necessary for use on a LIBRIe. BookListGen GUI is written in C# and runs under
Win32/Linux.

Version 0.5.0 also includes the ability to set the BookList/LRF meta-
information.


Requirements
------------

  * A recent version of mono (http://www.go-mono.com) on Linux, or the MS 
    .NET framework for Win32.

  * GTK#, if you're using .NET (this should be included with Mono).

  * #ZipLib. You can download this from the following location (A dll file is
    also included with BookListGenGUI):
  
    http://http://www.icsharpcode.net/OpenSource/SharpZipLib/Default.aspx


Compiling From Source
---------------------

  * Precompiled executables for both Linux (mono) and Win32 (.NET) are
    provided. If you wish to compile yourself, the process is different 
    depending on the platform used:

    Linux
    -----
    Mono and GTK# need to be installed (GTK# is included with recent
    versions of Mono). #ZipLib also needs to be available. Once the
    necessary software has been installed, run build.sh.

    Win32
    -----
    The MS .NET SDK needs to be installed. The GTK# library for windows
    is also required. It can be sourced from the following location:

    http://forge.novell.com/modules/xfmod/project/?gtks-inst4win

    #ZipLib must be installed. To compile the BookListGen GUI, just cd 
    into the win32 subdirectory and run build.bat. If your GTK# library 
    is installed in a location other than the default (C:\GTK\), please 
    edit the build script first.


Installation
------------
 
  Linux
  -----
  Simply run 'mono booklistgengui.exe'. If all the required libraries
  are available, nothing further should be required.

  Win32
  -----
  The #ZipLib dll needs to be accessible.

  In addition to this, the GTK# dll files need to be available for 
  BookListGen GUI. You could  either copy all the dll files from 
  C:\GTK\2.4\bin into the same directory  as booklistgengui.exe, or you 
  could follow these instructions to set the path:

  - Open the registry editor, navigate to:
    HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths

  - Create a new key called booklistgengui.exe.

  - Create a string named Path.

  - Set the value of Path to be the directory where the dll files are located
    (e.g. C:\GTK\2.4\bin)


Usage
-----

* The first time that the BookListGen GUI is run, the preferences window will
  be opened. A root directory for the memory stick needs to be specified. Under
  Linux, this will be something similar to /mnt/memorystick. On windows, this
  will usually be a drive such as f:\ or g:\. If the memory stick does not yet
  contain a directory structure for the LIBRIe, click the appropriate button to
  generate the necessary structure. You can also change the order in which the
  books are listed in the preferences window.

* After the preferences have been saved, and a root directory has been
  selected, the main BookList window will open. Any books on your memory stick
  will be listed (the title, author, filename, thumbnail and file size will be
  displayed). This will be empty if the memory stick does not contain any
  e-book (LRF) files.

* A e-book (LRF) file can be added to the list by clicking the Add button. When
  an LRF file is added to the BookList the file will also be copied onto the
  memory stick, so it is not necessary to do this manually.

* To remove a file, click the Remove button. Removing a book from the BookList
  will also remove the associated LRF file from the memory stick, so make sure
  that you have a backup of this file somewhere else if you intend using it
  again in future.

* The Refresh button can be used to update the display (if a new memory stick
  has been mounted for example).

* The Preferences button will open the preferences window and the Close button
  will terminate the program. All changes are applied when they are made, and
  what you see in the list should match the state of the BookList on the
  memory stick at all times (i.e. There is no need to close the program to
  apply any changes).

* The meta-information can be set by double-clicking on a book in the booklist.

(HINT: If you don't like the default Win32 theme, run the gtkthemeselector.exe 
program and choose a new one)
