HOW-TO:Install Kodi for Mac OS X: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Thijse
No edit summary
(47 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{XBMC wiki toc Inline}}
{{mininav| [[Mac OS X]] }}
__NOEDITSECTION__
{{See also|Mac FAQ}}
Installing applications on Mac OS X is quite easy compared to many other platforms, allthough it is somewhat different from other platforms. Below we list the steps needed for basic installation an uninstallation.
 
__TOC__
__TOC__
== Download ==
First download Kodi. Official stable builds can be found here: '''http://kodi.tv/download/'''
{{warning|Don't install a [[development build]] unless you are willing to experience bugs, changes, breaks, sudden movements, fire, and other things that might "be bumpy".}} For [[development builds]] see:
* Nightly builds: http://mirrors.kodi.tv/nightlies/osx/
* Monthly builds (slightly more stable than Nightly builds): http://mirrors.kodi.tv/snapshots/osx/
== Un-package ==
Kodi is packaged as an [http://guides.macrumors.com/Disk_image disk image]. A disk image can be thought of as the virtual equivalent of a CD. The actual data in the disk image is contained within a single file which will look something like this:


Installing applications on Mac OS X is quite easy compared to many other platforms, allthough it is somewhat different from other platforms. Below we list the steps needed for basic installation an uninstallation.
[[File:Xbmc.dmg.jpg|500px|border]]
 
Safari and some other download apps will auto-mount the Kodi disk image, but you may have to do this yourself by double-clicking the file. Having done this, the the disk image will appear as new device in the Finder, as shown in the picture below:


=Download=
== Install ==


First download XBMC. Official builds (alpha, beta, and stable versions) can be found here [http://xbmc.org/download/], unofficial nightly builds can be found here [[http://sshcs.com/xbmc/]]. Use the latter at your own risk, there is no guarantee that the build is stable.  
Kodi is installed by drag-and-dropping it to the applications folder.  


=Un-package=
All you have to do is copy the program to your desired location (usually your Applications folder) and run it. Copying the program is performed simply by using drag and drop. Kodi makes it even easier by supplying a link to the Application folder, on which you can drop the Kodi bundle. An example of this is shown below:


XBMC is packaged as an [http://guides.macrumors.com/Disk_image disk image]. A disk image can be thought of as the virtual equivalent of a CD. The actual data in the disk image is contained within a single file which will look something like this:
[[File:Mac.drag_n_drop.jpg|500px|border]]


[picture XBMC disk image]
=== Gatekeeper ===
<section begin="Gatekeeper" />
If you have Mac OS X 10.8 or higher then you might get a message saying that Kodi "can’t be opened because it is from an unidentified developer". This is due to the OS X Gatekeeper feature that is designed to discourage users from downloading from random locations and possibly installing something bad. Assuming you've downloaded Kodi from http://kodi.tv/download/ then you have nothing to worry about, and we just need to bypass this warning:


You will have to "insert," or "mount," the disk image into the machine by double-clicking the file. Having done this, the the disk image will appear as new device in the Finder, as shown in the picture below:


=Install=
* '''Recommended - ''' Right click (or command+click) the Kodi icon and select "open"
''or''
* '''Advanced - ''' Enable all application downloads
*# In OS X go to the Apple Menu -> System Preferences -> Security & Privacy -> General ->
*# Unlock the padlock at the bottom of the window, which will require a computer admin password
*# Where it says "Allow applications downloaded from:" select "Anywhere"
*# OS X will give you a scary warning that is a bit exaggerated. If you're not comfortable with this, use the "right click" method mentioned above.


XBMC is implemented as an [http://guides.macrumors.com/Bundle installation bundle] and can be installed by drag-and-dropping it to the applications folder.
On newer Mac OS versions where the „Anywhere“ option is not visible there is only the way via Terminal.app to disable Gatekeeper as follows:


All you have to do is copy the program to your desired location (usually your Applications folder) and run it. Copying the program is performed simply by using drag and drop. XBMC makes it even easier by supplying a link to the Application folder, on which you can drop the XBMC bundle. An example of this is shown below:
*# Launch Terminal if you haven’t done so yet (/Applications/Utilities/)
*#  issue the following command to turn off Gatekeeper: sudo spctl --master-disable
*# Hit return and enter the admin password as usually required by sudo, and Gatekeeper will instantly be disabled


[picture  drag&drop]
In all cases OS X will still ask you if you want to open an "unsigned" application the first time it is opened, so new applications that are downloaded can't just start by themselves.
<section end="Gatekeeper" />


=Tidy up=
== Tidy up ==


After you have finished installing the program you can unmount the XBMC disk image
After you have finished installing the program you can unmount the Kodi disk image


This can be done by using the eject icon next to to it in the Finder sidebar as if it were a CD. You can also drag the mounted disk icon to the the Trash, again as if it were a CD.
This can be done by using the eject icon next to to it in the Finder sidebar as if it were a CD. You can also drag the mounted disk icon to the the Trash, again as if it were a CD.
Line 33: Line 59:
All files other than the bundle in the Applications folder can be simply discarded. Either place them in the Trash or back them up somewhere in case you wish to re-install the application in the future.
All files other than the bundle in the Applications folder can be simply discarded. Either place them in the Trash or back them up somewhere in case you wish to re-install the application in the future.


=The Dock=
== Update ==
 
To update Kodi for Mac simply follow the normal install steps with the newer version. 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 want XBMC to appear in the Dock, simply drag the application's icon into the left side of the Dock from wherever you have installed it. Another way to add an application to the Dock is, if the program is currently running, control-click its icon in the Dock and select "Keep In Dock" .


=Update=
== Uninstall ==


You can use [http://metaquark.de/appfresh/ Appfresh] to keep XBMC up to date, although it will only stay current with the latest stable version.  
The Kodi bundle contains the full application. This means that to uninstall it, you only have to drag it to the Trash.  


=Uninstall=
However, Kodi creates '''[[userdata]]''' files. They are located in the Application Support folder within your user's Library folder:


The XBMC bundle contains the full application. This means that to uninstall it, you only have to drag it to the Trash.  
{{Note|The "Library" folder for your user is hidden by default in Mac OS X. See '''[[Mac FAQ#Lion userdata|here]]''' for how to expose this folder if you don't already know how to.}}


However, XBMC creates [http://guides.macrumors.com/Preference_File preference files] when it is run. They are located in the Application Support folder within your user's Library folder, that is, in "/Library/Application Support/XBMC".  This directory contains all your settings and your video & music database. If you want to remove all your XBMC settings, drag this folder to the Trash.
* Macintosh HD/Users/YOURUSERNAME/Library/Application Support/XBMC
or
* Macintosh HD/Users/YOURUSERNAME/Library/Application Support/Kodi


Third party uninstallers exist which will search for these preference files for you, the most notable of which is a program called [http://www.appzapper.com/ AppZapper]. A comparable, free alternative is [http://konstochvanligasaker.se/apptrap/ AppTrap].
This directory contains all your settings and your video & music database. If you want to remove all your Kodi settings, drag this folder to the Trash.


== Autostart Kodi ==


=Autostart XBMC=
Go into System Preferences, select "accounts". Select "Login Items", at the bottom hit the plus button and then a drop down box allows you to select Kodi.


Go into System Preferences, select "accounts". Select "Login Items", at the bottom hit the plus button and then a drop down box allows you to select XBMC.
Alternatively, if you have the app open in your dock, you can right-click/click-and-hold the icon and choose "Open at Log-in"  
 
Alternatively, if you have the app open in your dock, you can right-click/click-and-hold the icon and choose "Open at Log-in"                                                                                                                                                            


After this, the application will start up automatically after you log in.
After this, the application will start up automatically after you log in.


=Development for XBMC =
{{Updated|16}}
To help out with the development of XBMC for Mac see here:
*[[XBMC for Mac|XBMC for Mac development]]
 


[[category:Installation]]
[[Category:Manual]]
[[category:Mac OS X]]
[[Category:Installation|Mac]]
[[Category:Mac OS X]]
[[Category:How-to]]

Revision as of 09:41, 10 March 2018

Home icon grey.png   ▶ Mac OS X ▶ HOW-TO:Install Kodi for Mac OS X

Installing applications on Mac OS X is quite easy compared to many other platforms, allthough it is somewhat different from other platforms. Below we list the steps needed for basic installation an uninstallation.

Download

First download Kodi. Official stable builds can be found here: http://kodi.tv/download/


Stop hand.png Don't install a development build unless you are willing to experience bugs, changes, breaks, sudden movements, fire, and other things that might "be bumpy".
For development builds see:

Un-package

Kodi is packaged as an disk image. A disk image can be thought of as the virtual equivalent of a CD. The actual data in the disk image is contained within a single file which will look something like this:

Xbmc.dmg.jpg

Safari and some other download apps will auto-mount the Kodi disk image, but you may have to do this yourself by double-clicking the file. Having done this, the the disk image will appear as new device in the Finder, as shown in the picture below:

Install

Kodi is installed by drag-and-dropping it to the applications folder.

All you have to do is copy the program to your desired location (usually your Applications folder) and run it. Copying the program is performed simply by using drag and drop. Kodi makes it even easier by supplying a link to the Application folder, on which you can drop the Kodi bundle. An example of this is shown below:

Mac.drag n drop.jpg

Gatekeeper

If you have Mac OS X 10.8 or higher then you might get a message saying that Kodi "can’t be opened because it is from an unidentified developer". This is due to the OS X Gatekeeper feature that is designed to discourage users from downloading from random locations and possibly installing something bad. Assuming you've downloaded Kodi from http://kodi.tv/download/ then you have nothing to worry about, and we just need to bypass this warning:


  • Recommended - Right click (or command+click) the Kodi icon and select "open"

or

  • Advanced - Enable all application downloads
    1. In OS X go to the Apple Menu -> System Preferences -> Security & Privacy -> General ->
    2. Unlock the padlock at the bottom of the window, which will require a computer admin password
    3. Where it says "Allow applications downloaded from:" select "Anywhere"
    4. OS X will give you a scary warning that is a bit exaggerated. If you're not comfortable with this, use the "right click" method mentioned above.

On newer Mac OS versions where the „Anywhere“ option is not visible there is only the way via Terminal.app to disable Gatekeeper as follows:

    1. Launch Terminal if you haven’t done so yet (/Applications/Utilities/)
    2. issue the following command to turn off Gatekeeper: sudo spctl --master-disable
    3. Hit return and enter the admin password as usually required by sudo, and Gatekeeper will instantly be disabled

In all cases OS X will still ask you if you want to open an "unsigned" application the first time it is opened, so new applications that are downloaded can't just start by themselves.


Tidy up

After you have finished installing the program you can unmount the Kodi disk image

This can be done by using the eject icon next to to it in the Finder sidebar as if it were a CD. You can also drag the mounted disk icon to the the Trash, again as if it were a CD.

All files other than the bundle in the Applications folder can be simply discarded. Either place them in the Trash or back them up somewhere in case you wish to re-install the application in the future.

Update

To update Kodi for Mac simply follow the normal install steps with the newer version. 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.

Uninstall

The Kodi bundle contains the full application. This means that to uninstall it, you only have to drag it to the Trash.

However, Kodi creates userdata files. They are located in the Application Support folder within your user's Library folder:

Note: The "Library" folder for your user is hidden by default in Mac OS X. See here for how to expose this folder if you don't already know how to.

  • Macintosh HD/Users/YOURUSERNAME/Library/Application Support/XBMC

or

  • Macintosh HD/Users/YOURUSERNAME/Library/Application Support/Kodi

This directory contains all your settings and your video & music database. If you want to remove all your Kodi settings, drag this folder to the Trash.

Autostart Kodi

Go into System Preferences, select "accounts". Select "Login Items", at the bottom hit the plus button and then a drop down box allows you to select Kodi.

Alternatively, if you have the app open in your dock, you can right-click/click-and-hold the icon and choose "Open at Log-in"

After this, the application will start up automatically after you log in.