Differences

This shows you the differences between two versions of the page.

--- netmdpython [2010/06/19 14:28] – glaubitz
+++ netmdpython [2013/05/16 11:39] (current) – [Download] glaubitz
@@ Line 1: / Line 1: @@
 ====== NetMDPython ======
-NetMD Python is a collection of [[http://www.python.org/|Python]] scripts which allow to control NetMD devices on Linux, Unix and MacOS X (Windows is unfortunately not yet supported since //libusb// is too old on Windows). With NetMD Python, you can upload tracks from standard MDs with the help of the MZ-RH1 Walkman to your PC, list the contents of any standard MD with any NetMD device and control and record tracks over analog input with any NetMD device.
+NetMDPython is a collection of [[http://www.python.org/|Python]] scripts which allow to control NetMD devices on Linux, Unix and MacOS X (Windows is unfortunately not yet supported since //libusb// is too old on Windows). With NetMD Python, you can upload tracks from standard MDs with the help of the MZ-RH1 Walkman to your PC, list the contents of any standard MD with any NetMD device and control and record tracks over analog input with any NetMD device. A recently added and therefore still very hacky script called "downloadhack.py" allows to download tracks to a NetMD.
 ===== Requirements =====
@@ Line 21: / Line 21: @@
 <code>
-sudo port install libusb git-core
+sudo port install libusb git-core py26-crypto sox
 </code>
@@ Line 27: / Line 27: @@
 <code>
-sudo apt-get install python2.6 libusb-dev git-core subversion
+sudo apt-get install python2.6 libusb-dev git-core subversion python-crypto sox
 </code>
 ==== Windows ====
-//Windows is not yet supported in the latest release of libusb. Thus the Python code cannot be run on Windows. There are however efforts now, to port libusb1.0 to Windows [[http://www.libusb.org/wiki/windows_backend|here]].//
+Download and install [[http://www.python.org/ftp/python/2.6.6/python-2.6.6.msi|Python2.6]], [[http://www.voidspace.org.uk/downloads/pycrypto-2.1.0.win32-py2.6.zip|PyCrypto]] and [[http://sourceforge.net/projects/sox/files/sox-win/14.3.1/|sox]].
-===== Download =====
+Download [[http://libusb-winusb-wip.googlecode.com/files/zadig.exe|zadig.exe]] (WinUSB device driver installer), connect your NetMD device and run //zadig.exe//.
-Clone the main source repository:
+Click //Options->List all devices//, choose your NetMD device an choose //Install Driver//.
+//**NOTE: SonicStage will not be able to communicate with your NetMD device anymore.
+If you want to use SonicStage again, you will have to uninstall WinUSB device driver first.**//
+(To uninstall the driver, run Windows "Device Manager", choose your device and uninstall it, you can find it at "libusb (WinUSB) devices".
+Then unplug and reconnect your device).
+Download latest version of [[http://github.com/vpelletier/python-libusb1/tree/|python-libusb1]] and replace usb1.py and libusb1.py in the //netmd// subdirectory of your //linux-minidisc// folder with the python-libusb1 versions. These versions can find and open libusb Windows DLL which has not been implemented in usb1.py and libusb1.py of current main source repository yet.
+Download and extract [[http://libusb-winusb-wip.googlecode.com/files/libusb_2010.10.14.7z|libusb windows backend]] and copy libusb1.0.dll to your
+windows/system32 folder (usually C:\WINDOWS\system32). Use the version according to your version of Windows, the mingw32 version should work on Windows XP 32-bit.
+Open a command prompt (Click //Start->Run//, type //cmd// and press enter) and type
 <code>
-git clone git://z6.physik.fu-berlin.de/linux-minidisc
+set PATH=<sox install dir>;%PATH%
+</code>
+to add the path of sox directory temporarily. (<sox install dir> means the path to your sox installation directory, usually C:\sox-14-3-1). To use it permanently you can add the path to your system variables.
+If you want to use ffmpeg to convert uploaded files, you can download Windows binaries of [[http://ffmpeg.arrozcru.org/autobuilds/|ffmpeg]].
+Extract it to a place of your choice and add the path of //bin// subdirectory to your PATH environment variable as described above.
+<code>
+set PATH=<ffmpeg install dir>\bin;%PATH%
 </code>
+To use the tools, change into netmd subdirectory of your linux-minidisc folder and run the scripts by their name (just type
+"dump_md.py", "upload.py", ...) with parameters if required. See [[netmdpython#how_to_use_the_tools]] below.
+==== Getting the code ====
+To get the code, clone it with //git// as shown on the [[start#source_code|homepage]].
 The Python libnetmd can be found in the //netmd// subdirectory:
@@ Line 196: / Line 221: @@
 ==== downloadhack.py - download tracks to NetMD (buggy) ====
-Use this script download tracks to your NetMD Walkman. **Note: This requires the NetMD root key from Sony which is not (yet) part of the official repository due to legal reasons.**
+Use this script download tracks to your NetMD Walkman. <del>**Note: This requires the NetMD root key from Sony which is not (yet) part of the official repository due to legal reasons.**</del>
-==== mdctl.py ====
+==== mdctl.py - test libnetmd functionality (DEBUG use only) ====
-This is in a more-then-primitive state. It is supposed to export all functions of libnetmd.py for easy command-line use. Currently, it's a brain-dead wrapper around a pdb shell. Use only if you know python.
+This is in a more-than-primitive state. It is supposed to export all functions of libnetmd.py for easy command-line use. Currently, it's a brain-dead wrapper around a pdb shell. Use only if you know Python.
 ==== lsusb.py - list USB devices connected to the PC ====
@@ Line 208: / Line 233: @@
 **Important notes regarding all tools:**
-  * The tools use a python binding for libusb 1.0. There is no libusb 1.0 for Windows yet, so no chance of using them on Windows.
   * Write access to usb device required (even for listing, as it requires sending usb commands). One way to obtain the rights on modern Linux distributions that use PolicyKit ist to add the portable_audio_player capability to the Net MD device using the provided fdi file (look in netmd/etc of the linux-minidisc tree). Another way is to run them with root permissions (not recommended) or make sure the device raw USB device (the file /dev/bus/usb/<bus>/<device>) gets read/write access by the user you want to use the tools with.