Archive:Install Kodi on Apple TV 2: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Reverted edits by Xbmchub (talk) to last revision by Ned Scott)
No edit summary
(48 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{iOS navigation}}
{{mininav|[[iOS]]/[[ATV2]]|page={{FULLPAGENAME}} }}
<center>
The current stable release of XBMC for iOS is [[Frodo FAQ|v12 Frodo]].
{| class="wikitable"
! colspan="2" | <big>Which version of Apple TV software do you have?</big>
|-
| [[File:ATV2 software 4.jpg|400px|center|link=HOW-TO:Install XBMC on Apple TV 2#ATV 4.x]]<br/>
<big>If you have a [[forum:99315|jailbroken]] [[Apple TV 2]] running [[w:IOS version history#Version history: Apple TV (2nd generation) onwards|versions 4.1 to 4.4.4]]:<br/>
'''Use these instructions: [[HOW-TO:Install XBMC on Apple TV 2#ATV 4.x|ATV 4.x]]'''</big>
| [[File:ATV2 software 5.jpg|400px|center|link=HOW-TO:Install XBMC on Apple TV 2#ATV 5.x]]<br/>
<big>If you have a [[forum:99315|jailbroken]] [[Apple TV 2]] running [[w:IOS version history#Version history: Apple TV (2nd generation) onwards|versions 5.0 and up]]:<br/>
'''Use these instructions: [[HOW-TO:Install XBMC on Apple TV 2#ATV 5.x|ATV 5.x]]'''</big>
|}
</center>
----
The current stable release of XBMC for iOS is [[Eden FAQ|v11 (Eden)]].
;Requirements:
;Requirements:
{{#lst:Supported hardware|ATV2}}
{{#lst:Supported hardware|ATV2}}
*If you have any issues, be sure to read the [[iOS FAQ]]!
* If you have any issues, be sure to read the [[iOS FAQ]]!
__toc__
{{-}}
{{-}}


=ATV 4.x=
== Installing from the command line ==
== Installing from the command line ==
:''This is the same build installed from the nitoTV menu, if installed.''
# Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV:
#: <pre>ssh [email protected]</pre>
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
# You will be asked for a password: ''default password is '''alpine'''''
# Continue to enter the following commands:
#: <pre>apt-get install wget</pre>
#: <pre>wget -O- <nowiki>http://apt.awkwardtv.org/awkwardtv.pub</nowiki> | apt-key add -</pre>
#: <pre>echo "deb <nowiki>http://apt.awkwardtv.org/ stable main" ></nowiki> /etc/apt/sources.list.d/awkwardtv.list</pre>
#: <pre>echo "deb <nowiki>http://mirrors.xbmc.org/apt/atv2 ./" ></nowiki> /etc/apt/sources.list.d/xbmc.list</pre>
#: <pre>apt-get update</pre>
#: <pre>mkdir -p /Applications/AppleTV.app/Appliances</pre>
#: <pre>apt-get install org.xbmc.xbmc-atv2</pre>
#: <pre>mkdir -p /Applications/XBMC.frappliance</pre>
#: <pre>reboot</pre>
And you're done! You should now be running XBMC v12 Frodo for Apple TV 2. See [[IOS FAQ#XBMC Version|here]] to verify your XBMC version.


#Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV:
== Installing from NitoTV ==
#:<pre>ssh [email protected]</pre>
{{notice|While this should work in theory, the official installation method for XBMC is to use the command line instructions. If you have issues with any of the Nito installers then please try the command line instructions to see if that fixes the issue. Nito simply gives a GUI for those command line instructions, so it should work, but Team XBMC has no control over those installers and cannot update them or see any errors from them, or anything like that.}}
#::'''EXAMPLE:''' <code>ssh [email protected]</code>
;NitoTV on the Apple TV 2
#You will be asked for a password: ''default password is '''alpine'''''
# Scroll right to the NitoTV menu on the Apple TV and choose the first option "''Install Software''".
#Continue to enter the following commands:
# Scroll down the list until you see "''XBMC-ATV2''" and click on that.
#:<pre>apt-get install wget</pre>
# From that menu press "''install''" and your Apple TV will install XBMC and then do a '''SOFT''' reboot (no tethered boot required).
#:<pre>wget -O- <nowiki>http://apt.awkwardtv.org/awkwardtv.pub</nowiki> | apt-key add -</pre>
# XBMC will now be in your Apple TV menu, scroll right to it, click and enjoy.
#:<pre>echo "deb <nowiki>http://apt.awkwardtv.org/ stable main" ></nowiki> /etc/apt/sources.list.d/awkwardtv.list</pre>
And you're done! You should now be running XBMC v12 Frodo for Apple TV 2. See [[IOS FAQ#XBMC Version|here]] to verify your XBMC version.
#:<pre>echo "deb <nowiki>http://mirrors.xbmc.org/apt/atv2 ./" ></nowiki> /etc/apt/sources.list.d/xbmc.list</pre>
#:<pre>apt-get update</pre>
#:<pre>apt-get install org.xbmc.xbmc-atv2</pre>
#:<pre>reboot</pre>
 
And you're done! You should now be running XBMC v11 (Eden) for Apple TV 2. See [[IOS FAQ#XBMC_Version|here]] to verify your XBMC version.
 
==Installing from NitoTV==
After installing NitoTV:
:#Scroll right to the NitoTV menu on the Apple TV and choose the first option "''Install Software''".
:#Scroll down the list until you see "''XBMC-ATV2''" and click on that.
:#From that menu press "''install''" and your Apple TV will install XBMC and then do a '''SOFT''' reboot (no tethered boot required).
:#XBMC will now be in your Apple TV menu, scroll right to it, click and enjoy.
And you're done! You should now be running XBMC v11 (Eden) for Apple TV 2. See [[IOS FAQ#XBMC_Version|here]] to verify your XBMC version.
{{-}}
{{-}}


 
== Updating ==
= ATV 5.x =
==Installing from the command line==
:''This is the same build installed from the nitoTV menu, if installed.''
#Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV:
#:<pre>ssh [email protected]</pre>
#::'''EXAMPLE:''' <code>ssh [email protected]</code>
#You will be asked for a password: ''default password is '''alpine'''''
#Continue to enter the following commands:
#:<pre>apt-get install wget</pre>
#:<pre>wget -O- <nowiki>http://apt.awkwardtv.org/awkwardtv.pub</nowiki> | apt-key add -</pre>
#:<pre>echo "deb <nowiki>http://apt.awkwardtv.org/ stable main" ></nowiki> /etc/apt/sources.list.d/awkwardtv.list</pre>
#:<pre>echo "deb <nowiki>http://mirrors.xbmc.org/apt/atv2 ./" ></nowiki> /etc/apt/sources.list.d/xbmc.list</pre>
#:<pre>apt-get update</pre>
#:<pre>mkdir -p /Applications/AppleTV.app/Appliances</pre>
#:<pre>apt-get install org.xbmc.xbmc-atv2</pre>
#:<pre>mkdir -p /Applications/XBMC.frappliance</pre>
#:<pre>reboot</pre>
And you're done! You should now be running XBMC v11 (Eden) for Apple TV 2. See [[IOS FAQ#XBMC_Version|here]] to verify your XBMC version.
 
= Updating =
Either update through NitoTV or issue the following commands to update:
Either update through NitoTV or issue the following commands to update:
#Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2:
# Open up your [[XBMC for iOS specific FAQ#SSH|terminal/ssh application]] and enter the following command to log in to your ATV2:
#:<pre>ssh [email protected]</pre>
#: <pre>ssh [email protected]</pre>
#::'''EXAMPLE:''' <code>ssh [email protected]</code>
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
#You will be asked for a password: ''default password is '''alpine'''''
# You will be asked for a password: ''default password is '''alpine'''''
#Continue to enter the following commands:
# Continue to enter the following commands:
#:<pre>apt-get update</pre>
#: <pre>apt-get update</pre>
#:<pre>apt-get install org.xbmc.xbmc-atv2</pre>  
#: <pre>apt-get install org.xbmc.xbmc-atv2</pre>  


=Nightly builds=
== Development builds ==
{{main|nightly builds}}
{{main|Development builds}}
=== Nightly builds ===
{{see also|nightly builds}}
Nightly builds are unstable test builds that have the latest bug fixes and feature additions. Nightly builds work with both ATV2 software version 4.x and 5.x. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]].
Nightly builds are unstable test builds that have the latest bug fixes and feature additions. Nightly builds work with both ATV2 software version 4.x and 5.x. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]].


:''Change history: [http://trac.xbmc.org/timeline trac timeline] or [https://github.com/xbmc/xbmc/commits commit history]''
:''Change history: [https://github.com/xbmc/xbmc/commits commit history]''


'''NOTE: You MUST install the stable version (see above) before you can install a nightly build.''' You only need to install the stable version once and you don't need to uninstall previous versions to upgrade (or downgrade) XBMC.  
'''NOTE: You MUST install the stable version (see above) before you can install a nightly build.''' You only need to install the stable version once and you don't need to uninstall previous versions to upgrade (or downgrade) XBMC.  


#Open http://mirrors.xbmc.org/nightlies/darwin/atv2/ in a web browser and copy the url of the '''most recent file''' in that listing.
# Open http://mirrors.xbmc.org/nightlies/darwin/atv2/ in a web browser and copy the url of the '''most recent file''' in that listing.
#::'''EXAMPLE:''' <code><nowiki>http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb</nowiki></code>
#:: '''EXAMPLE:''' <code><nowiki>http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb</nowiki></code>
#Open up your [[XBMC for iOS specific FAQ#What is SSH?|terminal/ssh application]] and enter the following command to log in to your ATV2:
# Open up your [[XBMC for iOS specific FAQ#What is SSH?|terminal/ssh application]] and enter the following command to log in to your ATV2:
#:<pre>ssh [email protected]</pre>
#: <pre>ssh [email protected]</pre>
#::'''EXAMPLE:''' <code>ssh [email protected]</code>
#:: '''EXAMPLE:''' <code>ssh [email protected]</code>
#You will be asked for a password: ''default password is '''alpine'''''
# You will be asked for a password: ''default password is '''alpine'''''
#Continue to enter the following commands:
# Continue to enter the following commands:
#:<pre>rm -f *xbmc*.deb</pre>
#: <pre>rm -f *xbmc*.deb</pre>
#:<pre>wget URL-FROM-STEP-ONE-HERE</pre>
#: <pre>wget URL-FROM-STEP-ONE-HERE</pre>
#::'''EXAMPLE:''' <code><nowiki>wget http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb</nowiki></code>
#:: '''EXAMPLE:''' <code><nowiki>wget http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb</nowiki></code>
#:<pre>dpkg -i *xbmc*.deb</pre>
#: <pre>dpkg -i *xbmc*.deb</pre>
#:<pre>rm *xbmc*.deb</pre>
#: <pre>rm *xbmc*.deb</pre>


And you're done! You should now have the latest nightly build of XBMC for ATV2. See [[IOS FAQ#XBMC_Version|here]] to verify your XBMC version.
And you're done! You should now have the latest nightly build of XBMC for ATV2. See [[IOS FAQ#XBMC Version|here]] to verify your XBMC version.


===Monthly builds===
<!-- === Monthly builds ===
{{anchor|Monthly builds|Beta|Frodo beta|Frodo RC|Beta builds}}
{{see also|monthly builds}}
{{see also|monthly builds}}
Installing a semi-stable monthly build is the same as installing a [[#Nightly builds|nightly build]], but with the url in step 1 replaced with http://mirrors.xbmc.org/snapshots/darwin/atv2/
Installing a semi-stable monthly build is the same as installing a [[#Nightly builds|nightly build]] above, but with the url in step 1 replaced with http://mirrors.xbmc.org/snapshots/darwin/atv2/-->
 
=== Beta builds ===
{{anchor|Monthly builds|Beta|Frodo beta|Frodo RC|Beta builds}}
{{note|[[#Nightly builds|nightly builds]] are still being made and will have the most recent fixes on top of the current beta build.}}
To install v13 beta, follow the nightly build instructions above with one exception:
* replace the url in '''step 1''' with <code>http://mirrors.xbmc.org/apt/pre-release/atv2/deb/</code>


=Uninstalling=
== Uninstalling ==
===Uninstalling just XBMC ===
=== Uninstalling just XBMC ===
SSH into your Apple TV (Using the same instructions from above to login). Then run:<br />
SSH into your Apple TV (Using the same instructions from above to login). Then run:<br />
<pre> apt-get remove org.xbmc.xbmc-atv2</pre>
<pre> apt-get remove org.xbmc.xbmc-atv2</pre>
Line 118: Line 92:


=== Removing settings ===
=== Removing settings ===
XBMC will uninstall from your Apple TV but will leave certain things ([[XBMC databases|databases]] and everything in your [[userdata folder]]) behind to make it easier if you wanted to reinstall. To delete those also run:
XBMC will uninstall from your Apple TV but will leave certain things ([[XBMC databases|databases]] and everything in your [[userdata folder]]) behind to make it easier if you wanted to reinstall. To delete those also run:
<pre>rm -Rf /private/var/mobile/Library/Preferences/XBMC</pre>
<pre>rm -Rf /private/var/mobile/Library/Preferences/XBMC</pre>
This will then be completely clear and XBMC will be removed.
This will then be completely clear and XBMC will be removed.


=== Deleting XBMC dependencies ===
=== Deleting XBMC dependencies ===
XBMC has three dependencies that it installs along with itself when you first install XBMC (org.xbmc.xbmc-seatbeltunlock, gawk, bsdiff). After uninstalling XBMC you can also uninstall these 3 dependencies by running this command:
XBMC has three dependencies that it installs along with itself when you first install XBMC (org.xbmc.xbmc-seatbeltunlock, gawk, bsdiff). After uninstalling XBMC you can also uninstall these 3 dependencies by running this command:
<pre>apt-get remove org.xbmc.xbmc-seatbeltunlock && apt-get remove gawk && apt-get remove bsdiff</pre>
<pre>apt-get remove org.xbmc.xbmc-seatbeltunlock && apt-get remove gawk && apt-get remove bsdiff</pre>


{{XBMC wiki toc}}
[[Category:XBMC Manual]]
[[Category:IOS|Apple TV 2]]
[[Category:IOS|Apple TV 2]]
[[Category:How-to|Apple TV 2]]
[[Category:How-to|Apple TV 2]]
[[Category:Installation|Apple TV2]]
[[Category:Installation|Apple TV2]]
{{frodo updated}}

Revision as of 10:47, 4 April 2014

Home icon grey.png   ▶ iOS/ATV2 ▶ Archive:Install Kodi on Apple TV 2

The current stable release of XBMC for iOS is v12 Frodo.

Requirements
  • If you have any issues, be sure to read the iOS FAQ!


Installing from the command line

  1. Open up your terminal/ssh application and enter the following command to log in to your ATV2. Note, you need to replace "YOUR.ATV2.IP.ADDRESS" with the IP address of the Apple TV:
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  2. You will be asked for a password: default password is alpine
  3. Continue to enter the following commands:
    apt-get install wget
    wget -O- http://apt.awkwardtv.org/awkwardtv.pub | apt-key add -
    echo "deb http://apt.awkwardtv.org/ stable main" > /etc/apt/sources.list.d/awkwardtv.list
    echo "deb http://mirrors.xbmc.org/apt/atv2 ./" > /etc/apt/sources.list.d/xbmc.list
    apt-get update
    mkdir -p /Applications/AppleTV.app/Appliances
    apt-get install org.xbmc.xbmc-atv2
    mkdir -p /Applications/XBMC.frappliance
    reboot

And you're done! You should now be running XBMC v12 Frodo for Apple TV 2. See here to verify your XBMC version.

Installing from NitoTV

Emblem-important-yellow.png NOTICE:
While this should work in theory, the official installation method for XBMC is to use the command line instructions. If you have issues with any of the Nito installers then please try the command line instructions to see if that fixes the issue. Nito simply gives a GUI for those command line instructions, so it should work, but Team XBMC has no control over those installers and cannot update them or see any errors from them, or anything like that.
NitoTV on the Apple TV 2
  1. Scroll right to the NitoTV menu on the Apple TV and choose the first option "Install Software".
  2. Scroll down the list until you see "XBMC-ATV2" and click on that.
  3. From that menu press "install" and your Apple TV will install XBMC and then do a SOFT reboot (no tethered boot required).
  4. XBMC will now be in your Apple TV menu, scroll right to it, click and enjoy.

And you're done! You should now be running XBMC v12 Frodo for Apple TV 2. See here to verify your XBMC version.

Updating

Either update through NitoTV or issue the following commands to update:

  1. Open up your terminal/ssh application and enter the following command to log in to your ATV2:
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  2. You will be asked for a password: default password is alpine
  3. Continue to enter the following commands:
    apt-get update
    apt-get install org.xbmc.xbmc-atv2

Development builds

Nightly builds

Nightly builds are unstable test builds that have the latest bug fixes and feature additions. Nightly builds work with both ATV2 software version 4.x and 5.x. They are not fully tested, so anticipate issues and be sure to backup your userdata folder.

Change history: commit history

NOTE: You MUST install the stable version (see above) before you can install a nightly build. You only need to install the stable version once and you don't need to uninstall previous versions to upgrade (or downgrade) XBMC.

  1. Open http://mirrors.xbmc.org/nightlies/darwin/atv2/ in a web browser and copy the url of the most recent file in that listing.
    EXAMPLE: http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb
  2. Open up your terminal/ssh application and enter the following command to log in to your ATV2:
    ssh [email protected]
    EXAMPLE: ssh [email protected]
  3. You will be asked for a password: default password is alpine
  4. Continue to enter the following commands:
    rm -f *xbmc*.deb
    wget URL-FROM-STEP-ONE-HERE
    EXAMPLE: wget http://mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2.deb
    dpkg -i *xbmc*.deb
    rm *xbmc*.deb

And you're done! You should now have the latest nightly build of XBMC for ATV2. See here to verify your XBMC version.


Beta builds

Note: nightly builds are still being made and will have the most recent fixes on top of the current beta build. To install v13 beta, follow the nightly build instructions above with one exception:

Uninstalling

Uninstalling just XBMC

SSH into your Apple TV (Using the same instructions from above to login). Then run:

 apt-get remove org.xbmc.xbmc-atv2

It will ask you if you want to continue:

The following packages will be REMOVED:
  org.xbmc.xbmc-atv2
0 upgraded, 0 newly installed, 1 to remove and 5 not upgraded.
After this operation, 0B of additional disk space will be used.
Do you want to continue [Y/n]?

Just enter "Y" to accept and continue.

Removing settings

XBMC will uninstall from your Apple TV but will leave certain things (databases and everything in your userdata folder) behind to make it easier if you wanted to reinstall. To delete those also run:

rm -Rf /private/var/mobile/Library/Preferences/XBMC

This will then be completely clear and XBMC will be removed.

Deleting XBMC dependencies

XBMC has three dependencies that it installs along with itself when you first install XBMC (org.xbmc.xbmc-seatbeltunlock, gawk, bsdiff). After uninstalling XBMC you can also uninstall these 3 dependencies by running this command:

apt-get remove org.xbmc.xbmc-seatbeltunlock && apt-get remove gawk && apt-get remove bsdiff