vavi-sound

Provides old school Japanese cell phone sounds library as javax.sound(.midi) SPI
includes many ADPCM codecs and the SSRC sampling rate converter.

Status

SPI	Codec	Description	IN Status	OUT Status	SPI Status	Comment
midi	MFi	Japanese ring tone format	🚧	✅	✅	DoCoMo
midi	SMAF	YAMAHA ring tone format	🚧	✅	✅	au, Softbank
sampled	MFi	Japanese ring tone format	✅	✅	✅	DoCoMo
sampled	SMAF	YAMAHA ring tone format	✅	✅	✅	au, Softbank
sampled	CCITT ADPCM	G711, G721, G723	✅	✅	✅	G721 cellphone w/ Fuetrek chip
sampled	DVI ADPCM	DVI ADPCM	✅	✅	✅	same as IMA
sampled	IMA ADPCM	IMA ADPCM	✅	✅	✅ [2]
sampled	MA ADPCM [1]	YAMAHA ADPCM-MA	✅	✅	✅	cellphone w/ YAMAHA MA chip, YMU762, YMU765
sampled	MS ADPCM	Microsoft ADPCM	✅	✅	✅ [2]
sampled	OKI ADPCM	OKI MSM6258 ADPCM	✅	✅	✅ [2]	x68000
sampled	ROHM ADPCM [1]	ROHM ADPCM	✅	✅	✅	cellphone w/ Rohm chip
sampled	VOX ADPCM	Dialogic ADPCM (VOX)	✅	✅	✅ [2]	OKI MSM7580
sampled	YM2068 ADPCM	YAMAHA ADPCM-A	✅	✅	-	YM2608 etc.
sampled	YAMAHA ADPCM	YAMAHA ADPCM-A	✅	✅	✅ [2]	same as YM2608 ADPCM
sampled	PSX ADPCM	SONY ADPCM	✅	-		.mi[bh], .mic
sampled	ssrc	resampling	✅	-	✅ *	[*] need to wait for phase 1

_{[1] implemented in another library
[2] wav file readable}

Install

• https://jitpack.io/#umjammer/vavi-sound

Usage

sample

• MFi (.mld) ... PlayMFi
• SMAF (.mmf) ... PlaySMAF

FAQ

Q. can I use SSRC sampling converter under LGPL license?

A. yes you can, follow those steps

• create a separated jar (ssrc.jar) file including ssrc classes. (never include those .class files into your application jar file)
  • vavi/sound/pcm/resampling/ssrc/SSRC.class
  • vavi/util/SplitRadixFft.class
  • vavi/util/I0Bessel.class
• ⚠️ caution:
  • your application complies with the LGPL. customers have a right to reverse engineering your application.
  • if you include ssrc.jar with a distribution, you must offer a way to get ssrc source code.
• see also
  • https://opensource.org/licenses/LGPL-2.1
  • http://www.gnu.org/licenses/lgpl-java.en.html

Tech Know

• [github actions] workflow on ubuntu java8 cannot deal line PCM_SIGNED 8000.0 Hz, 16 bit, mono, 2 bytes/frame, little-endian
• [midi volume] avoiding noise, SoundUtil#volume should be called before Sequencer#setSequence

References

• https://github.com/shibatch/SSRC
• adpcm
  • https://github.com/SatyrDiamond/adpcm
  • https://segaretro.org/Yamaha_Super_Intelligent_Sound_Processor (yamaha aica adpcm)
  • https://github.com/A-SunsetMkt-Forks/vgmstream/blob/master/src/coding (ps2 etc.)
  • psx
    • https://archive.org/details/adpcmplayerv1.44h (ps2 player)
    • http://zarala.g2.xrea.com/soft/analyse/ps2_adpcm.txt
• Beatnik RMF https://github.com/heyigor/miniBAE
• FITOM https://github.com/madscient/FITOMApp (midi to opl series)
• RTTTL (Ringing Tones text transfer language)
• smaf
  • https://murachue.sytes.net/web/softlist.cgi?mode=desc&title=mmftool
  • https://github.com/mmontag/mmfplay (w/ ym chips)
  • https://funyamora.hatenadiary.org/entry/20080225/1203889006 🇯🇵 (.spf SMAF/Phase)
  • https://github.com/logue/smfplayer.js
  • https://github.com/shirajira/OpenMF
  • https://github.com/Pusungwi/mmf_parser
• mfi
  • https://github.com/starg2/timidity41/blob/dev41/timidity/mfi.c
  • https://github.com/logue/smfplayer.js/blob/master/src/mld.js

TODO

• use Receiver and sysex instead of MetaEventListener
• ssrc: use nio pipe for 1st pass
  • on macos m2 ultra 1st pass is in a blink of an eye
• ima, ms adpcm: wav reader
  • tritonus:tritonus-remaining:org.tritonus.sampled.file.WaveAudioFileReader
• use service provider for mfi, smaf sequencer
• service loader instead of vavi.properties
• midi -> smaf
• https://github.com/but80/smaf825 (patch dump)

---

_{images by melody, cellphone}