Skip to content
ibsh edited this page Sep 10, 2012 · 74 revisions

KeyFinder: Frequently Asked Questions

Crashes and bugs

KeyFinder crashed! What do I do?

You know when you're DJing, and the dancefloor's packed and good times are all about, and that one guy comes up and asks, with a totally straight face, "won't you play something good"?

Receiving this question can feel a little like that. Of course you want everyone to have a great night, and of course I want to find bugs in KeyFinder and fix them, but the way in which the question is asked often provokes one reaction above all others. It is commonly abbreviated WTF.

So, if you're having trouble with KeyFinder, either raise an issue here on github, or send me an email, but make sure it's detailed. If I can't understand your message, and can't recreate your problem, I usually can't fix it. So the best thing is to recreate it for yourself, and describe exactly what you did, unambiguously, step-by-step.

  • Tell me the KeyFinder version number. You can get it from the About screen.
  • Tell me which OS and version you're using.
  • Are there any error messages? Does the application close down? Does the OS show any messages? If you can't describe something, how about a couple of screen shots?
  • If you do the same operation multiple times, does it always fail in the same way, or on the same file?
  • And finally a quote, from a very good article on this subject: Above all, be precise. Programmers like precision.

I'm getting a "Memory allocation failure adding xxxx samples to audio stream of size yyyyyyyy"

I don't really know what this is. It seems only to affect the a minority of Windows users, and I've researched the hell out of it but I can't recreate it. Some users have found that disabling parallel batch jobs in the Preferences stops this from happening, though it slows things down. Anyway, I could use some help with this. Do you have any experience with cross-platform deployment or cross-compilation? Get in touch!

The Windows versions says it's missing MSVCR100.dll. What do I do?

You're missing run-times for Microsoft Visual C++ 2010. Try running the redist.exe from the KeyFinder zip file, or you can download from Microsoft (Credit to Papa Midnight).

Expected behaviour

Why doesn't KeyFinder write to my files during analysis?

If you want this automatic behaviour, go to Preferences (or Preferences > Tags , prior to v1.9) and check the relevant box. Alternatively, once you've run a batch job, select all the files you want to write to and then right-click > Write key to tags.

Why doesn't KeyFinder use any sharps?

Every sharp is also a flat*. Look at a piano keyboard: the black key between C and D can be called either C# or Db, dependent on context. I just use all flats in KeyFinder because "b" looks better in more fonts than "#". It's also one keystroke fewer =)

* For the sake of simplicity, and with apologies to any music theorists.

Why doesn't KeyFinder use the Camelot codes?

Because they're the intellectual property of Mixed In Key. KeyFinder allows you to specify custom codes in the Preferences pane.

Can I use KeyFinder on the command line?

Sort of. Call the executable with the command line arguments -f filepath to have the key estimate printed to stdout (and/or any errors to stderr). If you also use the switch -w it will try and write to tags. Preferences from the GUI are used to determine the exact operation of the CLI.

Don't forget that the Mac binary is buried in the .app bundle, so your command line will look something like: ./KeyFinder.app/Contents/MacOS/KeyFinder -f ~/Music/my_track.mp3 [-w]

Tags

Is KeyFinder deleting my tags?

No, I don't think so. KeyFinder uses TagLib, which will overwrite any ID3 v2 tags with ID3 v2.4. Windows users may find that they can't see these tags in Explorer, because Explorer can't read anything above ID3 v2.3. You might also get issues with inconsistencies between a v1 tag and a v2 tag. As you can tell, I'm passing the buck. To you.

If all this bothers you, you could try converting your tags in iTunes. And if you want to see what tags are really in your files, I recommend using KID3.

Why won't KeyFinder write to the Key tag in my MP4 files (or "why does the Key Tag column say N/A")?

Because your mp4 files don't have a Key tag; iTunes metadata objects don't support it. The Key tag is quite limited anyway, as it only has space for three characters. I recommend using Grouping (if you're a Serato user) or Comment (if you're a Traktor user). They are supported by more formats and are visible in iTunes.

Clone this wiki locally