Monday 7 March 2022

Preparing a Decent Sampler Instrument (or Sample Pack) for uploading to Pianobook.co.uk - Part 2

Part 1 talked about gathering together all the files that you would need in order to submit an Instrument / Sample Pack using Decent Sampler so that it could be submitted to pianobook.co.uk . You could think of it as most of the 'Theory' side of the process.

This post, Part 2, is all about how you actually go about doing the registering with the pianobook.co.uk web-site, and then how you actually submit the files and fill in the text fields so that your Instrument / Sample pack actually gets uploaded correctly and with minimum hassle. So this is the 'Practical' side of the process.

The most important thing... is what you forgot to mention last time...

In Part 1, I forgot something very important, although I did mention it in passing. So, since this is all about the 'practical' bit, it is a good time to reiterate it. When you are developing anything based on samples, one of the most important things that you must do, before sending off any files, is to:

check your tuning and transposition... 

It is all too easy to work in a closed development loop, jumping back and forth between Decent Sampler and your favourite editor, (well, my current one anyway), and, unless you have perfect pitch (which fades with age, allegedly), or employ other tuning checks, then you can end up with a 'C' on the keyboard that plays an 'A' pitch, and you get an email from Pianobook Submissions that politely ruins your day...  

But I learn quickly (and forget faster), and so I bought two things:

- a Guitar Pedal that does tuning, which, it turns out, shows the Note, but not the Octave (Wah!)

  (There are lots of 'Tuner' pedals available at your favourite local or online music retailer, or Amazon. They come in many different sizes, and there are quite a few approaches to how the tuning is shown. The one I got shows A-G, plus sharps and flats, as well as how close your input actually is to that note, but not the octave.)

- a Tuner/Metronome, probably originally intended for more classical musicians that most readers of this blog, but which it turns out, is also mildly technologically-friendly: it has a jack socket and can be battery-powered! 

 (I bought a Korg TM-60, which has a quarter-inch jack input that accepts line level audio, and so can be used to check the output of Decent Sampler via a DAW via an audio interface (mine is a Focusrite Scarlett 2i4 2nd Gen). Once again, I got one that doesn't show the octave, just the note... But for ease of use, then the TM-60 is definitely a winner.)

Alternatively, you could use your DAW, which almost certainly has a 'Tuner' plug-in...and it may even show the octave! And if there isn't one bundled in, then there are lots of Tuner plug-ins available from many online retailers. You may even find a free one. 

Despite all of this process, my brain still seems to find the connection between the Root Note of a sample and actual pitch a difficult topic. As I write, this, I have received another 'day ruining' email from submissions @ Pianobook.co.uk, telling me that their checks have found a tuning error in yet another virtual instrument. So, I make mistakes as well, and I can't even follow my own suggestions! Hopefully you will be better!

Registering

Part 1 was all about preparing the necessary files, so that the actual registration process would be as smooth as possible. So now, let's register... 

If you visit the Pianobook.co.uk web-site and are not a member, then the far right top menu bar will say 'Login / Signup. If you click on that button to Sign Up, then you get taken to the Login page, which is slightly confusing - but underneath the two big 'Login' text boxes it says:

Not signed up yet?

and there is a 'Join Now' button underneath. (There is also a 'Lost your password?' link!)

The Login dialogue box - you need the 'Join Now' button near the bottom...

Clicking on this button takes you to: https://www.pianobook.co.uk/members/register/ , which is a big dialogue box.

The 'Join Now' dialogue box...

Note that this page is also where you can go to if you need to reset your password... 

What you need to do first is fill in the six text boxes, which is where Part 1 comes in. I'm assuming that the 'Name' and 'Email' fields will be easy to fill in. but the next two fields have some instructions in grey text inside them, as reminders for what you should think about when choosing what to put in them.

Username is going to be used whenever you login to Pianobook.co.uk. In Part 1, I said that you should avoid using your real name or the Display Name which you will be using as your identification inside Pianobook.co.uk.  You can't have spaces either, so there's a temptation to use the first part of your email address (before the '@' symbol), which isn't a good idea because people may already know it. So 'johnsmith27' isn't so good, but 'SampleExpert1000' is quite good, and 'SampleXpert1k' is easier to type and harder to predict. There is also a note that reminds you that you cannot change your username currently, so one you have set your Username, it will stay like that. This is perhaps another reason to choose carefully. Perhaps I should have used a Username like: 'RememberTuning' so that I would check my sample tuning more carefully!

The Display Name can have spaces, and will appear on every post and reply that you make in the Pianobook.co.uk Forum, as well as being the name that will be shown alongside all of the Instruments / Sample packs that you upload. Forum posts will have your Gravatar picture visible, with your Display Name underneath, whilst for your Sample Packs, your profile photo will have your Display Name underneath it. So visitors to the Pianobook.co.uk web-site are going to associate your photo and your name with your samples or your Forum posts and replies. You should not use your Username, and if you have an online identity that is associated with your music, then you should use that. So, if you want to find me on Pianobook.co.uk, you would search for 'synthesizerwriter', and you will find me! 

A quick aside on Gravatar.com


When I mentioned Gravatar in the context of Forum posts, then you either knew what I was talking about, or else you wondered what a Gravatar 'picture' was? If you don't know about Gravatars, then your Forum posts and replies will use a simple white and grey picture, which is very boring. 


This is the default picture that everyone would see if I didn't have a Gravatar picture...


And these are the two Gravatar pictures that appear in the Forum. The synthesizerwriter one is from when the makers of 'The Simpsons' had a web-site that would turn a photo of you, into a 'Simpsonised' version. Unfortunately, the web-site is long gone. The Martin Russ picture (the name has been changed from the 'Not Dave' variant) is just me in my studio.

To get a Gravatar picture, you go to Gravatar.com and create a WordPress account (the process is not that different to what we have been doing here!) and you can then register email addresses and upload photos or pictures that will be associated with those email addresses. Any web-site that uses Gravatars will then use the picture that you have associated with an email address whenever that email address is used to identify you. In the case of Pianobook.co.uk, you have already entered your email address, and this will have been checked against Gravatar.com - if you have an account on Gravatar, and a picture associated with that email address, then that is what will appear in the Forum. 

(Yes, this is yet another hoop to jump through, but once you have done it, you will find that all sorts of web-sites will start to show your picture when you have told them your email address when you registered with them - many web-sites based on WordPress, for instance... )

Stop Press: As I was writing this, Pianobook.co.uk started making the transition to using Discord as a replacement for the Forum, so this information is now out of date... However, a lot of OTHER sites  use Gravatars!

Back to Pianobook.co.uk Registration...


Anyway, back to the Pianobook.co.uk registration:

The most important thing to remember here is:

Username and Display Name should be different!

Hopefully, you have got used to using a Password Manager by now, and so you will be ready with a brand new, different password, generated just for Pianobook.co.uk use. You should never, ever, use the same password for different web-sites, applications, or services. 

You need to enter the password twice. This is a subtle way to try and get you to use a password manager, because you may well make mistakes if you try to manually type the same mix of upper and lower case letters, numbers and symbols twice, exactly. Once you have made a mistake, then you will need to manually type the password twice again, which will quickly become tedious. In contrast, with a password manager, you take your new 'Pianobook.co.uk-only password, copy it, and then paste it into the two fields. Job done!

As is often the case with registering for a web-site or service, there are some terms and conditions to read. You need to read them via the link (open in a new tab) and then tick the box.

To try and prevent malicious people from flooding Pianobook.co.uk with lots of fake accounts, the Captcha tries to make sure that you are a real person, using various (and evolving) methods. In the early days of the InterWeb, Captchas were used to test out Optical Character Recognition systems - so if a text recognition system thought a phrase in some scanned text was 'Roland Jupiter-8', then a Captcha would be used to check if people read the same words. Nowadays, instead of words, Machine Learning systems that analyse photos are checked by asking people if they can see bicycles, traffic lights, busses, trains, etc. in photos, and these are compared with the computer results. So it tends to make creating fake accounts more difficult...

Finally, there is the 'Register' button. If you have filled in everything above satisfactorily (don't you just hate that word?), then you can proceed to the next stage. Notice that there is also an 'Already got an account' link, so that if you somehow thought that entering in your name, email, username, display name and passwords was the normal way to lo in to pianobook.co.uk, then you can go straight to that Login page and just enter your Username and password. A second password reset link is also on this page.  

 The Profile

When you have registered and have logged in to your new account on Pianobook.co.uk, the far right top menu bar will change so that it sats: 'account' followed by a downwards pointing arrow that drops down a menu.


 The drop-down menu has a few options:


'Profile' is the one that you use to edit your User Profile, so let's look at that page:


As you can see, I haven't used 'synthesizerwriter' for this test account, but 'Martin Russ Not Dave' instead. Remember that this is a Display Name, so it can have spaces in it, and it will appear anytime that you post, reply or publish anything - so I'm not going to be using this test account with a name like this.

Any Sample Packs (virtual instruments) that you publish will appear below this top part of the page, below that 'Edit Profile' button. As you can see, Martin Russ Not Dave has published one Sample Pack, and has 1 follower, but is not following anyone. The profile photo is an inverted and mirrored version of the 'Dave' photo, and the photo at the tope, the 'banner-photo' is the default photo of a piano keyboard.

So let's replace the banner-photo. See that blue 'Replace banner' button, with an icon of two pictures being swapped? Click on it. 


You will get another dialogue box, where you can choose a new banner-photo - click on the blue 'Choose file' button, and choose a photo... Note that is says that the size has to be at least 2000 x 500 pixels, under 2 MBytes in size, and despite what it says (and you can check experimentally) the file can be a .jpg or a .png. 

Now, banner-photo is the very first photo that you were asked to prepare in Part 1. Maybe you still like that one, or maybe you want to browse through some alternatives? Well, one source (apart from taking your own photos!) is Unsplash.com - a source of freely-usable photos. To replace the piano keyboard, I used a photo of a classic Moog modular by Steve Harvey on Unsplash ...


Once you have 'Save'd the new banner-photo with the blue 'Save' button, then the Profile web-page will have a new banner photo across the top:


The Profile page with the new banner photo.

Next, that Display Name needs changing to something sensible, and the photo of Dave needs to be changed as well, and more... The photo of Dave is the profile-photo, which has to be a .jpg (JPEG) file. But where is the blue button? Actually, you need to hover your mouse over the photo, and a blue button will appear, with the 'two files swapping position' icon that was on the banner-photo button. The dialogue box is identical, except that it states that the photo has to be square, and at least 500 pixels wide. So I chose a pixellated version of one of the photos on Gravatar:


To change the rest of the Profile web-page, you click on the blue 'Edit profile' button. You may not be surprised to learn that this opens another dialogue box, with fields to fill in!


After changing the text fields with the information that you prepared in Part 1, and saving with the blue 'Save changes' button, the revised Profile web-page is complete:


Now, we need to upload a Decent Sampler Instrument / Sample pack!

Submitting... 

Back to the menu bar, and this time, the 'Submit' button. 


On Pianobook.co.uk, you 'Submit' an Instrument / Sample Pack for evaluation, and after various checks (tuning, perhaps? keyboard colouring?...) in the 'Submit Queue', it will be published, and made available for anyone to download from your 'Profile' web-page. So your Profile web-page is the first destination that anyone searching for you and your Instruments / Sample Packs will find, and it is a catalogue of all your published Instruments / Sample Packs. So how your Profile web-page appears is very important - lots of people are going to see it. This is why the first section of this blog post has concentrated on showing you how to fill it with your photos and text. 

When you click on the 'Submit' button (which, for once, is NOT blue!), then you get taken to a page which has a banner photo at the top, containing a selection of microphones, to remind you that this is a web-site where samples are important! Scroll down the page, read the instructions, and keep scrolling down until you get to the big reveal...another dialogue box:


Once again, the text fields should have already been prepared. In this first dialogue box for the submission process, the three fields are found in the 'README.txt 'Story' file that is in the main 'MyDecentSamplerStuff' folder. You can see that I have copied and pasted the relevant fragments of text from the README.txt file for my 'Drone Drone' Instrument / Sample Pack, into the three fields. Note that the 'Story' field requires at leat 150 characters, although many people provide a lot more than this (yes, me, guilty as charged). When you have done this, then click on the blue 'Save updates' button and you will be taken to the next dialogue box....

Choose your category!

This dialogue box is where you choose a category for your Instrument / Sample Pack by ticking a box. For some submissions this is easy, but for others it can be very difficult. The Pianobook.co.uk web-site doesn't seem to use this feature very much (there's a 'Sample Packs' menu button that shows some of these categories, for example), but as the number of Instruments / Sample Packs get larger (1,000 is the next major milestone) and goes beyond that, then ways of partitioning the available instruments / Sample Packs into manageable numbers will be increasingly important if visitors to the web-site are not going to be overwhelmed. Christian Henson has talked about using the Ratings system to help with this, apparently by allowing the best to have the most visibility... 

The next dialogue box is for photos and a video to accompany all the text...


The 'Sample Pack Image' is the '<Sample-Pack-Name>-photo.jpg' that you prepared in Part 1. It should be at least 1000 x 500 pixels, in monochrome (black and white), and be a .jpg (JPEG) or a .png (PNG) file. When you click on the blue 'Choose file' button, you just need to be looking for the 'photo' file in the 'resources' folder. 
 
The 'GUI Images' is the same procedure, but this time you are looking for the 'ui-user-interface' file in the 'resources' folder.

The 'Videos' is two text fields that need a URL and a title. I use this to provide access to a video that explains my User Interfaces (UI, or GUI, for Graphical User Interface, as it says in the dialogue box). I use the title: 'UI User Interface Video' so that people know what the video is, and you could also make the video thumbnail or the start of the video say something similar. 

Remember that those amazing individuals who produce demos for Pianobook.co.uk are going to be all over your submission, turning it into a gorgeous demonstration of how good your Instrument / Sample Pack can sound when used in context by another composer. And these people will hear your Instrument / Sample Pack fresh and without any baggage, so you may well get a very different interpretation of how it can be used, and the timbres that it can produce. All of which is a long-winded way of saying that maybe this video is a good place for instructional material on how the user interface works, how to select different timbres, etc., and not a demo of how it sounds. The web-page is organised as : Story on the Left, Demos on the right, and you don't want to confuse visitors.

There's an interesting feature that you might miss the first time you use this dialogue box. It is the small blue box on the right hand side with a '+' in it. This allows you to add up to two additional videos (for a total of three!) if you want... (When you get to three pairs of URL and Title fields, then the blue '+' box vanishes, so you can't just keep adding videos and videos forever!)

Clicking the '+' box allows up to three videos to be added to your 'Profile' web-page...

Then there's the legal stuff, where you carefully read every word of the End User Licence Agreement (EULA), making sure that you understand it completely, and then tick three boxes in a checklist to confirm that you have done stuff. 

Read, tick, tick, tick....Next!

The first bit is easy - just a few minutes of reading the first time, and after that (for your next Instrument / Sample Pack!), then just checking that the EULA hasn't been updated. 

The checkboxes are interesting. 

ONE The first one is Kontakt-specific, and doesn't apply to Decent Sampler Instruments / Sample Packs - but I tick it anyway, for completeness (Who wants an empty tick-box?). Some people might be confused because the word 'unticked' is included in the explanatory text, but there's definitely a tick required in this tick box.

TWO The second is confirming that you have created a single .zip file, and this is essential if you want to be able to upload your submission in the next (and final) dialogue box... So this is a tick as well. 

(You have been following this, haven't you? You have double compressed your folder and have created the '20220226-MyDecentSampleStuff-YourName-V1.zip', haven't you?)

THREE The third is agreeing to the Terms and Conditions, which are on the same page as the EULA, and you probably already read them anyway, since they are just after the EULA and you tend to just keep reading through that sea of text... and so this is a tick as well. 

Once all three tick boxes are ticked, you can click on the blue 'next' button and go to the final dialogue box...

The final dialogue... for now...

The blue 'Choose file' button is what you need to click first. Choose your .zip file ('20220226-MyDecentSampleStuff-YourName-V1.zip'), and it will appear as shown in the screenshot above.

This is a good time to make sure that you selected the correct .zip file! Remember that this .zip file is NOT inside the 'MyDecentSampleStuff' folder! it is at the same level, so you may need to go back up the folder hierarchy by one level...

Then tick the 'Decent Sampler' tick-box, and you are ready to press the blue 'Upload your zip file' button.

The grey/gray bar will show progress uploading your .zip file to Pianobook.co.uk. As always, the longer the file, the more time it will take. Faster broadband will reduce the time it takes to upload. 

The first time I uploaded a 2 Gigabyte (actually Gibibyte, but that's a totally different blog post!) file, I worried that this would be too big for Pianobook.co.uk to cope with, but remember that they are used to receiving very large files! Huge files for you are everyday for them...


Tidying Up

Sorry, you aren't quite finished. Not yet.

Yes, your .zip file has been received, and is in the 'Submit Queue' being analysed and processed, but there's a couple of things that still need to be done...


Go to your Profile web-page, and right at the bottom of the page, you should find a 'Your Pending Submisions' area with your brand new Instrument / Sample Pack. Click on that (the green will go pink) and the web-page for that Instrument will open... 

(Yes, this isn't from the test account, because I don't want to actually upload a test .zip file. Instead, this is the 'Submit Queue' from my 'synthesizerwriter' account on Pianobook.co.uk, showing two versions of 'Drone Drone' waiting to be processed. Yes, I made several updates very quickly!)


And this is the 'Pending' page that only you see whilst your .zip file is in the 'Submit Queue'. There's a pink banner across the top of the page, and you can see the Sample Pack Name (Drone Drone in this case), the Description / Tag Line (Not the 1980's any more...), and the 'photo', as well as the 'Story'. 

Now, before Aril 2022, this was the point where you would notice that the 'Story' doesn't look right...

All the Carriage Returns and Line Feeds would have been removed, and so there would be just one long piece of text, with no paragraphs, no 'white space'. You would then need to fix this after you had uploaded a .zip file and it hd been approved (you get a 'Congratulations' email) and then placed into the 'Submit Queue', and appears as Pending in your personal 'Profile' page.


Okay, so after April 2022, the carriage returns, line feeds and various other characters were no longer removed, so there's now no need to edit the text any longer...

Unfortunately...

People are very interesting. No matter how much they try to make a piece of text perfect, with no typos, correct spelling, good grammar, no swearing, not too many exclamations marks!!!, and more, then the more likely it is that one of these will sneak past them and get into the text you have just uploaded. So, although the text that you see at this point is no longer a solid block of text, it is almost a certainty that when you read it, then you will find a typo, some bad spelling... etc. So although the April fix makes it easier, there's something inherent in the human psyche that means that you will probably find something that needs to be fixed in your text... 

To fix it, you need to scroll down, past the 'Story', past the UI Video, and past the GUI screenshot. There , just before the Ratings and Reviews, you will find the 'Sample Pack' control panel.


These blue buttons are the key to fixing any problems or missions that you find after you have submitted the .zip file. From left to right, you can edit:

- The text fields: Sample Pack Name, Description (tag line), and the 'Story'.
- The photo for the Instrument / Sample Pack (there's a typo here, although you could argue that the 'photo' is in the same place as the 'banner' on your Profile web-page...)
- The videos (up to three, remember). Videos are rarely correct first time, so this allows you to add some more.
- The UI screenshot. Again, it is only after you have uploaded the .zip file that you notice the glaring error in the UI screenshot.

To fix the 'Story' text, you use the blue 'Edit text' button. This opens... a dialogue box!


The screenshot above shows the 'after' view. What you start with looks like this:

Drone Drone? Is it pronounced: 'Durone Durone', perhaps? Could this refer to an 80s band? 'o'='a'? 'e'= (Base 64? URL encoding? ) Or is it a recording of a noisy flying device? Zzzzzzzz...

And all you do is just add 'Returns' in to break it up into the lines that you had in the original text file for the 'Story'. 

Now the text field is quite small, but there's another of those 'not obvious at first glance' features at play here. Look in the lower right hand corner of the text field, and you will see two little diagonal lines - these allow you to expand the text field downwards so that editing is much easier!

(In case you were wondering why things happened in April 2022, well, I put in a bug report for the loss of the carriage returns and line feeds... This may, or my not, have had something to do with them no longer being removed after April 2022. I like to think that I might have just nudged things along ever so infinitesimally!)

You have now completed the Submission process for a Decent Sampler instrument / Sample Pack for publishing on Pianobook.co.uk.

Completion


When your submission has passed through the whole publishing process, a new box will appear on your Profile web-page:

Your Profile web-page should now have the Instrument / Sample Pack on it.

My apologies for the Kontakt Instrument / Sample Pack shown here - my test account only has this on it. 

In the next part, Part 3, I will look at what happens when you need to update a Decent Sampler Instrument / Sample Pack... and I'm still working on that...

---

If you find my writing helpful, informative or entertaining, then please consider visiting this link:


Synthesizerwriter's Store (New 'Modular thinking' designs now available!)

Buy me a coffeeBuy me a coffee (Encourage me to write more posts like this one!)


  








Buy Me a Coffee at ko-fi.com

No comments:

Post a Comment