This is the README file for Nomad Jukebox File System (njbfs)

Current version: 0.2

About njbfs
-----------

njbfs is a Linux file system for the Creative Nomad Jukebox.
Using automount capability, you can 'cd' to your Nomad Jukebox, read and
write tracks, and even ordinary files can be stored on your Jukebox.
This is the time when you can use your Jukebox as an external
MP3 or backup storage and accessing it as normal files. Play your music,
stream your MP3 into your favorite MP3 player xmms and be happy.
Manage your playlists, artists, and albums from your file manager like
KDE Konqueror, by renaming, loading, saving and deleting your tracks.
Add a CD ripping tool and move your CDs directly to the Nomad Jukebox.

Contact
-------

njbfs was developed by Jrg Prante <joergprante@gmx.de>
Feel free to send email if you have any questions. Also, visit the SourceForge project page to get more information:
	http://sourceforge.net/projects/njbfs/

Credits
-------

The code contains the Nomad driver by Karl Backstrm <backstrom@kde.org>
<http://www.lysator.liu.se/~backstrom/nomad-driver/>
and large parts of the fantastic FTP file system ftpfs
<http://ftpfs.sourceforge.net> by Florin Malita <fmalita@yahoo.com>.
Without the NJB protocol guide 1.5 of John Mechalas <seagull@aracnet.com>
and the study of the userspace NJB software <http://libnjb.sourceforge.net>
this software would never have been possible.

Supported Platforms and software requirements
---------------------------------------------

njbfs was written for Linux and works with kernel versions 2.4.x
It has been successfully been tested on Suse Linux 7.2 on a
Dell Inspiron 8100 Notebook (Intel 0x386 architectures).
Other machines are not tested at all, the code has surely to be adopted.
You need
gcc >=2.95.3
ld >=2.10.91
GNU Make version >= 3.79.1

Obtaining njbfs
---------------

The latest version of njbfs can be downloaded from
http://njbfs.sourceforge.net

Kernel patch will be available soon.

Installation
------------

Please see the INSTALL file for more information.

Download MP3 tracks
-------------------

You can try to mount your NJB with

    cd /mnt/njbfs/tracks/
    ls -al

and after a while (10 seconds or so) you should see a complete
track listing of your NJB. Do not feel nervous when the file size attributes
don't match. This 'feature' is an NJB feature and still not explored.

Download a MP3 track

    cp \"njb - track.mp3\" /tmp/from-njb.mp3


Uploading MP3 tracks
--------------------

Uploading needs a trick! The NJB insists of the file size of the source at the
beginning of a track upload, but in a transparent file system, the size is
unknown at the beginning of a transfer. Now we help with a trick. We just
add the size of the file as stated by 'ls -l' to the *target* file name.

    cd /mnt/njbfs/tracks/
    cp "/tmp/Artistname - Title.mp3" "Artistname - Title.mp3,size=123456"  .

Now, njbfs will upload the track with the necessary information title, artist,
and size of the track.

Note: Artist and title *must* be arranged in the filename as given in the
example above. They *must* be separated by a " - ", a hyphen grouped by two
space characters. The size *must* be appended after the name starting with
",size=", followed by a numerical string which *must* exactly match the
file size.

Do not worry about uploading takes longer than on the PlayCenter2. The
reason is that njbfs transfers in 1024 byte buffers. This is a file system
restriction and will be improved in future versions. Genres and album
titles can't be submitted yet, this will also be improved.

You can watch driver info messages with 'tail -f /var/log/messages' as root.

Todo
----
* albums, artists, playlists
* ID3 smart recognition


Bugs
----
Send bug reports to the njbfs bug mailing list at SourceForge 

njbfs-bugs@lists.sourceforge.net


Mailing Lists
-------------
There is a developer list available at SourceForge:

njbfs-devel@lists.sourceforge.net


