# Key Wheel doesnt work (or i dont know how to use)

**URL:** <https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006>\
**Category:** MusicBrainz Picard\
**Created:** [March 8, 2025, 2:13pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006 "2025-03-08T14:13:18Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![Dino\_RTX](https://community.metabrainz.org/letter_avatar_proxy/v4/letter/d/3bc359/32.png) [@Dino\_RTX](https://community.metabrainz.org/u/Dino_RTX)\
**Post date:** [March 8, 2025, 2:13pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/1 "2025-03-08T14:13:18Z")

</div>

HI, recently i downloaded the key wheel plugin but i dont see any changes/menu in picard, it doesnt work? Where is a menu? How to use? i dont find any info in any site

---

<div class="post-metadata">

**Author:** ![outsidecontext](https://community.metabrainz.org/user_avatar/community.metabrainz.org/outsidecontext/32/90_2.png) [@outsidecontext](https://community.metabrainz.org/u/outsidecontext)\
**Post date:** [March 8, 2025, 2:42pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/2 "2025-03-08T14:42:49Z")

</div>

The plugin adds various scripting functions that can be used in tagger scripts to convert between different notations for the musical key. There are 4 functions, `$key2camelot`, `$key2openkey`, `$key2standard` and `$key2traktor`.

E.g. you can use `$key2standard(1A)` and it will return “A-Flat Minor”.

If you click on “Documentation” in Options \> Scripting you will find documentation for all scripting functions, including the ones from the plugin. I have pasted the documentation below.

* * *

## `$key2camelot(key)`

Returns the key string key in camelot key format.

The key argument can be entered in any of the supported formats, such as ‘2B’ (camelot), ‘6d’ (open key), ‘A♭ Minor’ (standard with symbols), ‘A-Flat Minor’ (standard with text) or ‘C#’ (traktor). If the key argument is not recognized as one of the standard keys in the supported formats, then an empty string will be returned.

## `$key2openkey(key)`

Returns the key string key in open key format.

The key argument can be entered in any of the supported formats, such as ‘2B’ (camelot), ‘6d’ (open key), ‘A♭ Minor’ (standard with symbols), ‘A-Flat Minor’ (standard with text) or ‘C#’ (traktor). If the key argument is not recognized as one of the standard keys in the supported formats, then an empty string will be returned.

## `$key2standard(key[,symbols])`

Returns the key string key in standard key format. If the optional argument symbols is set, then the ‘♭’ and ‘#’ symbols will be used, rather than spelling out ‘-Flat’ and ‘-Sharp’.

The key argument can be entered in any of the supported formats, such as ‘2B’ (camelot), ‘6d’ (open key), ‘A♭ Minor’ (standard with symbols), ‘A-Flat Minor’ (standard with text) or ‘C#’ (traktor). If the key argument is not recognized as one of the standard keys in the supported formats, then an empty string will be returned.

## `$key2traktor(key)`

Returns the key string key in traktor key format.

The key argument can be entered in any of the supported formats, such as ‘2B’ (camelot), ‘6d’ (open key), ‘A♭ Minor’ (standard with symbols), ‘A-Flat Minor’ (standard with text) or ‘C#’ (traktor). If the key argument is not recognized as one of the standard keys in the supported formats, then an empty string will be returned.

---

<div class="post-metadata">

**Author:** ![Dino\_RTX](https://community.metabrainz.org/letter_avatar_proxy/v4/letter/d/3bc359/32.png) [@Dino\_RTX](https://community.metabrainz.org/u/Dino_RTX)\
**Post date:** [March 8, 2025, 3:09pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/3 "2025-03-08T15:09:20Z")

</div>

last question, if I want for example to convert all keys to camelot, I have to put $key2camelot(key) in the scripts and that’s it?  
edit: i tried with $set(key,$if2($key2camelot(%key%),%key%)) but with this the keys who have a # dont change

---

<div class="post-metadata">

**Author:** ![rdswift](https://community.metabrainz.org/user_avatar/community.metabrainz.org/rdswift/32/7032_2.png) [@rdswift](https://community.metabrainz.org/u/rdswift)\
**Post date:** [March 8, 2025, 5:22pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/4 "2025-03-08T17:22:53Z")

</div>

Sounds like the existing keys use a symbol other than a standard octothorpe. When I wrote that plugin, I only checked for a standard octothorpe. Can you check and let us know the ASCII or UTF value of the sharp symbol that is not being converted?

---

<div class="post-metadata">

**Author:** ![Dino\_RTX](https://community.metabrainz.org/letter_avatar_proxy/v4/letter/d/3bc359/32.png) [@Dino\_RTX](https://community.metabrainz.org/u/Dino_RTX)\
**Post date:** [March 8, 2025, 5:28pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/5 "2025-03-08T17:28:10Z")

</div>

ascii: 35  
there is the acousticbrainz #

---

<div class="post-metadata">

**Author:** ![rdswift](https://community.metabrainz.org/user_avatar/community.metabrainz.org/rdswift/32/7032_2.png) [@rdswift](https://community.metabrainz.org/u/rdswift)\
**Post date:** [March 8, 2025, 7:44pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/6 "2025-03-08T19:44:50Z")

</div>

I think I may have found the problem. Can you please share the key value that isn’t being converted so that I can confirm my finding? Thanks.

---

<div class="post-metadata">

**Author:** ![Dino\_RTX](https://community.metabrainz.org/letter_avatar_proxy/v4/letter/d/3bc359/32.png) [@Dino\_RTX](https://community.metabrainz.org/u/Dino_RTX)\
**Post date:** [March 8, 2025, 7:59pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/7 "2025-03-08T19:59:16Z")

</div>

All keys with # (A#, C#, C#m, D#, G#m & A#m for now)

---

<div class="post-metadata">

**Author:** ![rdswift](https://community.metabrainz.org/user_avatar/community.metabrainz.org/rdswift/32/7032_2.png) [@rdswift](https://community.metabrainz.org/u/rdswift)\
**Post date:** [March 8, 2025, 9:14pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/8 "2025-03-08T21:14:06Z")

</div>

I think that I have now corrected the processing in the plugin. I will submit the changes to the official Picard Plugins repository, but until that happens and is processed, you can download the updated plugin from [my repository on GitHub](https://github.com/rdswift/picard-plugins/tree/2.0_RDS_Plugins/plugins/key_wheel_converter). If you give this a try, please let me know if it fixes the problem for you. Thanks.

---

<div class="post-metadata">

**Author:** ![Dino\_RTX](https://community.metabrainz.org/letter_avatar_proxy/v4/letter/d/3bc359/32.png) [@Dino\_RTX](https://community.metabrainz.org/u/Dino_RTX)\
**Post date:** [March 9, 2025, 3:15pm UTC](https://community.metabrainz.org/t/key-wheel-doesnt-work-or-i-dont-know-how-to-use/748006/9 "2025-03-09T15:15:18Z")

</div>

now its work fine, thanks!
