Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
guides:webminidisc [2022/08/25 10:12] – specialkguides:webminidisc [2023/04/14 20:03] (current) – hien34
Line 1: Line 1:
-====== Web MiniDisc (Pro) guide ======+====== Web MiniDisc Pro guide ======
  
-Web MiniDisc (MDW or WMDpro) is a web app that can copy (almost) any audio file onto a Sony MiniDisc. It can also manage tracks and erase discs, making it a complete modern replacement for Sony's SonicStage, except for Hi-MD. All you need is a [[:equipment:sorting:netmd|NetMD recorder]] and a web browser based on Chromium (Google Chrome, Microsoft Edge, Brave).+<WRAP right box 240px> 
 +{{:guides:wmdpro27.png?nolink|}} 
 +</WRAP>
  
-The newest version, Web MiniDisc Pro, has many more features and bug fixes, which will be covered later in the guide. This page aims to be a comprehensive documentation of the application, using Web MiniDisc Pro for all examples.+//Referencing version: Web MiniDisc Pro 1.3.2// 
 + 
 +Web MiniDisc Pro (WMDpro) is a web app that can copy (almost) any audio file onto a Sony MiniDisc using the NetMD USB protocol. It can also manage tracks, erase discs, and enable new features that extend the MD format. It is a complete replacement for Sony's SonicStage (except Hi-MD modes.) 
 + 
 +This guide uses a [[equipment:sony:portable:mz-n920|Sony MZ-N920]] Type-S portable with Web MiniDisc Pro on Windows 10 and Microsoft Edge. There are few differences between platforms; we will note them where they exist.
  
 ===== Development and technical background ===== ===== Development and technical background =====
  
-Web MiniDisc (Pro) is built using [[https://github.com/cybercase/netmd-js|netmd-js]] (a port of the earlier linux-minidisc project to TypeScript), [[https://github.com/facebook/react/|React]], and [[https://developer.mozilla.org/en-US/docs/Web/API/WebUSB_API|WebUSB]].+Web MiniDisc (Pro) is built using [[https://github.com/cybercase/netmd-js|netmd-js]] (a port of the earlier //linux-minidisc// project to TypeScript), [[https://github.com/facebook/react/|React]], and [[https://developer.mozilla.org/en-US/docs/Web/API/WebUSB_API|WebUSB]].
  
-Cybercase (Stefano Brilli) developed the original version, while the Web MiniDisc Pro fork is developed by asivery. The MiniDisc Wiki hosts Web MiniDisc Pro [[software:hosting-wmdpro|using Azure Blob Storage and GitHub Actions]].+Cybercase (Stefano Brilli) developed the original version. The current Web MiniDisc Pro fork is developed by asivery. The MiniDisc Wiki hosts Web MiniDisc Pro [[software:hosting-wmdpro|using Azure Blob Storage and GitHub Actions]].
  
-Newer, undocumented features +Newer, undocumented features are provided using the netmd-exploits library. 
  
   * [[https://github.com/asivery/webminidisc|Web MiniDisc Pro on GitHub]]   * [[https://github.com/asivery/webminidisc|Web MiniDisc Pro on GitHub]]
Line 20: Line 26:
 ===== Requirements ===== ===== Requirements =====
  
-  * NetMD-capable recorder+  * [[equipment:sorting:netmd|NetMD recorder]]
   * USB cable (most use USB Mini-B)   * USB cable (most use USB Mini-B)
-  * Chromium-based web browser (Google Chrome, Microsoft Edge, Brave, etc.)+  * Chromium web browser (Google Chrome, Microsoft Edge, Brave, etc.) 
 + 
 +=== A note about Hi-MD devices === 
 +  * **Hi-MD** devices can operate in either Hi-MD mode or (normal) MD mode, but only MD mode works properly with Web MiniDisc at present. If you're using a Hi-MD device and having difficulty with installing the driver or Web MiniDisc not finding a compatible device, make sure that an MD-formatted media is inserted prior to connecting the device to your computer. Hi-MD (1GB) discs //CANNOT// currently be used. 
 +  * To format a standard MiniDisc in MD mode, try the following steps: 
 +      - Your Hi-MD device should be disconnected from the computer and plugged into a power source sufficient for writing (e.g. the AC adapter). 
 +      - Set the Disc Mode setting in the menu on your device to MD. This enables standard MiniDiscs to default into MD mode when recording or formatting. (Please refer to the manual for your device for specific instructions.) 
 +      - Reformat your target MiniDisc via the menu on the device. This should format the MiniDisc in MD mode, and the device should indicate it's in MD mode on its display. 
 +      - With the MD mode MiniDisc still inserted, you can go ahead and reconnect the device to your computer and continue setting things up!
  
-If you are using Android, ChromeOS, or macOS, the following two segments do not apply to you.+==== Windows ====
  
-==== (Windows only) Installing Zadig ====+Windows requires a driver to be installed before using Web MiniDisc Pro, Platinum-MD, or NetMD Wizard. The driver installation requires Administrator privileges.
  
-On Windows (**only**) you will need to install the Zadig libusb drivers before using either Web MiniDisc or Platinum-MD.+=== Installing Zadig ===
  
-Zadig has the same developer as the Rufus USB disk writing software, and is safe to install.+Zadig is a Windows application that installs generic USB drivers. Web MiniDisc Pro needs generic //libusb// drivers to connect to the recorder.
  
-Please note that if you use SonicStage on the same PC, you will need to uninstall Zadig to connect your NetMD device to SonicStage(and vice-versa.)+These generic drivers cannot co-exist with Sony's official drivers. You must remove these before using Zadig, and remove the libusb drivers before installing Sony drivers for SonicStage.
  
 [[https://zadig.akeo.ie/|Install Zadig from here]], or use the [[https://chocolatey.org/|Chocolatey package manager]] ("cinst -y zadig"). Because it installs a device driver, you must run Zadig as an Administrator. [[https://zadig.akeo.ie/|Install Zadig from here]], or use the [[https://chocolatey.org/|Chocolatey package manager]] ("cinst -y zadig"). Because it installs a device driver, you must run Zadig as an Administrator.
  
-Once installed, connect the NetMD device, then launch the Zadig application. "Net MD Walkman" (or similar) should be automatically selected in the drop down box. If it isn't shown, select "Options" and then "List all devices"+Connect the NetMD device, then launch the Zadig application. "Net MD Walkman" (or similar) should be automatically selected in the drop down box. If it isn't shown, select "Options" and then "List all devices"
  
 The "Driver" field will show that the WinUSB driver will be installed. The "Driver" field will show that the WinUSB driver will be installed.
  
-With your device selected, click "Install Driver"+Click "Install Driver". A dialog box will appear noting that driver installation may take up to 5 minutes.
  
 {{:guides:zadig01.png?nolink|}} {{:guides:zadig01.png?nolink|}}
  
-You may need to run Zadig again when using a different device.+Once complete, you can close Zadig. You must repeat this process when using a //different// device (based on the USB device ID.)
  
-==== (Linux only) udev rules / device permissions ====+==== Linux ====
  
-Regular user accounts do not have the necessary permissions to use MD USB devices on Linux by default and will result in devices not showing up in the chooser or an access denied message. You can use the following steps on most Linux distros to make an exception for your MD device.+=== Packaged browsers ===
  
-**Important note:** prepackaged versions of Chrome or Chromium (such as Snap or Flatpak) will likely not work with Web MiniDisc at all. You should use a version of Chrome compiled for your distribution.+Packaged versions of Chrome or Chromium (such as Snap or Flatpak) will likely not work with Web MiniDisc Pro at all. Use a version of Chromium from your distribution's repositories. 
 + 
 +=== udev rules / device permissions === 
 + 
 +Regular user accounts do not have the necessary permissions to use MD USB devices on Linux by default and will result in devices not showing up in the chooser or an access denied message. You can use the following steps on most Linux distros to make an exception for your MD device.
  
 1. Run the following command to find your MD device. 1. Run the following command to find your MD device.
Line 79: Line 97:
 </code> </code>
  
-===== Using Web MiniDisc (Pro) =====+==== Mac ====
  
-Insert the MiniDisc you want to record on into the NetMD recorder.+Some Mac models (such as the M1 Mac Mini) have reported issues when devices are connected via the USB A ports. A USB-C to USB-A adapter may work better.
  
-Navigate to [[https://web.minidisc.wiki/|Web MiniDisc Pro]].+The Safari web browser is not currently supported. Use Chrome or Edge instead.
  
-If it is your first time using the app, or if there has been an update, you will see a changelog window. Quickly check if anything seems relevant to you, then dismiss the box. 
  
-Connect the NetMD recorder to the computer. Connect your AC adapter to the recorder if you have one; recording can quickly drain the internal battery.+==== WSL2 on Windows ====
  
-Click "Connect". A popup will appear in the top-left corner of the browser and your NetMD recorder should show in the list in the popup. (If it doesn't, check your cables and try a different one.) Choose your NetMD recorder. +For those that need or prefer to live in Windows without installing Zadig's utility, WSL2 is a solution that can work with some extra steps. It can certainly be automated/scripted better if used often. 
  
-{{:guides:WebMDconnection.png?nolink|}}+Commands referred to are entered either in a Windows Adminstrator PowerShell window or Ubuntu/WSL2 terminal as directed.
  
-Once you do so, the popup will disappear. On the web page you'll see the model number of your NetMD player and the list of tracks on the disc you inserted.+1. Install WSL2 under Windows 10/11. 
 +Open a PowerShell prompt under Windows 11 by right-clicking on the Start button and choosing Windows Terminal (Admin). Accept the warning and you'll see the PowerShell window pop up with "Administrator" in the top left.
  
-{{:guides:webmd03.png?nolink|}}+Next, install WSL by typing the following in the PowerShell window: 
 +<code> 
 +wsl --install 
 +</code> 
 +Just wait a few minutes and after it's complete, reboot when you're ready. 
 + 
 + 
 +2. Set up your instance of Ubuntu/WSL2. 
 +After a reboot, you'll see terminal window that asks you to set a username and password. These are for the instance of Ubuntu running in the WSL, so they don't need to correlate to your Windows login. 
 +Update the packages 
 +<code> 
 +sudo apt update 
 +</code> 
 + 
 + 
 +3. Install USB support for WSL2 - this is required for USB devices to be seen within your Ubuntu instance. 
 + 
 +In Windows: Download the .msi from [[https://github.com/dorssel/usbipd-win/releases |here]] and install it. 
 +In Ubuntu/WSL2: 
 +<code> 
 +sudo apt install linux-tools-generic hwdata 
 +sudo update-alternatives --install /usr/local/bin/usbip usbip /usr/lib/linux-tools/*-generic/usbip 20 
 +</code> 
 + 
 + 
 +4. Verify your device can be seen in Windows and link it to Ubuntu/WSL2. 
 +In Windows: 
 +<code> 
 +usbipd wsl list 
 +</code> 
 + 
 +Note the BUSID (in this case, it's 2-2) 
 +<code> 
 +PS C:\Users\YourUserID> usbipd wsl list 
 +BUSID  VID:PID    DEVICE                                                        STATE 
 +1-3    8087:0029  Intel(R) Wireless Bluetooth(R)                                Not attached 
 +1-4    0c45:672c  Integrated Webcam                                             Not attached 
 +2-1    046d:c332  USB Input Device                                              Not attached 
 +2-2    054c:00c9  Net MD Walkman                                                Not attached 
 +</code> 
 + 
 +Attach it in Windows (replace the busid parameter with yours, in the example above it is 2-2): 
 +<code> 
 +usbipd wsl attach --busid <busid> 
 +</code> 
 + 
 +Now see if it's attached in Ubuntu/WSL. 
 +<code> 
 +user@PCname:~$ lsusb 
 +Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub 
 +Bus 001 Device 002: ID 054c:00c9 Sony Corp. Net MD 
 +Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub 
 +</code> 
 + 
 + 
 +5. Since it's WSL2, we need to run udev so we can manage the device (important for the next step). 
 +<code> 
 +sudo /lib/systemd/systemd-udevd --daemon 
 +</code> 
 + 
 + 
 +6. Follow the Linux instructions listed [[guides:webminidisc|above]]. Note your ID output from "lsusb" (in this case, 054c:00c9) 
 + 
 +7. Install a chromium-based browser of your choice (I used Google Chrome) and then navigate to [[https://web.minidisc.wiki/|Web Minidisc Pro]]. 
 + 
 +8. Push Connect and select your device! 
 + 
 +Additional efficiencies and automations may be listed later.  
 + 
 +After a reboot, reload you will have to repeat the "attach" (step 4) and udev (step 5) steps above and finally,  
 +<code> 
 +sudo udevadm trigger 
 +</code> 
 + 
 + 
 +===== Launching Web MiniDisc Pro ===== 
 + 
 +Insert a MiniDisc into the NetMD recorder and connect it to the computer. 
 + 
 +Navigate to [[https://web.minidisc.wiki/|Web MiniDisc Pro]]. 
 + 
 +On first visit, or if there has been an update, you will see a changelog window. Quickly check if anything seems relevant to you, then dismiss the box. If the version appears out of date or if you have not used the app in some time, do a cache reload by pressing //Ctrl+Shift+R// - the hotkey may differ between platforms and operating systems. 
 + 
 +Click "Connect". A popup with "Net MD Walkman" or "Net MD" will appear in the top-left or top-right corner of the browser. If it doesn't, check your cables and try a different one. Select this and click "Connect" 
 + 
 +{{:guides:wmdpro01.png?nolink|}} 
 + 
 +The popup will disappear. The page will show the model name of the NetMD recorder, recording time left (hover over "SP mode" to see record times for LP2 and LP4 formats) and the list of tracks on the disc (including recording mode on the right.)  
 + 
 +{{:guides:wmdpro02.png?nolink|}}
  
 ===== Managing tracks ===== ===== Managing tracks =====
  
-By clicking on any track, you select it. The section of the app showing the disc title will be replaced with options. Once you have selected one track, you can select other tracks by clicking them as well.+Click on a track to select it. The disc title will be replaced with options. After selecting one track, you can select more tracks by clicking them.
  
-From left to right, these options are: +{{:guides:wmdpro03.png?nolink|}} 
-  * selection - a dash means some tracks are selected; a tick means all tracks are selected + 
-  * record - use the output of your MD recorder to playback to the input of your computer, allowing real-time recording +Left to right, these options are: 
-  * delete - remove the track from the disc, allowing the time to be used again +  * selection - dash = some tracks are selected; tick = all tracks selected 
-  * group - place sequential tracks in a group (disabled when non-sequential tracks selected)+  * record - real-time recording to PC using the line output (see below) 
 +  * delete - remove the track from the disc 
 +  * group - place sequential tracks in a group (see below) (disabled when non-sequential tracks selected)
   * rename - change the title of a track (disabled when multiple tracks selected)   * rename - change the title of a track (disabled when multiple tracks selected)
  
-The 6 dot "grip" on the left of each track lets you drag tracks up and down in the ToC. +Use the 6 dot "grip" on the left of each track to move them up and down the ToC. 
 + 
 +If many options are disabled, the disc may be write-protected. Check the write-protect tab on the disc (open = writable; closed = protected)
  
 ==== Groups ==== ==== Groups ====
  
-Web MiniDisc Pro supports the MiniDisc's //Group// feature. Even devices that do not support groups will still play grouped recordings with no issue.+Web MiniDisc Pro supports the MiniDisc's //Group// feature. Groups are supported by most MiniDisc players, but will still play on older ones.
  
-Groups **do not** work like playlists. For songs to be grouped together, they must be consecutive tracks. Multiple groups are supported. A few examples of how groups are often used is for separate albums (one group for each) or chapters for audiobooks (one group for each chapter.)+Groups **do not** work like playlists. Grouped tracks must be consecutive. Multiple groups are supported, but not nested groups. Groups are often used for separate albums (one group for each) or chapters for audiobooks (one group for each chapter.)
  
-Select the tracks you wish to include in your group. Then select the Group button in Web MiniDisc:+Select the tracks you wish to include in your group. Then select the Group button:
  
-{{:guides:mdgroup.png?nolink|}}+{{:guides:wmdpro04.png?nolink|}}
  
-To remove a group, click on the trash can icon. The group will be removed but the tracks will remain.+To remove a group, click the trash can icon. The group will be removed but the tracks will remain.
  
-You cannot create nested groups, and TOC changes such as grouping does not occur until you press "Stop" and/or disconnect the USB cable.+TOC changes such as groups do not save until you press "Stop" and/or disconnect the USB cable.
  
 ==== Full-width characters ==== ==== Full-width characters ====
  
-Web MiniDisc Pro supports full-width characters, especially Japanese kanji. MiniDisc uses [[https://en.wikipedia.org/wiki/Shift_JIS|Shift JIS]] encoding for titles. +Web MiniDisc Pro supports full-width characters, especially Japanese kanji. To enable full-width support in Web MiniDisc Pro, use the Overflow menu and toggle the "Enable full-width title editing" option.
  
-You must first enable full-width characters using an option in the overflow menu.+{{:guides:wmdpro05.png?nolink|}}
  
-MiniDisc records full-width entries to a separate entry that is only shown on a Kanji-capable device (such as a remote) - otherwise the half-width field is shown. Half-width titles are still shown on low resolution screens (i.e. - the on device screen of the [[equipment:sony:portable:mz-n920|MZ-N920]]) even if the device itself supports full-width remotes.+All title editing popups will show two fields:  
 +  * half-width characters such as the Latin alphabet and some kana 
 +  * full-width characters such as kanji and other kana
  
-To enable full-width support in Web MiniDisc Pro, use the Overflow menu and toggle the "Enable full-width title editing" option. +{{:guides:wmdpro06.png?nolink|}}
  
-Once you do, all title editing popups will show two fields:  +Full-width entries use a separate entry that is only shown on a Kanji-capable device (such as a remote) - otherwise the half-width field is shown. MiniDisc uses [[https://en.wikipedia.org/wiki/Shift_JIS|Shift JIS]] encoding for titles. 
-  * one for half-width characters such as the Latin alphabet and some kana +
-  * one for full-width characters such as kanji and other kana+
  
-{{:guides:fwe.png?nolink|}} +Half-width titles are still shown on low resolution screens (i.e. the on device screen of the [[equipment:sony:portable:mz-n920|MZ-N920]]) even if the device itself supports full-width remotes.
- +
-{{:guides:bothfields.png?nolink|}}+
  
 [[https://github.com/cybercase/webminidisc/pull/49#issuecomment-882046059|More information on GitHub]] [[https://github.com/cybercase/webminidisc/pull/49#issuecomment-882046059|More information on GitHub]]
  
-==== Playing tracks ====+==== Recording or downloading tracks ====
  
-The "record" feature is the best way to record your MD tracks (except Factory Mode, explained below), but if you want to sample a track while connected to a PC, use the playback buttons at the bottom of the screen.+Web MiniDisc Pro has two ways to copy tracks on a MD back to the PC: recording and downloading.
  
-These buttons control the playback on compatible devices, and are hidden on incompatible ones. The playback still comes through the device's own 3.5mm jack.+=== Record ===
  
-===== Overflow menu =====+"Recording" plays the track via the 3.5mm output, which you connect to the Mic or Line In on your computer. The device will play the track(s) into your PC, which you record using audio software such as Audacity. [[guides:md-to-pc|See our MD to PC guide.]]
  
-In the top-right of the app is the overflow (elipsis) menu. This shows many more features and settings.+{{:guides:wmdpro11.png?nolink|}}
  
-  * Reload TOC - refresh the list of tracks on the MiniDisc from the Table of Contents on the disc +=== Download ===
-  * Enter Factory Mode - an advanced mode we'll cover later +
-  * Rename Disc - assign a title to your disc +
-  * Wipe Disc - erase the disc, even if it has "checked-out" music files on it +
-  * Exit - disconnect your device from Web MiniDisc+
  
-  * Enable full-width title editing - Japanese kanji characters, details above +//This requires [[guides:exploits|a Supported NetMD Device]].//
-  * Factory mode ripping in main UI - use the experimental ATRAC ripping feature on some portables, details below +
-  * Dark mode - light and dark mode toggle +
-  * Retro mode - a Windows 95 themed interface, does not support all features+
  
-  * About - information about the app +"Downloading" uses reverse-engineered features in //netmd-exploits// to copy the ATRAC files from the MD as downloadable files. Not all equipment supports this. To enable downloading, choose "Enable Homebrew mode ripping in main UI" from the Overflow Menu. 
-  * Changelog - recent changes, shows on first visit +
-  * Support and FAQ - a link to cybercase's readme page +
-  * GitHub - a link to asivery's GitHub+
  
-===== Recording audio =====+Once this is enabled, the "record" option in the app will be replaced with "download" - which will read the selected tracks and download ATRAC or ATRAC3 files via the browser. Also see [[guides:convert-atrac|]] if needed. 
 + 
 +This feature is experimental and may have errors or issues. Please contact the development team to report bugs. 
 + 
 +If you select multiple tracks, all will be played for recording or downloaded. Most browsers will show a warning before downloading multiple files. 
 + 
 +{{:guides:wmdpro14.png?nolink|}} 
 + 
 +==== Playing tracks ==== 
 + 
 +To sample a track while connected to a PC, use the playback buttons at the bottom of the screen. 
 + 
 +<WRAP right box 240px> 
 +{{:guides:wmdpro10.png?nolink|}} 
 +</WRAP> 
 + 
 +These buttons control the playback on compatible devices, and are hidden on incompatible ones. The playback comes through the device's own 3.5mm or RCA jack. 
 + 
 +===== Copying audio =====
  
 Drag MP3, FLAC, WAV, or most other audio files to the web browser window to record them on the MiniDisc.  Drag MP3, FLAC, WAV, or most other audio files to the web browser window to record them on the MiniDisc. 
  
 You can also click the "+" in the bottom right corner (next to the playback controls) to bring up a file selection box. You can also click the "+" in the bottom right corner (next to the playback controls) to bring up a file selection box.
 +
 +{{:guides:wmdpro09.png?nolink|}}
  
 ==== Upload settings ==== ==== Upload settings ====
 +
 +<WRAP right box 320px>
 +{{:guides:wmdpro08.png?nolink|}}
 +</WRAP>
  
 When you do, a window labelled "Upload Settings" will popup. From here, you can select: When you do, a window labelled "Upload Settings" will popup. From here, you can select:
  
-  * Which recording mode to use (SP is recommended, more below)+  * Recording mode (SP, LP2, LP4)
   * The track title on the MD (you can change this later)   * The track title on the MD (you can change this later)
-  * To hide or show tracks. Click show tracks:+    * all options except "filename" use track tags such as ID3 
 +  * Total and remaining time 
 +    * Total shows the time the track(s) will use on the disc, in SP time. Hover to show LP2 and LP4 times 
 +    * Remaining shows how much time will be left on the disc after recording. Hover to show LP2 and LP4 times 
 +  * Advanced options 
 +    * Full width title support - see the section above for more info 
 +    * [[https://en.wikipedia.org/wiki/ReplayGain|ReplayGain]] - volume normalization stored inside file metadata 
 +    * Normalize tracks - manual volume normalization 
 +  * Hide or show tracks. Click show tracks:
     * This shows the files to copy, with an options section similar to managing tracks (from left to right):     * This shows the files to copy, with an options section similar to managing tracks (from left to right):
       * plus - add another track to the queue, brings up a file upload dialog box       * plus - add another track to the queue, brings up a file upload dialog box
Line 194: Line 325:
 ==== Recording mode ==== ==== Recording mode ====
  
-There are three common modes for recording to MD:+There are three MD recording modes:
   * SP - the MD standard, works on all equipment with the highest quality   * SP - the MD standard, works on all equipment with the highest quality
   * LP2 - double the recording time listed on the disc, only works on equipment after ~2001   * LP2 - double the recording time listed on the disc, only works on equipment after ~2001
   * LP4 - quad recording time at a much-reduced quality   * LP4 - quad recording time at a much-reduced quality
  
-SP is recommended for most cases. It is the most compatible and has the best quality. +SP is recommended for most cases. It is the most compatible and has the best quality. If you only have newer equipment, LP modes also provide acceptable quality for music at LP2 and podcasts at LP4. 
  
-If you only have newer equipment, LP modes also provide acceptable quality for music at LP2 and podcasts at LP4. +As a free / open source project, Web MiniDisc Pro cannot use Sony's SonicStage LP encoder by default and must instead use the free [[https://github.com/dcherednik/atracdenc|atracdenc encoder]]. This encoder does not perform as well as the Sony encoder yet.
  
-Because Web MiniDisc Pro is a free / open source project, it cannot use Sony's SonicStage LP encoder and must instead use the free [[https://github.com/dcherednik/atracdenc|atracdenc encoder]]. This encoder does not perform as well as the Sony encoder yet, so LP tracks recorded using Web MiniDisc will have worse sound quality compared to discs recorded using SonicStage.+=== Remote ATRAC ===
  
-SP mode is not affected by the above issue as the ATRAC encoding is performed by the recorder instead of the app. This also means SP mode records much slower than LP modes. See our [[:guides:speedtest|Speed Test page for examples]].+As of version 1.3.0, Web MiniDisc Pro supports an external ATRAC3 (LP) encoder. External servers can run encoders such as Sony's SonicStage or PSP encoder for ATRAC3 LP, which will then send a higher-quality file for Web MiniDisc Pro to send to your device.
  
-Interestingly, SonicStage used an LP mode "wrapper" to send SP tracks to disc. Web MiniDisc (and other new tools) send raw audio to the recorder to be encoded directly to SP mode. As a result: +To use an external encoder, use the overflow menu //before// you connect your equipment to WMDpro:
-  * SP mode tracks sound better when recorded with Web MiniDisc +
-  * LP mode tracks sound better when recorded with SonicStage+
  
-==== Recording ====+{{:guides:wmdpro12.png?nolink|}}
  
-Click OK. "Upload Settings" will disappear and a new box will show the progress of the copy. The top bar shows the conversion, which happens on the computer. The lower bar shows the copy to MD.+An ATRAC3 encode server provided by the MiniDisc Wiki is entered by default. Depending on bandwidth constraints, this server may not be available. If it is not, [[https://github.com/thinkbrown/atrac-api|any server that supports atrac-api]] may be used (with HTTPS.)
  
-Recording takes some time, but it does occur faster than audio to audio or optical to audio dubbing. Our Speed Test page has examples of how long you should expect. Do not move or bump the recorder while you're copying tracks, or while you hear the mechanism moving.+{{:guides:wmdpro13.png?nolink|}} 
 + 
 +=== SP mode === 
 + 
 +SP mode does not need any encoder as the ATRAC processing is performed by the recorder. This also means SP mode records much slower than LP modes. See our [[:guides:netmd-speed-test|Speed Test page for examples]]. 
 + 
 +=== Compared to SonicStage === 
 + 
 +Interestingly, SonicStage converts all audio to LP2 first before transferring it to a device, even when recording in SP. This means that when recording in SP, the original audio is converted to LP2, then to PCM, which is then sent to the device, and finally encoded by the device in ATRAC1 (SP). As a result, SP mode tracks sound better when recorded with Web MiniDisc, as it doesn't do any redundant encoding. LP mode tracks will sound as good (or better) if using remote ATRAC encoding, but worse if using the default atracdenc. 
 + 
 +=== Diagram === 
 + 
 +{{:guides:md-encoding-hq_1_.png?direct&600|}} 
 + 
 +//Courtesy of developer [[https://www.github.com/Sir68k|Sir68k]]// 
 +==== Copying to disc ==== 
 + 
 +Click OK. A new dialog box will show the progress of the copy. The top bar shows the conversion, which happens on the computer. The lower bar shows the copy to MD. 
 + 
 +{{:guides:wmdpro15.png?nolink|}} 
 + 
 +Recording takes some time, but is faster than audio to audio or optical to audio dubbing. The Speed Test page (linked above) has examples of how long you should expect. Do not move or bump the recorder while you're copying tracks, or while you hear the mechanism moving. Homebrew mode (see below) can increase the copying speed.
  
 ==== Finishing up ==== ==== Finishing up ====
Line 221: Line 371:
 The "Notify when done" option will use the browser's notification service to notify you when an upload is complete. The "Notify when done" option will use the browser's notification service to notify you when an upload is complete.
  
-When you're done recording or playing the MiniDisc you've inserted, you can choose "Exit" from the dropdown menu in the window.+When done, choose "Exit" from the overflow menu. Press the "Stop" button on the recorder, check if the display is flashing a message ("TOC edit" or "PC->MD") and wait until it stops flashing. Some recorders may even lock the eject switch until you press "Stop" and the ToC writes. Disconnect the NetMD player, and enjoy! 
  
-Press the "stop" button on the recorder, check if the display is flashing a message ("TOC edit" or "PC->MD") and wait until it stops flashing. Some recorders may even lock the eject switch until you press "stop" and the ToC writes. Disconnect the NetMD player, and enjoy! +===== Overflow menu =====
  
-==== Downloading tracks ====+In the top-right of the app is the overflow (ellipsis) menu. This shows many more features and settings.
  
-On Type-S portables, an exploit allows you to download ATRAC data directly from a device for easy preservation or backup. To enable this, choose the "Factory mode ripping in main UI" option from the overflow window. +<WRAP right box 360px> 
 +{{:guides:wmdpro07.png?nolink|}} 
 +</WRAP>
  
-Once this is enabled, the "record" option in the app will be replaced with "download" - which will read the selected tracks and download ATRAC or ATRAC3 files via the browser.+  * Reload TOC - refresh the list of tracks from the Table of Contents on the disc 
 +  * Enter Homebrew Mode - advanced features and options (more below) 
 +  * Rename Disc - change the disc title 
 +  * Wipe Disc - erase the disc (even if it has "checked-out" audio from SonicStage) 
 +  * Song Recognition - identify tracks using Shazam (requires a userscript or ElectronWMD, more below) 
 +  * Import titles from CSV - use a CSV file to title tracks 
 +  * Export titles to CSV - create a CSV list of titles to import 
 +  * Exit - disconnect from Web MiniDisc
  
-This feature is experimental and may have errors or issues. Please contact the development team to report bugs.+  * Enable full-width title editing - Japanese kanji characters (more above) 
 +  * Homebrew mode ripping in main UI - download audio files from portables (more above) 
 +  * Dark mode - light and dark mode toggle 
 +  * Retro mode - a Windows 95 interface (does not support all features) 
 + 
 +  * About - information about the app 
 +  * Changelog - recent changes, shows on first visit 
 +  * Support and FAQ - cybercase's readme page 
 +  * GitHub - asivery's GitHub 
 + 
 +===== Song recognition ==== 
 + 
 +As of version 1.3.0, Web MiniDisc Pro has Shazam integration to identify and title tracks using audio fingerprints. 
 + 
 +Select "Song Recognition" from the overflow menu. A dialog box will popup. 
 + 
 +{{:guides:wmdpro22.png?nolink|}} 
 + 
 +See the //Recording or downloading tracks// section above for detail about **line-in** versus **exploits** mode. 
 + 
 +Song recognition requires either a userscript or the ElectronWMD app, due to CORS website security. 
 + 
 +==== Installing the userscript ==== 
 + 
 +Clicking "userscript" from the dialog box will not work without the [[https://www.tampermonkey.net/|Tampermonkey]] browser extension, available in the Chrome and Edge add-on stores. The built-in Chrome userscript engine will **not** work. 
 + 
 +With Tampermonkey installed, click the "userscript" link. A new window will open with detail about the script. Click "install". 
 + 
 +{{:guides:wmdpro23.png?nolink|}} 
 + 
 +Refresh the page and reconnect the MD recorder. 
 + 
 +==== Recognizing tracks ==== 
 + 
 +Select the tracks to be recognized by Shazam. Choose the tite format with the drop-down box in the top right. 
 + 
 +{{:guides:wmdpro24.png?nolink|}} 
 + 
 +Click "recognize" in the bottom right. Web MiniDisc Pro will fetch new track information from Shazam using a snippet of the audio (either from line-in or from homebrew download mode): 
 + 
 +{{:guides:wmdpro25.png?nolink|}} 
 + 
 +Click "Apply new titles" to write the title from the right column to the MiniDisc. 
 + 
 +{{:guides:wmdpro26.png?nolink|}}
  
 ===== Troubleshooting ===== ===== Troubleshooting =====
  
-Although the developers work very hard to fix bugs and give helpful error messages, sometimes problems do occur.+Web MiniDisc Pro has been heavily tested, especially on the most common devices. Some issues or errors may still occur.
  
-These are some of the most common issues reported:+==== Browser JavaScript console ==== 
 + 
 +When reporting an issue or bug, you may be asked to show the browser console. The console shows information, errors, and progress that is useful for finding issues. 
 + 
 +To open the JS console, press Ctrl-Shift-i to open the developer console, then choose "Console".
  
 ==== Stall or pause while copying ==== ==== Stall or pause while copying ====
  
-This is usually a battery issue. Writing to a MD is battery-intensive, so it is recommended to use an AC adapter while writing. If not available, use a fresh battery.+This is usually a battery issue. Writing to a MD is battery-intensive, so it is recommended to use an AC adapter or fresh battery when writing.
  
-1.2V rechargable batteries may have a shorter life than 1.5V disposable batteries.+1.2V NiMH rechargable batteries may have a shorter life than 1.5V alkaline or lithium disposable batteries.
  
-==== "The disc's title seems to be corrupted" ====+==== "Oops, something unexpected happened" ====
  
-This means that there is an issue reading the ToC on the disc. It is a fairly generic error and can mean a number of things have gone wrong with Web MiniDisc's handling of the disc.+This is a fairly generic error and can mean a number of things have gone wrong with Web MiniDisc's handling of the disc.
  
-It is best that you join the Wiki's [[:about:contact|Discord server]] and speak with developers in the respective channels.+Check the power delivery (see above) and try another disc. If it continues, please report the issue to the developers.
  
-==== Opening the browser JavaScript logs ====+==== "The disc's title seems to be corrupted" ====
  
-Providing information to developers is very helpful when troubleshooting Web MiniDisc Pro. Make sure you are using the newer Pro version as it has fixed several bugs that affect the original.+Similar to above, this means that there is an issue reading the ToC on the disc.
  
-To open the JS console, press ctrl-shift-i to open the developer console, then choose "Console"+Check the power delivery (see above) and try another disc. If it continues, please report the issue to the developers.
  
 ==== Tracks missing once disc is removed ==== ==== Tracks missing once disc is removed ====
  
-If the tracks you record are missing after reloading the disc's ToC or removing the disc, the two most common causes are:+If tracks recorded or ToC changes are missing after reloading or removing the disc, the two most common causes are:
   * ToC not being written   * ToC not being written
   * Write head issue   * Write head issue
  
-The ToC may not be written correctly if the battery is low or if the device was disconnected while writing the ToC ("PC->MD" or "ToC edit" flashing on screen). In this case, try again with a fresh battery and a different disc to see if the issue repeats. If it does, see below.+The ToC may not be written correctly if the battery is low or if the device was disconnected while writing the ToC ("PC->MD" or "ToC edit" flashing on screen). In this case, try again with a fresh battery and a different disc. If the issue repeat, see below.
  
-A disc may appear to be written in the recorder's memory but not actually write to disc. This means that there is an issue with the write head on the recorder. Try recording using the built in audio input (if not a download-only model) to see if all recording has this issue.+A disc may appear to be written in the recorder's memory but not write to disc. This means that there is an issue with the write head on the recorder. Try recording using the built in audio input (if not a download-only model) to see if all recording has this issue.
  
 If it is a write head issue, check our [[:guides:start|guides section]] to see if there is a repair guide. If it is a write head issue, check our [[:guides:start|guides section]] to see if there is a repair guide.
  
-===== Factory mode ====+==== Cannot connect on MacOS / Linux ==== 
 + 
 +Early NetMD equipment such as the [[:equipment:sony:portable:mz-n505|MZ-N505]] or [[:equipment:sony:portable:mz-n707|MZ-N707]] can have issues connecting to computers with MacOS or Linux. Windows is not affected. 
 + 
 +This is likely due to a bug in the USB firmware of R1.100 devices. There is no fix known. 
 + 
 +==== "Unable to claim interface" ==== 
 + 
 +This is a USB error. It likely means that Web MiniDisc Pro cannot take exclusive control of the recorder, due to another application or virtual machine. 
 + 
 +Try closing all other programs or restarting the computer. 
 + 
 +==== "Offset is outside the bounds of the DataView" ====  
 + 
 +Likely deck or bookshelf exclusive, this error has been seen on Sony LAM equipment. 
 + 
 +Some Mac models (such as the M1 Mac Mini) have reported issues when devices are connected via the USB-A ports. A USB-C to USB-A adapter may work better. 
 + 
 +===== Homebrew mode ==== 
 + 
 +//This requires [[guides:exploits|a Supported NetMD Device]].//
  
-Using the overflow menu, you can enable factory mode. This mode is experimental and comes with no warranty. +Using the overflow menu, you can enable //homebrew mode// (formerly factory mode.) This mode is experimental and comes with no warranty. 
  
 Once you click, there is a warning popup. It is important to read and understand it. Once you click, there is a warning popup. It is important to read and understand it.
  
-The factory mode screen has three main sections for manipulating the disc ToC:+You will see the recorder's firmware version (which is important for reporting issues to developers, and decides which homebrew features are available.) 
 + 
 +The homebrew mode screen has three main sections for manipulating the disc ToC: //(under construction)//
  
 ==== Position sector ==== ==== Position sector ====
  
-(someone smarter than me can fill this in)+{{:guides:wmdpro17.png?nolink|}}
  
 ==== Half-width sector ==== ==== Half-width sector ====
  
-(someone smarter than me can fill this in)+{{:guides:wmdpro18.png?nolink|}}
  
 ==== Timestamp sector ====  ==== Timestamp sector ==== 
  
-(someone smarter than me can fill this in)+{{:guides:wmdpro19.png?nolink|}}
  
-==== Factory mode overflow menu ====+==== Homebrew mode overflow menu ====
  
-In factory mode, the overflow (elipsis) menu has different options. These are: +<WRAP right box 280px> 
-  * Reload ToC - same as standard, reloads the disc's Table of Contents +{{:guides:wmdpro16.png?nolink|}} 
-  * Edit other ToC values - brings up a popup with advanced ToC options+</WRAP> 
 + 
 +In homebrew mode, the overflow (ellipsis) menu has different options. These are: 
 +  * Reload ToC - reloads the disc's Table of Contents 
 +  * Edit other ToC values - a popup with advanced ToC options 
 +  * Toolbox - additional features 
 +    * Strip SCMS information - removes the SCMS flag (digital copy) from a disc 
 +    * Archive disc - copies the whole disc at once, including ToC
   * Read RAM - for developers, copies the recorder's RAM to the PC   * Read RAM - for developers, copies the recorder's RAM to the PC
   * Read firmware - for developers, copies the recorder's firmware to the PC   * Read firmware - for developers, copies the recorder's firmware to the PC
   * Download TOC - copy the disc's Table of Contents to a file for backup or manipulation   * Download TOC - copy the disc's Table of Contents to a file for backup or manipulation
   * Upload TOC - replace the disc's ToC with one previously downloaded above   * Upload TOC - replace the disc's ToC with one previously downloaded above
 +  * Enable SP upload speedup - have the recorder copy tracks at faster than 2x speed
   * Tetris - a fun proof-of-concept showing how talented the MD hacking scene is   * Tetris - a fun proof-of-concept showing how talented the MD hacking scene is
  
Line 308: Line 545:
 ==== Browser app ==== ==== Browser app ====
  
-Web MiniDisc Pro can also be installed locally as a web app. This means it can be run without an internet connection or even opening a web browser.+Web MiniDisc Pro can also be installed locally as a web app. This means it can be run without an internet connection or opening a web browser. 
 + 
 +On Windows with Microsoft Edge, click the "3 blocks and plus" icon next to the Favorites "star" icon: 
 + 
 +{{:guides:wmdpro20.png?nolink|}}
  
-To do so in Windows with Microsoft Edge, click the "3 blocks and plus" icon next to the Favorites "star" icon:+Choose "install" - the app is now available in your Start or Apps menu. 
  
-{{:guides:installmd.png?nolink}}+These directions should apply to Linux or MacOS systems as well.
  
-and then choose "install" - the app is now available in your Start or Apps menu. These directions should apply to Linux or MacOS systems as well.+{{:guides:wmdpro21.png?nolink|}}
  
 Web MiniDisc installed as web app on Linux system: Web MiniDisc installed as web app on Linux system:
Line 326: Line 567:
   * [[https://github.com/gavinbenda/platinum-md|Platinum-MD, a similar MD copying app using linux-minidisc]]   * [[https://github.com/gavinbenda/platinum-md|Platinum-MD, a similar MD copying app using linux-minidisc]]
   * [[https://github.com/Jo2003/cd2netmd_gui|NetMD Wizard, a Qt desktop app to copy CDs to MD (and more)]]   * [[https://github.com/Jo2003/cd2netmd_gui|NetMD Wizard, a Qt desktop app to copy CDs to MD (and more)]]
-  * [[https://github.com/thp/linux-minidisc/minidisc-ffwd|Latest fork of linux-minidisc]]+  * [[https://github.com/thp/linux-minidisc|Latest fork of linux-minidisc]]
   * [[https://github.com/fijam/gmdrec|MD recorder for non-NetMD devices using remote emulation]]   * [[https://github.com/fijam/gmdrec|MD recorder for non-NetMD devices using remote emulation]]
  
  
  • guides/webminidisc.1661422325.txt.gz
  • Last modified: 20 months ago
  • by specialk