Add-on:Audio Profiles

From Official Kodi Wiki
Revision as of 03:08, 26 April 2020 by Addonbot (talk | contribs) (Addon-Bot repo category update)
Jump to navigation Jump to search

Audio Profiles
icon.png

See this add-on on the kodi.tv showcase

Author: Regss

Type: Program
Repo: Kodi.tv repo v20
Kodi.tv repo v19

License: GPL v3.0
Source: Source code
Summary: Save audio profile and easily switch between them
Home icon grey.png   ▶ Add-ons ▶ Audio Profiles
Attention talk.png Need help with this add-on? See here.

To map a key for switch audio profile edit keymap xml file and add:
RunScript(script.audio.profiles,0) - for switch profile in loop
RunScript(script.audio.profiles,x) - where x is number of profile

Installing

This add-on is installed from the Add-on browser located in Kodi as follows:

  1. Settings
  2. Add-ons
  3. Install from repository
  4. Program Add-ons
  5. Audio Profiles
  6. Install

Features

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 four different profiles 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 show a dialog box to select an audio profile any time Kodi starts playing a media file
  • option to automatically select a profile based on media playing
  • option to load a profile when Kodi starts

How to use this addon

Configuration

By default two of the four 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.

Saving Profiles

Audio Profiles saves the options from a handful of areas within the Kodi settings. Those are:

  • System/Audio
  • 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.

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.

Addon settings

Profiles

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)
Send HDMI-CEC command when profile activated: (default None)
If set to something other than None, sends the selected HDMI-CEC command when profile 1 is activated (Toggle State, Standby, or Wakeup)

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)
Send HDMI-CEC command when profile activated: (default None)
If set to something other than None, sends the selected HDMI-CEC command when profile 2 is activated (Toggle State, Standby, or Wakeup)

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)
Send HDMI-CEC command when profile activated: (default None)
If set to something other than None, sends the selected HDMI-CEC command when profile 3 is activated (Toggle State, Standby, or Wakeup)

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)
Send HDMI-CEC command when profile activated: (default None)
If set to something other than None, sends the selected HDMI-CEC command when profile 4 is activated (Toggle State, Standby, or Wakeup)

Settings

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.
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

Notifications: (default True)
By default, any time a profile is changed Kodi will display a notification indicating which profile just became active. Turn this off to disable that behavior.

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.

Getting help

If you need assistance using Audio Profiles, please see the support thread on the Kodi forums.

https://forum.kodi.tv/showthread.php?tid=353852

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.