Mplinuxman
~~~~~~~~~~
Version 1.4

MPMan F60/F55/F50 Manager for Linux
http://mplinuxman.sourceforge.net

For building/running on OS X , look at README.osx

To install

type "make"
which makes the executable mplinuxman in this directory
just copy it to where ever you want to execute it from (eg /usr/local/bin)

USB setup
~~~~~~~~~
You must have a driver for usb controller, and have the usbdevfs filesystem mounted.

to load the driver as a module type:
modprobe uhci
or
modprobe ohci

to mount usbdevfs type (if not already mounted):
mount -t usbdevfs usbdevfs /proc/bus/usb

*note: make sure the user you run mplinuxman as has permissions to read/write to files in 
/proc/bus/usb (see "USB device permissions" below on how to do this)


Hotplugging
~~~~~~~~~~~
In the extra directory is a file with an entry for usb.usermap for usb
hotpluggin, and a script to run mplinuxman from hotplug
To set this up get and install the hotplugging scripts from 

http://linux-hotplug.sourceforge.net

and do the following  from the source directory:

cat extra/mpf60.usermap >> /etc/hotplug/usb.usermap
or if you have a mpman f50
cat extra/mpf50.usermap >> /etc/hotplug/usb.usermap

cp extra/mplinuxman /etc/hotplug/usb/
edit the /etc/hotplug/usb/mplinuxman and change USBUSER to
your user, and the path to where the mplinuxman exe is located

*note: you may have to change the "0" zeros in the .usermap files to 0x0 


USB device permissions
~~~~~~~~~~~~~~~~~~~~~~
To Make sure other users (not root) can use USB devices:
To do this look at your /etc/fstab file.
Find/Add a line that has the word usbdevfs in it.
make sure the 4th word on this line has the option devmode=0666. for example

usbdevfs /proc/bus/usb usbdevfs devmode=0666 0 0
or
none /proc/bus/usb usbdevfs devmode=0666 0 0

type
mount -o remount /proc/bus/usb
to remount the filesystem


I18n support
~~~~~~~~~~~~
As of version 1.3 , there is support for language translations. If you want to contribute 
a translated message file please email them to me and I will upload them to the website. 

To make a translation file, copy the template (po/mplinuxman.pot) to 
po/fr.po (eg. for a french translation), Do the translation of this file and then do a
"make install-po" to compile/install the translation.

To compile all translated message files (*.po) in the po directory , and install
the compiled translations in /usr/local/share/locale:
type "make install-po"

more info on GNU gettext
http://www.gnu.org/manual/gettext/html_chapter/gettext_toc.html


Mputil
~~~~~~
In the extra directory there is mputil, its a command line utility to send/get/delete files
from the mpman. Type "make" from its directory to make.

This program uses libusb which is included.
http://libusb.sourceforge.net/

If find any bugs please eamil me
Tim O'Brien 
mild7@users.sourceforge.net


