Ok, so ever since Pianobook.co.uk was launched on the 29th of March, 2018, you’ve spent ages sampling your piano, and then more time editing the samples, then taken a photograph that you are happy with, then decided on using Decent Sampler as your sample player, then edited your ‘MyDecentSampleStuff.dspreset’ file so that it works correctly (and you’ve struggled with the instructions, read Dave Hilowitz’s 'format documentation' numerous times and you still don’t quite understand all of it, and more…). But, finally, you think that you are finally ready to submit it to pianobook.co.uk!
Not quite.
There’s just one more hoop to jump through… Preparing your Decent Sampler Sample Pack for uploading to Pianobook.co.uk.
Actually, this bit is quite simple, with just a few easy steps…
I have done this quite a few times now, so this blog post contains a lot of tips on how to do it and get it right, and avoid problems.
( I’ve screen-shotted a Mac for this tutorial document, but the process should be very similar on Windows or Linux. I’ve tried to remember to say folder/directory each time I use the word… )
Preparation for submission:
0. Signing up with pianobook.co.uk
[ ] A banner photo or graphic of 2000 x 500 pixels, which can be in colour, and can be a .jpg or a .png. This will be faded to white by the web-site when you scroll down. I called this file: profile-banner-2000x500.jpg, which makes it easy to get the right size of photo or graphic, and easy to find when you upload it to the web-site and into the banner in your profile. There is a maximum size of 2 MBytes for this file, which is shown in the dialogue as 2mb (a typo), which is millibits, which equals 2/1000th of a bit. You can't fit very much graphical information in that amount of data...
| Dave - the Neumann KU 100 binaural head microphone |
[ ] Some text that you might need to think about beforehand.
Your Name and Email address should be easy. But you might want to consider your User Name (used for logging in, and any spaces will be removed...), and your Display Name (how you want to be known on the web-site) early rather than when you get to the dialogue box, and the pressure to be smart and subtle and cool starts to build…
1. The starting point.
It might be a good idea to make a tick-list of all the files that you will need:
[ ] A plain text file, called README.txt, containing:
- The name of the Instrument / Sample Pack (avoid copyrighted and trademarked names, please) (40 characters max)
- The ‘tag line’: about 10 words, approximately, that encapsulate why your Instrument / Sample Pack is special… (140 characters max)
- The ‘Story’: why you made the Instrument / Sample Pack, how you made it, how to use it, how the user interface works, what presets are included, how the MIDI CCs are mapped… This is a long piece of text, in many cases… It has to be at least 150 characters, but should ideally be considerably longer - there should be a lot to say about your instrument / Sample Pack! One useful tip is to put a version number at the end of the text, so that you know which version is currently on Pianobook.co.uk - I have a tracking spreadsheet that I use as well... Another tip is to write the 'Story' in a text editor or word processor, and then just copy and paste it into the text field in the dialogue...
[ ] Samples recorded by you from your piano or kalimba or toothbrush… or other source, and then probably edited to clean them up, possibly processed, and named with an identifier, a note value (as per A#, not Ab) - all stored inside folder called 'Samples' (Or 'NR' if they are noise-reduced samples!). I also tend to add the number of samples in the sample (minus 1) to the filename, so that it is easy to set the ‘end=‘ parameter inside the Decent Sampler .dspreset XML file. This can make looping samples much easier to manage, so it is strongly recommended. So a typical sample file might be named: 'MDSS A0 10123.wav'.
[ ] A photo of your piano, kalimba, recorder, or other source (Some of mine are a bit abstract!). This should be at least 1000 x 500 pixels, (or it could be 1624 x 750 pixels, if it is a double size version of your Decent Sampler background picture), in monochrome (black and white), and be a .jpg (JPEG) or a .png (PNG) file. If you submit a colour picture, the the Pianobook people will turn it into black and white, but you will not have any control over how they do the conversion. So, remove the middle-person, and do the greyscale conversation yourself. I tend to call this by an abbreviation the name of the Instrument / Sample Pack, plus ‘-photo’, which isn’t original, but is easy to find when you are searching for it to add it to a dialogue box. So, for ‘MyDecentSampleStuff’ the file would be called ‘MDSS-photo.jpg’.
[ ] A photo or graphic of 812 x 375 pixels, that will be used as the background by Decent Sampler. This can be a .jpg or a .png. A .png file is probably going to be larger than the equivalent .jpg in most cases. I tend to name this file starting with the Instrument / Sample Pack name abbreviation, followed by ‘-background’, so ‘MDSS-background.jpg’ etc.
[ ] A picture of the user interface of your Instrument / Sample Pack. The easiest way to do this is to capture a screenshot of Decent Sampler with your .dpreset file loaded into it, and then to crop it down to the edges of the Decent Sampler application/plug-in. Again, I tend to call this file with the Instrument / Sample Pack name abbreviation, followed by ‘-UI-user-interface’, so ‘MDSS-UI-user-interface.jpg’ etc. This can be a .jpg or a .png.
I can’t stress how much easier it is to find files when they are named consistently with names that still make sense several days, weeks or months later. Alternatively, if you are happy with trying to remember if it was ‘ZpOld34x.jpg’ or ‘ZdOlp43c.jpg’ that was the edited version of your background, then that’s fine by me.
2. In more detail…
Before the October 2021 update of the pianobook.co.uk web-site, one thing to be very aware of was that the photo would have the name of your Instrument/Sample Pack inbound white text in the centre of the photo on the wen-site, and in the ‘PianoDrop’ videos where 5 submissions from the previous month were showcased.
3. Filling the folder…
Inside the folder/directory you should have the MyDecentSampleStuff.dspreset file that you have been working on (and there is a backup on a separate drive or in the Cloud, isn’t there?), plus a ‘Samples’ folder/directory that contains all of the samples (CH has a specific way of naming samples that you can use, and details are given here: https://www.pianobook.co.uk/resources/how-to-sample/recording-your-piano/ ) that are used by MyDecentSampleStuff.dspreset. As I noted earlier, I also add the length of each wav file in samples (minus 1) so that setting the loop length is easier (and harder to get wrong!) when editing the XML .dspreset file).
For historical reasons (= maybe we did it wrong from the start) the 812 x 375 pixel .png background photo or graphics (called ‘MDSS-background.jpg here), is often found in the Samples folder/directory.
From the top downwards, the first file you need to add to the folder/directory is the ‘MDSS-photo’ which can be a .jpg or a .png. The second file to add is the README.txt file, which is the plain text (.txt) file that contains the majority of the text that you will enter into the first submission dialogue box.
The next thing to do is to create a ‘resources’ folder/directory. This will be used to hold a backup of the background graphics used by Decent Sampler, plus the screenshot of the user interface of your Instrument / Sample Pack. You could also put a safety copy of the MDSS-photo file and the README.txt file in this folder/directory. (Many operating systems have a keyboard combination that will turn a mouse drag into a copy, which can speed up all sorts of file management tasks, and is well worth finding and learning...)
You can use the next picture as a tick list for filling the folder/directory:
(A quick aside here. This is the MINIMUM set of files that you should put into a Decent Sampler folder. One additional 'goodie' that you can add is a few extra 'Presets'. These are .dspreset files that you save by using Decent Sampler's 'File>Developer Tools>Save Preset...' menu option. Take the time to name and number these, so that users will know what they are, and also to make them easy to spot against the MyDecentSampleStuff.dspreset file, which is the default 'preset' file. One approach might be to use a naming template something like 'MDSS-Preset01-Best-Piano-Ever'... Note that the XML is formatted slightly when it is saved, so comments are removed, and the text is wrapped, so the process of saving presets should be a one-way process - this way you don't lose your beautifully commented, un-wrapped master .dspreset file that you have spent hours editing.)
Unsurprisingly, the larger your MyDecentSampleStuff folder/directory is, the longer the compression will take to complete... When it is finished, you should have a .zip file called ‘MyDecentSampleStuff.zip'.
This file should then be put inside the ‘MyDecentSampleStuff’ folder/directory…
Remember that the .dspreset file is just an XML (text) file containing only the instructions for playing the samples, and so is usually quite a small size file. In complete contrast, the .dslibrary file contains all of the files for the user interface and the samples themselves, and so will be much larger in size. Take care not to mix these two files up - they are very different!
The next thing to do is to select the ‘MyDecentSampleStuff’ folder/directory again, and compress it into a .zip file. (Red box = Compress this folder!)
When the compression has finished, the result will be a ‘MyDecentSampleStuff.zip’ file. This time, you DO rename this file but you leave the suffix alone - this is the .zip file that you will upload at the end of the submission process, and so it needs extra information to help yourself and the people at Pianobook.co.uk. My suggestion is to use 'ReverseDate-InstrumentName-YourName-Vnumber.zip' using 'camel-case' for the names. The reverse date format (YYYYMMDD) means that your .zip files will sort in date order when you look at them in a computer. So the final .zip file name might look like: '20220226-MyDecentSampleStuff-YourName-V1.zip' for something uploaded by YourName on the 26th of February 2022.
4. Completed!
Note. It may seem strange to zip things twice, but this is so that you have a single file that can be uploaded, and so that you have a stand-alone .dslibrary file which contains everything required by Decent Sample for ‘MyDecentSampleStuff’. (You can just drop it on Decent Sampler and you will get everything!) If you drop a .dspreset folder onto Decent Sampler, then it has to be from inside a folder/directory called ‘MyDecentSampleStuff’, from where Decent Sampler will look for various files in a folder/directory called ‘Samples’ and will need to load them in order to work..
DO NOT stop after the first compress and think you have finished! Yes, I know it (temporarily) produces a .zip file, but you are going to immediately change the suffix so that you have a .dslibrary file that contains a complete set of instructions, graphics and samples for Decent Sampler. You need to have a .dspreset file, a .dslibrary file, and everything else in the final .zip file. You can use the following screenshot as a check-list and reminder:
The ‘20220226-MyDecentSampleStuff-YourName-V1.zip' file highlighted in blue on the top line contains everything in the 'MyDecentSampleStuff' folder underneath it.
In the next part I will go through the ‘Submission’ dialogues in the same level of detail.
---
If you find my writing helpful, informative or entertaining, then please consider visiting this link:
Synthesizerwriter's Store (New 'Modular thinking' designs now available!)






