# Preferences - Audio Files - Roon Settings

Roon integration requires quite a few modifications to the audio settings. The biggest issue is Roon's handling of the credits or roles metadata kept in the Involved People and Musician Credits fields. Roon has thousands of predefined roles and will only recognize those roles. Further, it does not differentiate between Involved People and Musician Credits.

The Combined Credits Editor can be used to sanitize credits so that they are palatable for Roon. However, the metadata must be encoded appropriately in the audio files. The ID3, MPEG-4 and FLAC audio setting panels each have a setting called Use Roon encoding for Involved People and Musician Credits. When this setting is checked, the reading and writing of credits operates differently. Yate will make every attempt to keep credits in the section in which they were entered or in the section designated in the Combined Credits Editor. If you do not have this setting enabled, none of your credits will display in Roon. When set there are audio specific changes made:

ID3
  Roon known credits are saved to a TXXX frame named PERSONNEL. The standard ID3 frames are still used when writing non Roon credits. When the files are read, PERSONNEL and the standard frames are processed to hopefully recreate what was initially specified.
FLAC
  Roon known credits are saved to a PERSONNEL comment. Non Roon credits are saved to whatever the default write mappings are for Involved People and Musician Credits. All mappings associated with Involved People, Musician Credits and PERSONNEL are read. You should not create mappings for PERSONNEL as this is done out of bounds of the mapping system. The Keep Involved People List items in Involved People mapping option is effectively off when this option is set.
MPEG-4
  Roon known credits are saved to a PERSONNEL ---- atom as opposed to Yate's standard mappings. All relevant mappings are read.

In order for the Use Roon encoding for Involved People and Musician Credits option to take effect, files must be saved with the option on.

I've changed my mind, how do I get my credits back to normal? Each Use Roon encoding for Involved People and Musician Credits setting is followed by a Read only setting. If you enable the Read only option, Roon formatted credits will be read correctly when a file is loaded. However, Yate standard encodings will take place when the files are written. Once again, you'll have to save the files for anything to change.

There are three other non standard credit associations, that we've encountered.

The first is that Roon always expects the Original Release Time in a UDTI named ORIGINALRELEASEDATE. You must make the following changes in order to have the metadata associated with the Original Release Date field:

ID3
  You must set the Use Roon Mapping for Original Release Time time option on the Preferences-Audio-ID3 panel. Note that this option also has an associated Read only option in case you want to restore your metadata to the non Roon association.
FLAC
  You must manually map Original Release Time to ORIGINALRELEASEDATE or ORIGINALDATE in Preferences-FLAC Mappings and use the 1 button to make it the default write mapping. Depending on when you first installed Yate, one of the previous mappings may not be the default. Note that this change is not automatically made if you use the Roon application preset.
MPEG-4
  Same method as with ID3

The second exception is in the detection of Remixer metadata in ID3 based files. Roon does not see the common use mapping but reads a REMIXER UDTI instead. If you want to use the Remixer field you have to set the Use Roon mapping for Remixer option .... which also has an associated Read only option.

The third exception is in the detection of Lyricist metadata in ID3 based files. Roon does not see the common use mapping but reads a LYRICIST UDTI instead. If you want to use the Lyricist field you have to set the Use Roon mapping for Lyricist option .... which also has an associated Read only option.

With the exception of the FLAC mapping of Original Release Time to ORIGINALRELEASETIME, all previously discussed Roon settings can be made by selecting Roon from the application preset control on the Preferences-Audio-Common panel.