Difference between revisions of "Add-on:Audio Profiles"

From Official Kodi Wiki
Jump to: navigation, search
(How to use this addon)
(Profiles)
Line 71: Line 71:
 
''Name of Profile 1:'' (default Digital)<br />
 
''Name of Profile 1:'' (default Digital)<br />
 
The name for profile 1 (shown in the popup menus and notifications)<br />
 
The name for profile 1 (shown in the popup menus and notifications)<br />
''Send HDMI-CEC command when profile activated:'' (default None)<br />
 
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)<br />
 
'''Profile 2:''' (default True)<br />
Line 78: Line 76:
 
''Name of Profile 2:'' (default Analog)<br />
 
''Name of Profile 2:'' (default Analog)<br />
 
The name for profile 2 (shown in the popup menus and notifications)<br />
 
The name for profile 2 (shown in the popup menus and notifications)<br />
''Send HDMI-CEC command when profile activated:'' (default None)<br />
 
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)<br />
 
'''Profile 3:''' (default False)<br />
Line 85: Line 81:
 
''Name of Profile 3:'' (default Headphones)<br />
 
''Name of Profile 3:'' (default Headphones)<br />
 
The name for profile 3 (shown in the popup menus and notifications)<br />
 
The name for profile 3 (shown in the popup menus and notifications)<br />
''Send HDMI-CEC command when profile activated:'' (default None)<br />
 
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)<br />
 
'''Profile 4:''' (default False)<br />
Line 92: Line 86:
 
''Name of Profile 4:'' (default HDMI)<br />
 
''Name of Profile 4:'' (default HDMI)<br />
 
The name for profile 4 (shown in the popup menus and notifications)<br />
 
The name for profile 4 (shown in the popup menus and notifications)<br />
''Send HDMI-CEC command when profile activated:'' (default None)<br />
+
 
If set to something other than None, sends the selected HDMI-CEC command when profile 4 is activated (Toggle State, Standby, or Wakeup)
+
'''Profiles 5 - 10:''' (default False)<br />
 +
Toggle this option to individually turn profiles 5 - 10 on or off.  Profiles 5 - 10 are off by default.<br />
 +
''Name of Profiles 5 - 10:'' (default Profile X)<br />
 +
The name for profiles 5 - 10 (shown in the popup menus and notifications)<br />
  
 
=== Settings ===
 
=== Settings ===

Revision as of 23:27, 2 June 2020

Audio Profiles

See this add-on on the kodi.tv showcase

Author: pkscout, notoco, Regss
Website: link
Type: Program
Repo: Kodi.tv repo v19
Kodi.tv repo v18
Kodi.tv repo v17

License: GPL-3.0-only
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.

Save audio profile and easily switch between them.

1 Installing

To install this add-on you must do so from the Add-on manager from within Kodi by going to

  1. The home screen
  2. Add-ons
  3. Download
  4. Program Add-ons
  5. Audio Profiles
  6. Install

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

3.1 Configuration

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

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

4.1 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)

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)

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

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

5 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

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.