Archive:Install Kodi on Apple TV 2: Difference between revisions
No edit summary |
|||
(35 intermediate revisions by 8 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{mininav| [[iOS]] | [[ATV2]] }} | ||
The current stable release for iOS is {{current version}}. | |||
| [[ | |||
The current stable release | |||
;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]]! | ||
{{-}} | {{-}} | ||
== Installing from the command line == | == Installing from the command line == | ||
# 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 {{current version}} 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: | |||
#:<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 | |||
=Installing from NitoTV= | == Installing from NitoTV == | ||
{{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 | ;NitoTV on the Apple TV 2 | ||
#Scroll right to the NitoTV menu on the Apple TV and choose the first option "''Install Software''". | # 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. | # 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). | # 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. | # 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 | And you're done! You should now be running {{current version}} for Apple TV 2. See [[IOS FAQ#XBMC Version|here]] to verify your XBMC version. | ||
{{-}} | {{-}} | ||
= Updating = | == 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> | ||
==Development builds== | == Development and custom builds == | ||
{{anchor|Monthly builds|Beta|Frodo beta|Frodo RC|Beta builds|Nightly builds|Development builds}} | |||
{{main|Development builds}} | {{main|Development builds}} | ||
{{highlight|color=#FFB5B5| {{big|ALWAYS '''[[BACKUP]]''' YOUR '''[[userdata|USERDATA FOLDER]]''' WHEN USING DEVELOPMENT BUILDS! }} }} | |||
''' | {| class="prettytable" | ||
|- | |||
# | ! Build !! Description !! URL | ||
|- | |||
| '''Nightly build''' || Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to [[iOS FAQ#Backup|backup your userdata folder]] || http://mirrors.xbmc.org/nightlies/darwin/atv2/ | |||
|- | |||
| '''Monthly build''' || Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. || http://mirrors.xbmc.org/snapshots/darwin/atv2/ | |||
|- | |||
| '''Betas and {{nowrap|release candidates}}''' || Betas and release candidates are builds that are being tested to see if they have any bugs left before becoming a stable release. Most major bugs should be fixed in these builds. || http://mirrors.xbmc.org/apt/pre-release/atv2/deb/ | |||
|- | |||
| '''Older stable builds''' || If you wish to download an older version of XBMC for whatever reason, you can do so with these same instructions below. || http://mirrors.xbmc.org/apt/atv2/deb/ | |||
|} | |||
# Open one of the above URL locations in a web browser and copy the url of the '''most recent file''' in that listing. | |||
#:: '''EXAMPLE:''' <code><nowiki>http://</nowiki>mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2'''.deb'''</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: | |||
#: <pre>ssh [email protected]</pre> | |||
#:: '''EXAMPLE:''' <code>ssh [email protected]</code> | |||
# You will be asked for a password: ''default password is '''alpine''''' | |||
*#:<pre> | # Continue to enter the following commands: | ||
#: <pre>rm -f *xbmc*.deb</pre> | |||
* | #: <pre>wget URL-FROM-STEP-ONE-HERE</pre> | ||
#:: '''EXAMPLE:''' <code><nowiki>wget http://</nowiki>mirrors.xbmc.org/nightlies/darwin/atv2/xbmc-20111202-6729214-master-atv2'''.deb'''</code> | |||
#: <pre>dpkg -i *xbmc*.deb</pre> | |||
#: <pre>rm *xbmc*.deb</pre> | |||
See [[IOS FAQ#XBMC Version|here]] to verify your XBMC version. | |||
{{note|To go back to a stable version of XBMC you might need to first uninstall XBMC and then use the normal install instructions, or manually download the stable release deb file and install using the dev build instructions.}} | |||
=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 162: | 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. | 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). | 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> | ||
[[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]] | ||
{{Gotham updated}} |
Revision as of 20:10, 22 May 2014
iOS | ATV2 | Install Kodi on Apple TV 2 |
The current stable release for iOS is Kodi v21 Omega.
- Requirements
- If you have any issues, be sure to read the iOS FAQ!
Installing from the command line
- 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]
- EXAMPLE:
- You will be asked for a password: default password is alpine
- 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 Kodi v21 Omega for Apple TV 2. See here to verify your XBMC version.
Installing from NitoTV
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
- 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 Kodi v21 Omega for Apple TV 2. See here to verify your XBMC version.
Updating
Either update through NitoTV or issue the following commands to update:
- Open up your terminal/ssh application and enter the following command to log in to your ATV2:
ssh [email protected]
- EXAMPLE:
ssh [email protected]
- EXAMPLE:
- You will be asked for a password: default password is alpine
- Continue to enter the following commands:
apt-get update
apt-get install org.xbmc.xbmc-atv2
Development and custom builds
ALWAYS BACKUP YOUR USERDATA FOLDER WHEN USING DEVELOPMENT BUILDS!
Build | Description | URL |
---|---|---|
Nightly build | Nightly builds are unstable test builds that have the latest bug fixes and feature additions. They are not fully tested, so anticipate issues and be sure to backup your userdata folder | http://mirrors.xbmc.org/nightlies/darwin/atv2/ |
Monthly build | Monthly builds are more stable than nightly builds, but still contain lots of experimental new code. | http://mirrors.xbmc.org/snapshots/darwin/atv2/ |
Betas and release candidates | Betas and release candidates are builds that are being tested to see if they have any bugs left before becoming a stable release. Most major bugs should be fixed in these builds. | http://mirrors.xbmc.org/apt/pre-release/atv2/deb/ |
Older stable builds | If you wish to download an older version of XBMC for whatever reason, you can do so with these same instructions below. | http://mirrors.xbmc.org/apt/atv2/deb/ |
- Open one of the above URL locations 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
- EXAMPLE:
- Open up your terminal/ssh application and enter the following command to log in to your ATV2:
ssh [email protected]
- EXAMPLE:
ssh [email protected]
- EXAMPLE:
- You will be asked for a password: default password is alpine
- 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
- EXAMPLE:
dpkg -i *xbmc*.deb
rm *xbmc*.deb
See here to verify your XBMC version.
Note: To go back to a stable version of XBMC you might need to first uninstall XBMC and then use the normal install instructions, or manually download the stable release deb file and install using the dev build instructions.
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