https://github.com/cybercase/netmd-js

Typescript library to access NetMD MiniDisc devices
https://github.com/cybercase/netmd-js

Last synced: 8 days ago
JSON representation

Typescript library to access NetMD MiniDisc devices

• Host: GitHub
• URL: https://github.com/cybercase/netmd-js
• Owner: cybercase
• License: gpl-2.0
• Created: 2020-03-04T22:41:20.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-09-20T08:51:04.000Z (about 2 months ago)
• Last Synced: 2024-10-28T12:24:22.674Z (16 days ago)
• Language: TypeScript
• Size: 1.25 MB
• Stars: 39
• Watchers: 3
• Forks: 12
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - netmd-js - Typescript library to access NetMD MiniDisc devices (Libraries)

README

        
## JS library to access NetMD MiniDisc devices

This is a port to TypeScript of the [linux-minidisc](https://github.com/glaubitz/linux-minidisc) project.

It works either in node and every browser supporting the [WebUSB](https://wicg.github.io/webusb/) standard.

### How to Install CLI (netmdcli)

```

npm install netmd-js -g

```

### How to build

```

npm install

npm run build

```

### How to upload music

There's a minimal CLI called `netmdcli` that I've written for testing, but the primary purpose of this library is to serve the [Web MiniDisc](https://github.com/cybercase/webminidisc) project.

If you want to upload music to your device using the cli keep in mind that it won't parse your audio file container, but it works only with raw audio data.

[ffmpeg](https://www.ffmpeg.org/) will do the trick of extracting the raw data from your audio files for *SP* uploads. If you want to use *LP2* or *LP4* you'll also need [atracdenc](https://github.com/dcherednik/atracdenc).

##### SP

```

ffmpeg -i youraudiofile -f s16be rawaudiodata.raw  # outputs raw audio data suitable for SP uploads

```

##### LP2

```

ffmpeg -i youraudiofile -ar 44100 youraudiofile.wav # 44100 16bit wav input file suitable for atracdenc

atracdenc -e atrac3 -i youraudiofile.wav -o youraudiofile.oma --bitrate 128

dd bs=96 skip=1 if=youraudiofile.oma of=rawaudiodata.raw # removes OMA file header

```

##### LP4

```

ffmpeg -i youraudiofile -ar 44100 youraudiofile.wav # 44100 16bit wav input file suitable for atracdenc

atracdenc -e atrac3 -i youraudiofile.wav -o youraudiofile.oma --bitrate 64

dd bs=96 skip=1 if=youraudiofile.oma of=rawaudiodata.raw # removes OMA file header

```

Then just run

```

netmdcli upload rawaudiodata.raw -f sp|lp2|lp4

```

### How Contribute

Every contribute is welcome but, please, reach out to me before opening any PR.

### Acknowledgments

This library has been made possible by the amazing work done from the [linux-minidisc](https://github.com/glaubitz/linux-minidisc) project.