21 Aug 2020 - The wiki is undergoing a major cleanup. If you arrived here from a search engine and cannot find the page, please use the wiki search instead (top right corner of page)
More info can be found on the forum
|Need help with this add-on? See here.|
Save audio profile and easily switch between them.
To install this add-on you must do so from the Add-on manager from within Kodi by going to
- The home screen
- Program Add-ons
- Audio Profiles
Audio Profiles is a Kodi addon to help you easily switch between certain audio and video settings in Kodi. Version 1.2 is the last version available for Kodi 17 and earlier. Version 1.42 or later is required for proper functioning on Kodi 18 or later.
- save up to ten different profiles (four for versions before 2.x) that include the settings from System/Audio, System/Display (optional), Player/Videos (optional), and the Kodi volume.
- send an HDMI-CEC command when a profile is activated (Toggle State, Standby, or Wakeup)
- switch between profiles using different keymaps for each profile
- rotate through profiles using a single keymap
- select a profile using a pop up dialog box
- option to automatically select a profile based on media playing
- option to auto switch based on codec kind and channel count (for videos only)
- option to load a profile when Kodi starts
- popup menu has skin specific look and feel for Ace2, Aeon MQ8, Aeon Nox Silvo, Aeon Tajo, Amber, AppTV, Aura, Arctic Horizon, Arctic Zephyr2Bello 7, Box, Confluence, Embuary, Eminence, Estuary, fTV, Pellucid, Quartz, Rapier, Revolve, Transparency, Unity, and Xperience1080
3 How to use this addon
By default two of the ten available profiles are enabled and named Digital (profile 1) and Analog (profile 2). From the settings (see below for details on the settings) you can rename the profiles and configure the other settings.
3.2 Saving Profiles
Audio Profiles saves the options from a handful of areas within the Kodi settings. Those are:
- System/Display (always saved, only changed on profile change if enabled in settings)
- Player/Videos (always saved, only changed on profile change if enabled in settings)
- Kodi system volume (always saved, only changed on profile change if enabled in settings)
Once you have configured those areas they way you want, go to the Audio Profiles addon and run it. A dialog box will pop up asking you to select a profile in which to save the settings. After saving the settings, make the changes you want to the Kodi settings, and run the addon again to save to another profile. You may save up to four profiles. If you ever want to make changes to a profile, load it (see usage below on how to change profiles), make your changes, and then run the addon to select the profile you want to update.
3.3 Switching Profiles Using Keymaps
You can assign keys and remote buttons in Kodi using keymaps. For more information on keymaps (including how to create them and where to store them), please see the Kodi wiki page on keymaps. You assign a key to run a particular Kodi function that will either select a profile, pop up a dialog box for you to pick, or rotate through your profiles. You don't need to have a keymap for every option, just the ones you want to use. Here's an example of all those options for reference where each action is mapped to a function key:
<keymap> <global> <keyboard> <F1>RunScript(script.audio.profiles,1)</F1> <!-- switches to profile 1 --> <F2>RunScript(script.audio.profiles,2)</F2> <!-- switches to profile 2 --> <F3>RunScript(script.audio.profiles,3)</F3> <!-- switches to profile 3 --> <F4>RunScript(script.audio.profiles,4)</F4> <!-- switches to profile 4 --> <F5>RunScript(script.audio.profiles,popup)</F5> <!-- displays a dialog for you to pick a profile --> <F6>RunScript(script.audio.profiles,0)</F6> <!-- rotates through the profiles --> </keyboard> </global> </keymap>
You will need to restart Kodi for the new keymaps to be active.
4 Addon settings
Profile 1: (default True)
Toggle this option to turn profile 1 on or off. Profile 2 is on by default.
Name of Profile 1: (default Digital)
The name for profile 1 (shown in the popup menus and notifications)
Profile 2: (default True)
Toggle this option to turn profile 2 on or off. Profile 2 is on by default.
Name of Profile 2: (default Analog)
The name for profile 2 (shown in the popup menus and notifications)
Profile 3: (default False)
Toggle this option to turn profile 3 on or off. Profile 3 is off by default.
Name of Profile 3: (default Headphones)
The name for profile 3 (shown in the popup menus and notifications)
Profile 4: (default False)
Toggle this option to turn profile 4 on or off. Profile 4 is off by default.
Name of Profile 4: (default HDMI)
The name for profile 4 (shown in the popup menus and notifications)
Profiles 5 - 10: (default False)
Toggle this option to individually turn profiles 5 - 10 on or off. Profiles 5 - 10 are off by default.
Name of Profiles 5 - 10: (default Profile X)
The name for profiles 5 - 10 (shown in the popup menus and notifications)
Profile X (default None)
If set to something other than None, sends the selected HDMI-CEC command when the specified profile is activated (Toggle State, Standby, or Wakeup)
4.3 Auto Switch
All the settings in this section allow you to decide what to do if a particular type of media is detected. All settings have the following options: None, Profile 1 - 10, and Select menu. If you select a profile, that profile will be activated automatically. If you pick Select Menu the select menu will pop up for that media type. The music media type also has an option to assign any stream with no codec details the profile used for music.
4.4 Codec Detection
All the settings in this section allow you to decide what to do if a particular type of codec or number of channels are detected. All settings have the following options: None, Profile 1 - 10, and Select menu. If you select a profile, that profile will be activated automatically. If you pick Select Menu the select menu will pop up for that media type. There is one additional setting:
delay before reading codec information (default 5)
The number of seconds the addon waits before asking Kodi for the codec information. Especially with streams, it can take a little time for Kodi to have the information needed.
Include volume level (default False)
if activated, all profiles will save and change the Kodi system volume level when profiles are activated.
Include video player settings (default False)
If activated, all profiles will save and change the settings in the Kodi settings area Player/Videos.
Include display settings (default False)
If active, all profiles will save and change the settings in the Kodi settings area System/Display.
Show audio stream select menu on start playing (default False)
If activated, any time Kodi starts playing any media file a dialog box will popup so you can select the profile you want to use.
Profile for Kodi Startup/Wake (default None)
The profile to load when Kodi starts.
Force load profile at startup (default False)
If True, the profile loads at startup even if it was selected at shutdown. Useful for resetting the volume level.
Use custom select menu (default True)
If True, the addon will attempt to use a skin specific menu (if available).
Include skin mods (default True)
If True, the addon will treat skin mods as if they are the original skin and show the custom menu. So, for instance, skin.estuary and skin.estuary.mod would both use the custom menu for Estuary.
Auto close select menu (default False)
If activated, the menu will disappear after a certain amount of time (see next setting below). Please note that if you stop playing media, the dialog box will close immediately.
Delay before close (default 10 seconds)
If the auto close option is activated, Kodi will wait this many seconds before closing the dialog box automatically. You may select between 5 and 30 seconds.
Notifications: (default True)
If True, the notifications enabled below will be displayed.
Delay before close (default 5)
The number of seconds the notification will show. Auto switch notifications (default True)
If True, notifications each time a profile is automatically changed will be shown.
Manual switch notifications (default True)
If True, notifications each time a profile is changed via the select menu will be shown.
Maintenance notifications (default True)
If True, notifications about saving profiles will be shown.
Enable debug logging (default False)
When enabled, if you have Kodi logging set to DEBUG you will get a very verbose set of information in your log file. You should only need to activate this when troubleshooting issues.
5 Getting help
If you need assistance using Audio Profiles, please see the support thread on the Kodi forums.
6 Beta Testing
If you are interested in beta testing new versions of this add on (or just like being on the bleeding edge of up to date), you can install beta versions (Leia or later, there will be no more updates for earlier versions) from my addon beta repository - either Kodi 18 (Leia) or Kodi 19 (Matrix) and later (these are zip downloads). You can also monitor the support thread, as links to particular beta releases will be available there as well.