Archive:Mac FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Fix dead links)
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{XBMC FAQ}}
{{Kodi FAQ}}
{{mininav|[[Mac OS X]] }}
{{mininav|[[Mac OS X]] }}
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Mac OS X and Mac hardware.<section end="intro" />
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for OS X and Mac hardware from Apple.<section end="intro" />


__TOC__
__TOC__
{{-}}
{{-}}
== General FAQ ==
== General FAQ ==
:<big>''See also: '''[[XBMC all platforms FAQ]]''' for FAQs that apply to all versions of XBMC.''</big>
:<big>''See also: '''[[Kodi all platforms FAQ]]''' for FAQs that apply to all versions of Kodi.''</big>


{| width="100%"
{| width="100%"
Line 18: Line 18:
{{FAQ|1=install|2=update
{{FAQ|1=install|2=update
| BGcolor= WhiteSmoke
| BGcolor= WhiteSmoke
| Question= How to install and/or update XBMC
| Question= How to install and/or update Kodi
| Answer=
| Answer=
{{main|HOW-TO:Install XBMC for Mac}}
{{main|HOW-TO:Install Kodi for OS X}}
* Simply download XBMC from http://xbmc.org/downloads/ and copy XBMC.app to your Applications folder to install XBMC
* Simply download Kodi from http://kodi.tv/downloads/ and copy Kodi.app to your Applications folder to install Kodi
* Do the same to update XBMC. All your settings and files will be preserved as they are located in a different place in the [[userdata folder]]. Be sure to make a backup of the [[userdata folder]] when doing updates in case something goes wrong.
* Do the same to update Kodi. All your settings and files will be preserved as they are located in a different place in the [[userdata folder]]. Be sure to make a backup of the [[userdata folder]] when doing updates in case something goes wrong.
* If you have OS X 10.8 or higher, you may need to bypass the Gatekeeper settings to install XBMC: See '''[[HOW-TO:Install XBMC for Mac#Gatekeeper|Gatekeeper]]'''
* If you have OS X 10.8 or higher, you may need to bypass the Gatekeeper settings to install Kodi: See '''[[HOW-TO:Install Kodi for OS X#Gatekeeper|Gatekeeper]]'''
}}
}}


{{FAQ|1=Release_version|2=Version
{{FAQ|1=Release_version|2=Version
| BGcolor=  
| BGcolor=  
| Question= XBMC for Mac version
| Question= Kodi for OS X version
| Answer=
| Answer=
* The current stable version of XBMC for Mac is {{Current version}}. This is the same code that all of the other platforms (Linux, iOS, Windows) are using.}}
* The current stable version of Kodi for Mac is {{Current version}}. This is the same code that all of the other platforms (Linux, iOS, Windows) are using.}}


{{FAQ|1=Current_build|2=XBMC_Version
{{FAQ|1=Current_build|2=Kodi_Version|3=XBMC_Version
| BGcolor= WhiteSmoke
| BGcolor= WhiteSmoke
| Question= What version/nightly build/beta of XBMC am I running?
| Question= What version/nightly build/beta of Kodi am I running?
| Answer=
| Answer=
* XBMC main menu > System > Lower submenu > System info. '''Note the build date.'''
* Kodi main menu > System > Lower submenu > System info. '''Note the build date.'''
}}
}}


{{FAQ|1=Tools
{{FAQ|1=Tools
| BGcolor=  
| BGcolor=  
| Question= Programs and tools to help with XBMC
| Question= Programs and tools to help with Kodi
| Answer=
| Answer=
* For a list of programs and tools to help with XBMC, such as renaming files, managing media, file sharing, and more, see '''[[Supplemental tools/Mac OS X]]'''
* For a list of programs and tools to help with Kodi, such as renaming files, managing media, file sharing, and more, see '''[[Supplemental tools/Mac OS X]]'''
}}
}}


Line 52: Line 52:
{{FAQ|1=remotes
{{FAQ|1=remotes
| BGcolor=
| BGcolor=
| Question=What remotes can be used with XBMC
| Question=What remotes can be used with Kodi
| Answer=
| Answer=
* '''[[Apple Remote]]''' (both white and silver version)
* '''[[Apple Remote]]''' (both white and silver version)
Line 58: Line 58:
** '''How do I bring up the OSD during playback?''' - Press and hold SELECT
** '''How do I bring up the OSD during playback?''' - Press and hold SELECT
* '''Logitech Harmony''' remotes can be used. See [[#Harmony]]
* '''Logitech Harmony''' remotes can be used. See [[#Harmony]]
* Any '''[[Keyboard]]''' such as wired, wireless, bluetooth. This includes "keymotes" such as the [[Rii]] or [[Boxee remote]].
* Any '''[[Keyboard]]''' such as wired, wireless, bluetooth. This includes "keymotes" such as the Rii or [[Boxee remote]].
* '''[[Web interface]]s''', including add-on interfaces.
* '''[[Web interface]]s''', including add-on interfaces.
* XBMC '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''.
* Kodi '''[[:Category:Smartphone and tablet remotes|smartphone and tablet remote apps]]'''.
* Other IR remotes can be used with IR receivers such as the '''[[Flirc]]'''.
* Other IR remotes can be used with IR receivers such as the '''[[Flirc]]'''.
}}
}}
Line 66: Line 66:
{{FAQ|1=Apple_remote_start
{{FAQ|1=Apple_remote_start
| BGcolor= WhiteSmoke
| BGcolor= WhiteSmoke
| Question=Starting XBMC with the Apple Remote
| Question=Starting Kodi with the Apple Remote
| Answer=
| Answer=
* The Apple Remote can be set to start XBMC instead of Front Row or iTunes.
* The Apple Remote can be set to start Kodi instead of Front Row or iTunes.
* Go to {{highlight|[[Settings/System/Input devices|Settings -> System -> Input devices]]}} and select "Allow start of XBMC using the remote".
* Go to {{highlight|[[Settings/System/Input devices|Settings -> System -> Input devices]]}} and select "Allow start of Kodi using the remote".
}}
}}


Line 76: Line 76:
| Question=Using a Logitech Harmony remote
| Question=Using a Logitech Harmony remote
| Answer=
| Answer=
* XBMC can use a Logitech Harmony remote using the normal Apple IR receiver that is built into some Macs.
* Kodi can use a Logitech Harmony remote using the normal Apple IR receiver that is built into some Macs.
* Go to {{highlight|[[Settings/System/Input devices|Settings -> System -> Input devices]]}} and change "Apple remote" to "Universal".
* Go to {{highlight|[[Settings/System/Input devices|Settings -> System -> Input devices]]}} and change "Apple remote" to "Universal".
* On the Logitech Harmony remote, select the Plex profile.
* On the Logitech Harmony remote, select the Plex profile.
Line 96: Line 96:
**# Make sure your remote is not paired in OS X under System Preferences -> Security & Privacy -> General
**# Make sure your remote is not paired in OS X under System Preferences -> Security & Privacy -> General
**# Make sure your remote is not paired in iTunes under iTunes -> Preferences -> Devices
**# Make sure your remote is not paired in iTunes under iTunes -> Preferences -> Devices
**# Make sure the remote is still able to control XBMC (with or without the volume issue)
**# Make sure the remote is still able to control Kodi (with or without the volume issue)
**# Install Candelair
**# Install Candelair
**# If needed, set the remote to either Apple or Logitech Harmony (see the [[#Harmony]] section above)
**# If needed, set the remote to either Apple or Logitech Harmony (see the [[#Harmony]] section above)
** Install this free patch: http://www.thebitguru.com/projects/iTunesPatch
** Install this free patch: http://www.thebitguru.com/projects/iTunesPatch
** Still have problems? Try this: http://forum.xbmc.org/showthread.php?tid=121137&pid=1002261#pid1002261
** Install Magic Keys : https://www.gearmusicplayer.com/extras.html
** Still have problems? Try this: http://forum.kodi.tv/showthread.php?tid=121137&pid=1002261#pid1002261
}}
}}


Line 111: Line 112:
{{FAQ|1=Help|2=Forum|3=IRC
{{FAQ|1=Help|2=Forum|3=IRC
| BGcolor=
| BGcolor=
| Question=Getting more help with XBMC for Mac OS X
| Question=Getting more help with Kodi for Mac OS X
| Answer=
| Answer=
* '''[http://forum.xbmc.org/forumdisplay.php?f=56 XBMC for Mac OS X specific help forum]'''
* '''[http://forum.kodi.tv/forumdisplay.php?f=56 Kodi for Mac OS X specific help forum]'''
* '''[irc://irc.freenode.org/xbmc-osx #xbmc]''' or '''[irc://irc.freenode.org/xbmc-osx #xbmc-osx]''' [[w:IRC|IRC]] chat channel on irc.freenode.org. You might want to try the general channel first, even if your issue is Mac specific, simply because that channel is more active.
* '''[irc://irc.freenode.org/Kodi-osx #Kodi]''' or '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
}}
}}


{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=xbmc.log
{{FAQ|1=Userdata|2=Logs|3=logs|4=debuglog|5=kodi.log
| BGcolor=WhiteSmoke
| BGcolor=WhiteSmoke
| Question= Userdata folder and logs
| Question= Userdata folder and logs
Line 123: Line 124:
:''See '''[[How-to:Submit a proper bug report]]''' for bug reporting details and '''[[forum:47124|here]]''' for instructions on reporting an issue to the forums''
:''See '''[[How-to:Submit a proper bug report]]''' for bug reporting details and '''[[forum:47124|here]]''' for instructions on reporting an issue to the forums''


* [[Userdata folder]]: {{highlight|/Users/<your_user_name>/Library/Application Support/XBMC/userdata}}
* [[Userdata folder]]: {{highlight|/Users/<your_user_name>/Library/Application Support/Kodi/userdata}}
* [[Debug log]]: {{highlight|/Users/<your_user_name>/Library/Logs/XBMC.log}}
* [[Debug log]]: {{highlight|/Users/<your_user_name>/Library/Logs/kodi.log}}
* Console log: {{highlight|/Library/Logs/Console/501/console.log}}
* Console log: {{highlight|/Library/Logs/Console/501/console.log}}
* CrashReporter:
* CrashReporter: {{highlight|/Users/<your_user_name>/Library/Logs/DiagnosticReports/}}
** OSX 10.5, 10.6 {{highlight|/Users/<your_user_name>/Library/Logs/CrashReporter/CrashReporter.log}}
** OSX 10.7, 10.8, 10.9 {{highlight|/Users/<your_user_name>/Library/Logs/DiagnosticReports/}}
}}
}}


Line 136: Line 135:
| Answer=
| Answer=
* When Mac OS X touches files that are saved on a non-Mac-formatted drive (HFS+) it will save metadata in what are often called AppleDouble files. They often show up looking like <code>._filename.ext</code> or <code>.DS_Store</code>. ''On a native Mac formatted drive (HFS+) the metadata is written in such a way that it does not create these files, which is why you don't see them there.''
* When Mac OS X touches files that are saved on a non-Mac-formatted drive (HFS+) it will save metadata in what are often called AppleDouble files. They often show up looking like <code>._filename.ext</code> or <code>.DS_Store</code>. ''On a native Mac formatted drive (HFS+) the metadata is written in such a way that it does not create these files, which is why you don't see them there.''
* Normally these files appear invisible on some computers, but will still get picked up by some programs such as XBMC.
* Normally, these files should not be visible to Kodi and they should not be scanned into the libraries. The only exception for this is if "Show hidden files" is turned on under {{highlight|bordered=yes| [[Settings/Appearance#File lists|Settings -> Appearance -> File lists -> "Show hidden files and directories"]] }}
 
 
 
* You can prevent Mac OS X from creating these files on a network share by using a program such as [http://www.bresink.com/osx/TinkerTool.html TinkerTool] or by opening Terminal.app and running the following command: <pre>defaults write com.apple.desktopservices DSDontWriteNetworkStores true</pre>
* You can prevent Mac OS X from creating these files on a network share by using a program such as [http://www.bresink.com/osx/TinkerTool.html TinkerTool] or by opening Terminal.app and running the following command: <pre>defaults write com.apple.desktopservices DSDontWriteNetworkStores true</pre>
* To remove the files you need to make them visible (again, you can use TinkerTool to make them visible, but remember to re-enable invisible files afterwards to protect certain system files) and drag them to the trash can and delete them.
* To remove existing appledouble files you need to make them visible (again, you can use TinkerTool to make them visible, but remember to re-enable invisible files afterwards to protect certain system files) and drag them to the trash can and delete them.
}}
}}


Line 152: Line 154:
| Question=Add-ons downloaded from the internet are not in zip format or will not install
| Question=Add-ons downloaded from the internet are not in zip format or will not install
| Answer=
| Answer=
* There are two main possibilities for an add-on to not install when you use "Install from zip". One is that it isn't in a proper zip format, the other is that the add-on is for an older version of XBMC that isn't compatible with the version you are using.
* There are two main possibilities for an add-on to not install when you use "Install from zip". One is that it isn't in a proper zip format, the other is that the add-on is for an older version of Kodi that isn't compatible with the version you are using.
* Very commonly the Safari web browser is being used to download these add-ons, and by default will unzip the files leaving you with a folder that won't work with the "Install from zip" option. You can turn this feature off by going into Safari's preferences, under "General" and unchecking "Open 'safe' files after downloading". If you wish to keep this feature on, you should be able to find the original zip file in the Trash can. Just drag the file out and use it instead of the folder for "Install from zip".
* Very commonly the Safari web browser is being used to download these add-ons, and by default will unzip the files leaving you with a folder that won't work with the "Install from zip" option. You can turn this feature off by going into Safari's preferences, under "General" and unchecking "Open 'safe' files after downloading". If you wish to keep this feature on, you should be able to find the original zip file in the Trash can. Just drag the file out and use it instead of the folder for "Install from zip".
* Sometimes you need to build zip plugin from directory. Almost all ZIP programs on OSX create zip file, which is not compatible with KODI. If you want to create compatible plugin, you can use "zip" program from terminal, usage
<pre>zip -r plugin.name.zip plugin.directory/</pre> or you can download [http://www.yellowmug.com/yemuzip/ YemuZip] and be sure you choose "Type: PC" while creating ZIP file.
}}
}}


Line 160: Line 164:
| Question= Can't see UPnP sources/servers
| Question= Can't see UPnP sources/servers
| Answer=
| Answer=
* See If you are unable to see [[UPnP/Media source|UPnP sources or servers]] inside of XBMC it could be due to a conflicting UPnP service running on your Mac or network. One known conflicting server is EyeTV, which runs a UPnP server in the background, even if EyeTV itself is not running. Uninstalling EyeTV or forcing all EyeTV processes to quit in Activity Monitor should fix the issue.
* See If you are unable to see [[UPnP/Media source|UPnP sources or servers]] inside of Kodi it could be due to a conflicting UPnP service running on your Mac or network. One known conflicting server is EyeTV, which runs a UPnP server in the background, even if EyeTV itself is not running. Uninstalling EyeTV or forcing all EyeTV processes to quit in Activity Monitor should fix the issue.
}}
}}


Line 174: Line 178:
:* Select the correct audio output device for analog and passthrough.
:* Select the correct audio output device for analog and passthrough.
{{#lst:Frodo issues|Mac audio}}
{{#lst:Frodo issues|Mac audio}}
* Not actually an issue with XBMC: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.
* Not actually an issue with Kodi: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.
}}
}}


Line 181: Line 185:
| Question= Why does setting the output for 2.0 sound work better for 5.1 sound?
| Question= Why does setting the output for 2.0 sound work better for 5.1 sound?
| Answer=  
| Answer=  
2.0 is the number of channels we are opening in the device. For all passed through audio like DTS and AC3 we need 2 channels (as those 5.1 channels are encoded into 2.0 pcm channels). Setting the speakerlayout higher results in the activation of LPCM. LPCM means XBMC decodes all channels from the 2.0 encoded DTS, AC3 sound (resulting in 6 channels for 5.1) - remaps them according to the audio device and then puts them out as 6 pcm channels (this is 3 times more data then the 2.0 encoded channels from DTS, AC3 passthrough).
2.0 is the number of channels we are opening in the device. For all passed through audio like DTS and AC3 we need 2 channels (as those 5.1 channels are encoded into 2.0 pcm channels). Setting the speakerlayout higher results in the activation of LPCM. LPCM means Kodi decodes all channels from the 2.0 encoded DTS, AC3 sound (resulting in 6 channels for 5.1) - remaps them according to the audio device and then puts them out as 6 pcm channels (this is 3 times more data then the 2.0 encoded channels from DTS, AC3 passthrough).


Since we have issues with mapping the channels from input format 5.1 to device format 5.1 atm - this may result in silence instead of audio.
Since we have issues with mapping the channels from input format 5.1 to device format 5.1 atm - this may result in silence instead of audio.
Line 192: Line 196:
Go into {{highlight|bordered=yes|[[Settings/System#Audio output|Settings -> System -> Audio output]]}} and select '''Fixed''' and '''44.1''' on the settings.  
Go into {{highlight|bordered=yes|[[Settings/System#Audio output|Settings -> System -> Audio output]]}} and select '''Fixed''' and '''44.1''' on the settings.  
}}
}}
=== Some screensavers are missing ===
: Due to a lack of manpower for OS X devs, "rsxs" screensavers were dropped from Kodi for Mac OS X. "rsxs" screensavers are still supported on other platforms. See '''[http://forum.kodi.tv/showthread.php?tid=262990 here]''' for more info.


|}
|}
Line 201: Line 208:
| Question=SMB (Windows Sharing) isn't working when sharing files
| Question=SMB (Windows Sharing) isn't working when sharing files
| Answer=
| Answer=
* Update to XBMC v12.1 or higher for compatibility with the new SMB server in OS X 10.7 (and up).
* See '''[[SMB/Mac]]''' for tips. Sometimes Apple changes things with SMB sharing and additional steps are needed.
}}
}}


Line 208: Line 215:
| Question=Userdata folder and logs are hidden
| Question=Userdata folder and logs are hidden
| Answer=
| Answer=
* By default, Mac OS X 10.7 hides the user's Library folder, which is where XBMC's userdata folder and logs are stored. There are a few ways to get around this:
* By default, Mac OS X 10.7 hides the user's Library folder, which is where Kodi's userdata folder and logs are stored. There are a few ways to get around this:
** While in the Finder, click on the "Go" menu and hold down {{keypress|Option}}, then select Library.
** While in the Finder, click on the "Go" menu and hold down {{keypress|Option}}, then select Library.
** You can use programs such as TinkerTool to change the visibility of all or some hidden files/folders.
** You can use programs such as TinkerTool to change the visibility of all or some hidden files/folders.
Line 228: Line 235:
| Question= Strange sound when movie is paused after updating to 10.7.4
| Question= Strange sound when movie is paused after updating to 10.7.4
| Answer=
| Answer=
* Are you getting strange sounds when you pause some movies after updating Mac OS X to 10.7.4? Apple changed some OS-level code that has affected several programs, including XBMC, Plex, ProTools, and others. It has been reported that upgraded Mac OS X to 10.7.5 or 10.8 (Mountain Lion) fixes this problem. For more info see this forum post: [[Forum:131305]].   
* Are you getting strange sounds when you pause some movies after updating Mac OS X to 10.7.4? Apple changed some OS-level code that has affected several programs, including Kodi, Plex, ProTools, and others. It has been reported that upgraded Mac OS X to 10.7.5 or 10.8 (Mountain Lion) fixes this problem. For more info see this forum post: [[Forum:131305]].   
}}
}}


Line 237: Line 244:
{{FAQ|1= Gatekeeper
{{FAQ|1= Gatekeeper
| BGcolor=  
| BGcolor=  
| Question= Gatekeeper prevents XBMC from installing ("XBMC" can’t be opened because it is from an unidentified developer)
| Question= Gatekeeper prevents Kodi from installing ("Kodi" can’t be opened because it is from an unidentified developer)
| Answer=
| Answer=
{{main|HOW-TO:Install XBMC for Mac#Gatekeeper}}
{{main|HOW-TO:Install Kodi for Mac#Gatekeeper}}
{{#lst:HOW-TO:Install XBMC for Mac|Gatekeeper}}
{{#lst:HOW-TO:Install Kodi for Mac|Gatekeeper}}
}}
}}


Line 246: Line 253:


== Mac OS X 10.9 (Mavericks) ==
== Mac OS X 10.9 (Mavericks) ==
{| width="100%"
{{FAQ|1=Crash on start|2=crash_10.9
| BGcolor=
| Question=XBMC crashes on 10.9
| Answer=
* XBMC 12.2 has an audio bug that prevents it from starting up on Mac OS X 10.9. Update to XBMC v12.3 or newer to fix the issue.
}}
{| width="100%"
{| width="100%"
{{FAQ|1=other_10.9
{{FAQ|1=other_10.9
Line 260: Line 259:
| Answer=
| Answer=
* '''Stuttering video-''' Some users have had issues with stuttering video, possibly related to the AppNap feature.
* '''Stuttering video-''' Some users have had issues with stuttering video, possibly related to the AppNap feature.
* '''Possible issue with auto-switching GPUs on some Macbook Pros-''' There seems to be an issue with some Macbook Pros that have auto-switching GPUs that cause XBMC to start up with only 16k colors and/or low resolution. Switching in and out of windowed mode seems to work as a temp workaround (press {{keypress|\}} on a keyboard).
* '''Possible issue with auto-switching GPUs on some Macbook Pros-''' There seems to be an issue with some Macbook Pros that have auto-switching GPUs that cause Kodi to start up with only 16k colors and/or low resolution. Switching in and out of windowed mode seems to work as a temp workaround (press {{keypress|\}} on a keyboard).
* '''Crash when starting XBMC with external monitor-''' XBMC might crash when there is an external/second monitor connected (laptops only?) and not in mirroring mode. This will be fixed in the 12.3 bugfix release and has been fixed in [[nightly builds]].
* '''Crash when starting Kodi with external monitor-''' Kodi might crash when there is an external/second monitor connected (laptops only?) and not in mirroring mode. This will be fixed in the 12.3 bugfix release and has been fixed in [[nightly builds]].
* '''SMB/SAMBA/Windows sharing sharing from Mac OS X 10.9-''' Not really an XBMC issue, but XBMC clients connecting to a Mac OS X 10.9 SMB/SAMBA/Windows-sharing file server might have compatibility issues again. [[SMBUp]] can be used as a workaround.
* '''SMB/SAMBA/Windows sharing sharing from Mac OS X 10.9-''' Not really an Kodi issue, but Kodi clients connecting to a Mac OS X 10.9 SMB/SAMBA/Windows-sharing file server might have compatibility issues again. [[SMBUp]] can be used as a workaround.
* '''IR Apple remote is unresponsive-''' The "App Nap" feature in OS X 10.9 might cause lag and delays when using the white or silver Apple IR remote control. A temp work around would be to disable "App Nap" in OS X.
* '''IR Apple remote is unresponsive-''' The "App Nap" feature in OS X 10.9 might cause lag and delays when using the white or silver Apple IR remote control. A temp work around would be to disable "App Nap" in OS X.
}}
}}


|}
|}
{{frodo updated}}
 
 
{{Isengard updated}}


[[Category:Manual]]
[[Category:Manual]]

Revision as of 04:27, 7 March 2018

Template:Kodi FAQ

Home icon grey.png   ▶ Mac OS X ▶ Mac FAQ

Frequently Asked Questions for OS X and Mac hardware from Apple.


General FAQ

See also: Kodi all platforms FAQ for FAQs that apply to all versions of Kodi.

Requirements

Link
  • Kodi v17 requires Mac OS X 10.8 or later.
  • Kodi v18 (and its nightlies) will at least require 10.9)
  • Kodi v20 and above requires an Intel Mac running OS X 10.13 or higher.

How to install and/or update Kodi

Link
  • Simply download Kodi from http://kodi.tv/downloads/ and copy Kodi.app to your Applications folder to install Kodi
  • Do the same to update Kodi. All your settings and files will be preserved as they are located in a different place in the userdata folder. Be sure to make a backup of the userdata folder when doing updates in case something goes wrong.
  • If you have OS X 10.8 or higher, you may need to bypass the Gatekeeper settings to install Kodi: See Gatekeeper

Kodi for OS X version

Link
  • The current stable version of Kodi for Mac is Kodi v20.5 Nexus. This is the same code that all of the other platforms (Linux, iOS, Windows) are using.

What version/nightly build/beta of Kodi am I running?

Link
  • Kodi main menu > System > Lower submenu > System info. Note the build date.

Programs and tools to help with Kodi

Link
  • For a list of programs and tools to help with Kodi, such as renaming files, managing media, file sharing, and more, see Supplemental tools/Mac OS X

Remote controls

What remotes can be used with Kodi

Link
  • Apple Remote (both white and silver version)
    • How do I bring up the context menu? - Press and hold MENU
    • How do I bring up the OSD during playback? - Press and hold SELECT
  • Logitech Harmony remotes can be used. See #Harmony
  • Any Keyboard such as wired, wireless, bluetooth. This includes "keymotes" such as the Rii or Boxee remote.
  • Web interfaces, including add-on interfaces.
  • Kodi smartphone and tablet remote apps.
  • Other IR remotes can be used with IR receivers such as the Flirc.

Starting Kodi with the Apple Remote

Link

Using a Logitech Harmony remote

Link
  • Kodi can use a Logitech Harmony remote using the normal Apple IR receiver that is built into some Macs.
  • Go to Settings -> System -> Input devices and change "Apple remote" to "Universal".
  • On the Logitech Harmony remote, select the Plex profile.

Can't wake a sleeping Mac using the Apple Remote on 10.7

Link

iTunes and/or system volume is taking over when using the remote

Link

Troubleshooting

General

Getting more help with Kodi for Mac OS X

Link

Userdata folder and logs

Link
See How-to:Submit a proper bug report for bug reporting details and here for instructions on reporting an issue to the forums
  • Userdata folder: /Users/<your_user_name>/Library/Application Support/Kodi/userdata
  • Debug log: /Users/<your_user_name>/Library/Logs/kodi.log
  • Console log: /Library/Logs/Console/501/console.log
  • CrashReporter: /Users/<your_user_name>/Library/Logs/DiagnosticReports/

I am seeing double or ghost files for some videos

Link
  • When Mac OS X touches files that are saved on a non-Mac-formatted drive (HFS+) it will save metadata in what are often called AppleDouble files. They often show up looking like ._filename.ext or .DS_Store. On a native Mac formatted drive (HFS+) the metadata is written in such a way that it does not create these files, which is why you don't see them there.
  • Normally, these files should not be visible to Kodi and they should not be scanned into the libraries. The only exception for this is if "Show hidden files" is turned on under Settings -> Appearance -> File lists -> "Show hidden files and directories"


  • You can prevent Mac OS X from creating these files on a network share by using a program such as TinkerTool or by opening Terminal.app and running the following command:
    defaults write com.apple.desktopservices DSDontWriteNetworkStores true
  • To remove existing appledouble files you need to make them visible (again, you can use TinkerTool to make them visible, but remember to re-enable invisible files afterwards to protect certain system files) and drag them to the trash can and delete them.

Remote issues

Link

Add-ons downloaded from the internet are not in zip format or will not install

Link
  • There are two main possibilities for an add-on to not install when you use "Install from zip". One is that it isn't in a proper zip format, the other is that the add-on is for an older version of Kodi that isn't compatible with the version you are using.
  • Very commonly the Safari web browser is being used to download these add-ons, and by default will unzip the files leaving you with a folder that won't work with the "Install from zip" option. You can turn this feature off by going into Safari's preferences, under "General" and unchecking "Open 'safe' files after downloading". If you wish to keep this feature on, you should be able to find the original zip file in the Trash can. Just drag the file out and use it instead of the folder for "Install from zip".
  • Sometimes you need to build zip plugin from directory. Almost all ZIP programs on OSX create zip file, which is not compatible with KODI. If you want to create compatible plugin, you can use "zip" program from terminal, usage
zip -r plugin.name.zip plugin.directory/
or you can download YemuZip and be sure you choose "Type: PC" while creating ZIP file.

Can't see UPnP sources/servers

Link
  • See If you are unable to see UPnP sources or servers inside of Kodi it could be due to a conflicting UPnP service running on your Mac or network. One known conflicting server is EyeTV, which runs a UPnP server in the background, even if EyeTV itself is not running. Uninstalling EyeTV or forcing all EyeTV processes to quit in Activity Monitor should fix the issue.

Audio issues and/or slow video playback

Link
  • If you hear sound only coming from the left side of speakers/headphones then you probably need to change your audio settings from 2.1 to 2.0.
  • Make sure that your audio settings are correct. Wrong audio settings will have severely negative effects on video playback.
  • Check to see if your speaker setup is really correct
  • If passthrough: make sure you only enable the audio codecs your receiver supports.
  • Select the correct audio output device for analog and passthrough.

Frodo issues

  • Not actually an issue with Kodi: Apple does not provide support for HD-audio passthrough in their audio API, CoreAudio.

Why does setting the output for 2.0 sound work better for 5.1 sound?

Link

2.0 is the number of channels we are opening in the device. For all passed through audio like DTS and AC3 we need 2 channels (as those 5.1 channels are encoded into 2.0 pcm channels). Setting the speakerlayout higher results in the activation of LPCM. LPCM means Kodi decodes all channels from the 2.0 encoded DTS, AC3 sound (resulting in 6 channels for 5.1) - remaps them according to the audio device and then puts them out as 6 pcm channels (this is 3 times more data then the 2.0 encoded channels from DTS, AC3 passthrough).

Since we have issues with mapping the channels from input format 5.1 to device format 5.1 atm - this may result in silence instead of audio.

Bluetooth audio results in poor sound quality.

Link

Go into Settings -> System -> Audio output and select Fixed and 44.1 on the settings.

Some screensavers are missing

Due to a lack of manpower for OS X devs, "rsxs" screensavers were dropped from Kodi for Mac OS X. "rsxs" screensavers are still supported on other platforms. See here for more info.

Mac OS X 10.7 (Lion) (and higher) issues

SMB (Windows Sharing) isn't working when sharing files

Link
  • See SMB/Mac for tips. Sometimes Apple changes things with SMB sharing and additional steps are needed.

Userdata folder and logs are hidden

Link
  • By default, Mac OS X 10.7 hides the user's Library folder, which is where Kodi's userdata folder and logs are stored. There are a few ways to get around this:
    • While in the Finder, click on the "Go" menu and hold down  Option, then select Library.
    • You can use programs such as TinkerTool to change the visibility of all or some hidden files/folders.
    • To permanently reveal the ~/Library folder, open up Terminal and run this command:
    chflags nohidden ~/Library
    Note: Anytime there is an OS X update (e.g. from version 10.7.3 to 10.7.4) you will have to run this command again as the folder will be hidden again.

Can't wake a sleeping Mac using the Apple Remote

Link
  • Apple changed how energy saving settings work on Mac OS X 10.7/10.8 and by default the Apple Remote will not wake a sleeping Mac. This can be fixed by changing the "darkwake" flag on Mac OS X, but do this at your own risk.

Strange sound when movie is paused after updating to 10.7.4

Link
  • Are you getting strange sounds when you pause some movies after updating Mac OS X to 10.7.4? Apple changed some OS-level code that has affected several programs, including Kodi, Plex, ProTools, and others. It has been reported that upgraded Mac OS X to 10.7.5 or 10.8 (Mountain Lion) fixes this problem. For more info see this forum post: Forum:131305.

Mac OS X 10.8 (Mountain Lion) (and higher) issues

Gatekeeper prevents Kodi from installing ("Kodi" can’t be opened because it is from an unidentified developer)

Link

HOW-TO:Install Kodi for Mac

Mac OS X 10.9 (Mavericks)

Other 10.9 issues

Link
  • Stuttering video- Some users have had issues with stuttering video, possibly related to the AppNap feature.
  • Possible issue with auto-switching GPUs on some Macbook Pros- There seems to be an issue with some Macbook Pros that have auto-switching GPUs that cause Kodi to start up with only 16k colors and/or low resolution. Switching in and out of windowed mode seems to work as a temp workaround (press \ on a keyboard).
  • Crash when starting Kodi with external monitor- Kodi might crash when there is an external/second monitor connected (laptops only?) and not in mirroring mode. This will be fixed in the 12.3 bugfix release and has been fixed in nightly builds.
  • SMB/SAMBA/Windows sharing sharing from Mac OS X 10.9- Not really an Kodi issue, but Kodi clients connecting to a Mac OS X 10.9 SMB/SAMBA/Windows-sharing file server might have compatibility issues again. SMBUp can be used as a workaround.
  • IR Apple remote is unresponsive- The "App Nap" feature in OS X 10.9 might cause lag and delays when using the white or silver Apple IR remote control. A temp work around would be to disable "App Nap" in OS X.