100% Managed Soundtrack Music Module Player

Reopened Issue: Wish: Implement XNA Output [324]

Mdwf — Fri, 14 Jun 2013 07:53:45 GMT

I'd love to try playing chiptunes on Windows Phone 7

Reopened Issue: VS2010 project setup [612]

Mdwf — Fri, 14 Jun 2013 07:53:45 GMT

The project from SVN is incorrectly set up. Files are linked from the core project by absolute path, like so:

error CS1504: Source file 'F:\Dev\SharpMod\SharpMod.Core\SharpModEventArgs.cs' could not be opened ('Unspecified error ')

Reopened Issue: MOD files loading [737]

thomasdjafari — Fri, 14 Jun 2013 07:53:44 GMT

I've tried a few mod files, some from the original MK Soundtracker and they are not recognized as modules.

What modtracker is exporting the mod format recognized by the loader?

I remember on the Amiga, the loaders were very forgiving and would not really perform any checks; the various soundtrackers performed very basic checks to tell a format apart from another, but this was very limited. This may have permitted non standard files to grow and spread as they just worked back then.

I attached sleepwalk, it is one of the very first modules ever made. It loads properly in VLC but not in SharpMod (not recognized as a module).

Closed Issue: Wish: Implement XNA Output [324]

Mdwf — Thu, 16 May 2013 06:30:35 GMT

I'd love to try playing chiptunes on Windows Phone 7

Closed Issue: VS2010 project setup [612]

Mdwf — Thu, 16 May 2013 06:30:34 GMT

Closed Issue: MOD files loading [737]

thomasdjafari — Thu, 16 May 2013 06:30:34 GMT

New Post: Compliments!

Mdwf — Wed, 17 Apr 2013 14:36:02 GMT

I must admit that I am impressed to have a post of the famous Jean-Paul behind mikmod. Your compliments affect me much and I also would like to thank you for the original version of mikmod.

New Post: Compliments!

jpmikkers — Wed, 03 Apr 2013 22:16:48 GMT

This is very cool. I never thought I would see this running in C#, but you did it! In case you're wondering, I was the original author of mikmod a looooooong time ago. C# happens to be my favorite language too now.

New Post: volume

flossy — Sun, 09 Dec 2012 02:16:55 GMT

Hi.

I got a bit of a weird question..

Ive tried exporting some modules to json (loading the module with sharpmod and just dumping the entire chunk as json) and fiddeling around with the mediacontext and playing them

When testing with this song http://modarchive.org/index.php?request=view_by_moduleid&query=60395 on for ex the first track of pattern 1a i have volume 14 and effect 3 on the earlier notes in there. but when checking the json data the volume is missing on those cells.

The volume is there on cells without any other effect, and then they show up as effect 0c so it feels like it gets discarded if any other effect is present on that cell.

The effects seem correct though (portamento and volume) so not sure if i have done something else wrong or if the celldata is incomplete without the unitrack?

New Post: Unity / Mono

Mdwf — Fri, 09 Nov 2012 15:40:05 GMT

Hi !

Good job to do this with Unity.

I don't know the .NET framework Level implemention of unity, but if it supports Sequential Layouts on Structs you can improve the short to float conversion.

It's with a real pleasure that i'll see what you do with SharpMod if you want to send me a demo.

New Post: Unity / Mono

zaikman — Fri, 09 Nov 2012 04:10:50 GMT

For those interested, I managed to (partially) solve my problem.

My short to float conversion was all borked. I believe it was trying to cast the first byte as a float, and then bitwise-OR it with the next byte, rather than packing both of them into a short first. The following method is what I'm using now and the results are much, much better.

private float ShortToFloat(byte[] bytes, int index)
{
    // Convert unsigned short to float
    float f = (short)(bytes[index] & 0xff | bytes[index + 1] << 8);
        
    f -= 32768f;
    f /= 32768f;

    f *= 0.75f;

    return f;
}

I'm not quite sure why, but if I don't scale the result down by 75%, the resulting values clip outside of the [-1,1] range. I suspect there's still something wrong with the calculation, but this is loads better than what I tried earlier. I now have a working tracker running in Unity, so yay!

Thanks so much for doing the heavylifting on this project. So far SharpMod seems really awesome and I'm excited to leverage it in this project of mine.

New Post: Unity / Mono

zaikman — Thu, 08 Nov 2012 19:28:27 GMT

I'm also interested in using SharpMod in a Unity project. Unity recently added support for playing MOD/XM files natively, but the project I'm working on requires interaction with (and run-time composition of) chiptunes - SharpMod seems like a perfect fit!

Unfortunately, Unity doesn't support audio engines like NAudio; instead, they expose a callback (OnAudioFilterRead) that gets called every time a chunk of audio is routed through the main filter. It gets called every ~20ms, depending on the samplerate and platform. The buffer passed in is an array of floats, consistently sized to 2048 elements; I'm also given the number of channels. Because it's expecting stereo audio data, I write 1024 samples, between [-1.0f, 1.0f], each time the callback fires.

Because the callback runs on a separate thread, I avoid retrieving bytes from the SharpMod player during the callback. Instead, I create a ring buffer to which I maintain a read/write pointer. I write to it during the script's normal execution and read from it in the OnAudioFilterRead callback.

What I have working at the moment sounds very, very close to what I'd expect to hear, except with a lot more noise and some unusual looking values when I graph out the waveform. I think I may be doing something incorrectly when converting the 16-bit PCM data to signed floats.

Here is my short-to-float conversion function

private float ShortToFloat(byte[] bytes, int index)
{
    // Convert unsigned short to float
    float f = (bytes[index]) | (bytes[index + 1] << 8);
        
    f -= 32768f;
    f /= 32768f;

    return f;
}

And here is how I read data from the SharpMod player and store it in my circular buffer:

// Declared earlier:
// byte[] tmpBuffer = new byte[4096];
// float[] latencyBuffer = new float[LATENCY_BUFFER_SIZE];

int bytesPerSample = Player.MixCfg.Is16Bits ? 2 : 1;
int channels = (Player.MixCfg.Style == SharpMod.Player.RenderingStyle.Mono) ? 1 : 2;
int read = tmpBuffer.Length;

read = Player.GetBytes(tmpBuffer, read);

for (int i = 0; i < read; i += bytesPerSample * channels)
{
    float lSample = ShortToFloat(tmpBuffer, i);
    float rSample = ShortToFloat(tmpBuffer, (i + 2));
                
    latencyBuffer[writePtr] = lSample;
    latencyBuffer[writePtr + 1] = rSample;

    writePtr = (writePtr + 2) % LATENCY_BUFFER_SIZE;
}

And here is what the contents of the buffer look like. The top and bottom grey lines mark the +1/-1 boundaries. The sound itself is recognizably the chiptune I'm testing, but everything is heavily amplified with

 periodic pops and clicks.

If I normalize the PCM data by scaling down by 65,535 instead of 32,768, I wind up with something that looks like this instead. It's much closer to what I'd expect the waveform to look like, but it's still quite wrong.

I feel like I'm overlooking something very obvious, but I'm not quite sure what. If you could provide any insight, it'd be greatly appreciated.

Thank you!

New Post: Sharpmod on WP7?

dace1978 — Fri, 12 Oct 2012 16:21:14 GMT

Thanx for such a quick abswer, I tried the WOMP, It's awesome :D Keep up the good work

New Post: Sharpmod on WP7?

Mdwf — Fri, 12 Oct 2012 14:29:04 GMT

Hi,

SharpMod is only a library for module replay. I know that Zmurf have made a player using SharpMod for WP7 Called WOMP. You'll found it on : http://www.windowsphone.com/sv-se/store/app/womp/e22e8bda-4be1-44d4-8687-7d1d954ac71e

New Post: Sharpmod on WP7?

dace1978 — Tue, 09 Oct 2012 21:15:33 GMT

Hi, I'm a big fan of tracker/module music and I was wondering how can I play modules on my WP7 (Omnia 7 phone). How do I do that, any suggestions, cos I'm really eager to try your program on my phone. Thanx in advance

Source code checked in, #17477

Project Collection Service Accounts — Mon, 01 Oct 2012 20:26:53 GMT

Upgrade: New Version of LabDefaultTemplate.xaml. To upgrade your build definitions, please visit the following link: http://go.microsoft.com/fwlink/?LinkId=254563

Source code checked in, #17476

Project Collection Service Accounts — Mon, 01 Oct 2012 20:25:50 GMT

Checked in by server upgrade

Updated Wiki: Home

Mdwf — Fri, 14 Sep 2012 11:32:39 GMT

Project Description
A Soundtracker Module music player in C# (100% Managed, without interops), At the beginning, a simple port in C# of the famous Mikmod Library. Today, it have some improvements. Three versions are avaible : NAudio Output, Silverlight and XNA (Windows Phone 7, Windows and Xbox360).The code is shared by links between projects from a trunk "Core" Project. Audio renderers are saved in each project files (Windows, Silverlight and XNA)

SilverLight Screenshot :

Winforms Screenshot :

Command line, with track view and position

Project's Goal

This library allow you to add soundtracker music replay to your .NET applications. It's designed for framework 3.5 and 4.0.
Actually, Protracker, FastTracker ans ScreamTracker formats are implemented.

5 Lines of code to do this :

SongModule myMod = ModuleLoader.Instance.LoadModule("SongModule.Mod|S3M|XM");
ModulePlayer player= new ModulePlayer(myMod);

// Silverlight Driver
SharpMod.SoundRenderer.SilverlightDriver drv = new SharpMod.SoundRenderer.SilverlightDriver(MyMediaElement);
// Or NAudio Driver
SharpMod.SoundRenderer.NAudioWaveChannelDriver drv = new SharpMod.SoundRenderer.NAudioWaveChannelDriver(NAudioWaveChannelDriver.Output.WaveOut);
// Or XNA Driver
SharpMod.SoundRenderer.XnaSoundRenderer drv = new XnaSoundRenderer(new DynamicSoundEffectInstance(48000, AudioChannels.Stereo));

player.RegisterRenderer(drv);
player.Start();

Where can I found a Song Module ???

On you're Amiga old floppies or....

The Mod Archive http://www.modarchive.org
Amiga Music Preservation : http://amp.dascene.net/home.php
and many other ways :o)

Performance
-The replay routine take between 1% and 18% Cpu depending of module played on my PM1.5Ghz centrino laptop.
-Better on my E6300 1.8Ghz desktop.
-Seems to have minor problems on my wife's N270 1.6 netbook (have to test again). Have tested, it's the FFT and visualizers who are too expensive.
-Seems to play fine with the WP7 Emulator. I Need some help to test on real WP7 Hardware.
-Take a maximum of 5% on my new I5-2537 Alienware M11X on complex Module (32 chans with lots of effects and big samples)

Known issues
The Naudio version will hang up on 64 bits systems (error while loading the NAudio assembly). I'll try to fix it with a modified version of NAudio.

29/05/2011.. first XNA's renderer work
- Thx to the DynamicSoundEffectInstance class... the first attempt to play Mod on WP7 is successful

23/07/2011 All Xna Platforms are are ok
-See the source code, release will be coming soon.

07/11/2011 Welcome to a new developer
- Since the november 4th, Waldog78 will contribute to the project with me.I Hope that we can deliver a new release as soon as possible, including the full XNA binaries and samples for all platfroms and major fixes of the issues.
- The VS2008 solutions will be obsolete, all code will be maintened under VS2010. The target Platforms are .NET 3.5, Silverlight 4 and XNA 4.0

The XNA sound renderer is present in the svn source code. Not yet avaiable as stable release.

14/09/2012 SharpMod is still alive

- A Major release will be coming soon, stay tuned

- Enjoy the new SharpMod Logo :)

Donate
SharpMod is a free open source project that is developed in personal time. You can show your appreciation for SharpMod and support future development by donating.

Future
- try to solve bugs
- make a Mono sound renderer (Have some ideas with PortAudio)
- Test and adapt for Moonlight

Have fun !

New Post: Unity / Mono

Mdwf — Mon, 02 Jul 2012 15:35:17 GMT

I've not the time to make a Mono version for the moment. So, if you would use the Core of sharpmod, you need to have a Sound buffer access that can read by thread the SharpMod Output. If you take a tour of the differents sound renderer you'll see that any methods used read the player GetBytes() method.

So, if Unity have a buffered sound system that can accept a byte array, it's possible to make it working :)

I use some .NET 3.5 features in the core, so, there are easy to found and replace with old .Net 2.0 code.

In Conclusion, I'm agree with you for the tracker's modules, it's still a good format to provide high quality music with a minimum of file size. It's with this thing in mind that I was motived to make SharpMod :)

New Post: Unity / Mono

knanshon — Wed, 27 Jun 2012 19:45:04 GMT

I'm very interested in exploring the possibility of getting a working tracker playing module working from within Unity. I'm an old games coder so I could look through the source, but I'd like to ask some advice about how one might best approach this, specifically with regards to the mono sound renderer I saw mentioned on the SharpMod wishlist. It would have to compile as C# Unity script, which uses a modified version of Mono based on the .NET 2.0 Framework.

Not only do I like tracker music and believe it would be great to hear more of it in games, I'm always looking for ways to make the smallest download size possible, and you can't get music much smaller than proper chiptunes. Not only that but a working tracker playing module with a good API could allow the implementation of some creative music-based game designs.

Cheers