Even though the LIBRIe runs a modified version of Linux, Sony currently 
provide no software for Linux users to upload content. BookListGen is a 
way of transferring ebooks onto your LIBRIe, via memory stick, without 
using Windows.

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

  To compile BookListGen
  ----------------------

  * A recent version of mono (http://www.go-mono.com). BookListGen is written
    in C# and should be compatible with .NET under win32, but I haven't tried 
    it. I used the version of mono 1.0 in Debian unstable.

  * #ZipLib. You can download this from the following location:
  
    http://http://www.icsharpcode.net/OpenSource/SharpZipLib/Default.aspx
  
    After downloading the zip, extract it and drop ICSharpCode.SharpZipLib.dll
    into /usr/lib

  To use BookListGen
  ------------------
  
  * USB memory stick reader supported by Linux. After trying several models 
    (Dazzle, Packard Bell), the one which worked flawlessly for me was the 
    Belkin USB 2.0 15 in 1 reader. All the other models I tried would either 
    corrupt data on the memory stick, or would refuse to mount the media 
    without a reboot after a couple of mounts.  The Belkin model worked 
    perfectly.

  * A memory stick (or memory stick duo with the adapter).

  * A LIBRIe (Duh)

Mounting the Memory Stick
-------------------------

* After inserting the memory stick into the card reader, it should show up as 
  a SCSI disk device. On the Belkin 15 in 1 reader, the memory stick slot is
  sdb, but it will be different depending on which card reader is being used.
  By default, there is a single FAT-16 (type 6) partition on the memory stick,
  which can be mounted in the following way:

  mount -t vfat /dev/sdb1 /mnt/memorystick

  Alternatively, the following entry can be placed into /etc/fstab:

  /dev/sdb1 /mnt/memorystick vfat defaults,noatime,user,noauto,rw 0 0

  This will allow the memory stick to be mounted with the simpler command:

  mount /mnt/memorystick


Creating The Directory Structure
--------------------------------

There is a specific directory structure that is required on the memory stick.
The following directories are necessary in the root of the memory stick:

/mssony/librie/booklist
/mssony/librie/usb
/mssony/librie/reader/book/lrf
/mssony/librie/reader/book/lrx
/ebook/bbeb/book

These directories can either be created manually, or with booklistgen, in the
following way:

./booklistgen.exe -c /mnt/memorystick


Transferring LRF Files Onto The Memory Stick
--------------------------------------------

Once the memory stick has been mounted, and the directory structure has been
created on it, LRF files can be copied into the /ebook/bbeb/book directory:

cp mybook.lrf /mnt/memorystick/ebook/bbeb/book


Generating the Index File
-------------------------

It would be nice if the LIBRIe could find all files in the /ebook/bbeb/book
directory automatically. However, this is not possible. An index, or booklist,
file (MgrTbl.dat) needs to be generated under the /mssony/librie/booklist
directory. This file is generated by running the booklistgen program in the
following way:

./booklistgen.exe /mnt/memorystick

When this command is executed, the LRF files under /ebook/bbeb/book will be
scanned, and an index file containing all of these books will be generated
under /mssony/librie/booklist.


Unmounting the Memory Stick
---------------------------

The memory stick now needs to be unmounted, to ensure that all data is written:

umount /mnt/memorystick


Loading the Memory Stick Into the LIBRIe
----------------------------------------

After inserting the memory stick into the LIBRIe, the main menu should contain
all the books that were added to the index.