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

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(15 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{See also|Mac FAQ}}
{{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.
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 ==
== Download ==


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




{{highlight|color=Orange|'''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:
{{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.xbmc.org/nightlies/osx/
* Nightly builds: http://mirrors.kodi.tv/nightlies/osx/
*Monthly builds (slightly more stable than Nightly builds): http://mirrors.xbmc.org/snapshots/osx/
* Monthly builds (slightly more stable than Nightly builds): http://mirrors.kodi.tv/snapshots/osx/


== Un-package ==
== Un-package ==


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


[[File:Xbmc.dmg.jpg|500px|border]]
[[File:Xbmc.dmg.jpg|500px|border]]


Safari and some other download apps will auto-mount the XBMC 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:
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 ==
== Install ==


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


[[File:Mac.drag_n_drop.jpg|500px|border]]
[[File:Mac.drag_n_drop.jpg|500px|border]]
Line 30: Line 31:
=== Gatekeeper ===
=== Gatekeeper ===
<section begin="Gatekeeper" />
<section begin="Gatekeeper" />
If you have Mac OS X 10.8 or higher then you might get a message saying that XBMC "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 XBMC from http://xbmc.org/download/ then you have nothing to worry about, and we just need to bypass this warning:
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 XBMC icon and select "open"
* '''Recommended - ''' Right click (or command+click) the Kodi icon and select "open"
''or''
''or''
* '''Advanced - ''' Enable all application downloads
* '''Advanced - ''' Enable all application downloads
Line 41: Line 42:
*# 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.
*# 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:
*# 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


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.
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.
Line 47: Line 53:
== 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 54: Line 60:


== Update ==
== Update ==
To update XBMC 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.
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 ==
== Uninstall ==


The XBMC bundle contains the full application. This means that to uninstall it, you only have to drag it to the Trash.  
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 '''[[Mac FAQ#Lion userdata|here]]''' for how to expose this folder if you don't already know how to.}}


However, XBMC creates [[userdata]] 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


== Autostart XBMC ==
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.


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.
== 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"  
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"  
Line 70: Line 84:
After this, the application will start up automatically after you log in.
After this, the application will start up automatically after you log in.


[[Category:XBMC Manual]]
{{Updated|16}}
 
[[Category:Manual]]
[[Category:Installation|Mac]]
[[Category:Installation|Mac]]
[[Category:Mac OS X]]
[[Category:Mac OS X]]
[[Category:How-to]]
[[Category:How-to]]
{{frodo updated}}

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.