Script to Download, Install and Update Git-hosted Aeon Showmix/Auriga/Hitched

Code:
Script to Download, Install and Update Git-hosted Aeon Skin/Mod(s)

-----------------------------------------------------------------

Script Version: 20091006, Patrick Khoo

Tested with: 

* Git Portable 1.6.4-20090729, XBMCUpdate 0.7.9, Windows XP SP3

* Git 1.6.4 (requires libz, libcrypto, libpthread), Ubuntu 8.04.3

-----------------------------------------------------------------



---- Quick Info ----

* Downloads, Installs and Updates Aeon Showmix, Aeon Auriga,

  Aeon Hitched and Aeon Phil65 skins for XBMC

* Already includes everything you need - fonts, git, etc

* Works on Windows, Linux and Mac OS X

* Even updates XBMC to latest SVN (Windows only)



---- Normal Users - Quick Start Instructions ----

How to use:

1. Copy all files in this package (or if this is a self extracting

   package, unextract it) to a new folder

   (eg. "C:\Program Files\ASMUpdate" or "~/asmupdate")

2. For MacOS X Users, install the latest Git from

   http://code.google.com/p/git-osx-installer/

3. Edit the file "ASMConfig.bat" (Windows) or "asmconfig.sh" (Linux

   or MacOS X) in the folder and set the options correctly:

   Step 1: Configure Path to XBMC Skins Folder

   Step 2: Choose the Skin You Want

   Step 3: (If Needed) Configure Path to Git

4. Double-click on "ASMUpdate.bat" (Windows) or type "./asmupdate.sh"

   from your shell/terminal prompt (Linux or Mac OS X)



This will install the Aeon Skin/Mod(s) to your XBMC skins folder.



In the future, to update your Aeon Skin/Mod(s), just run "asmupdate"

according to No (4) again.



To see the last 10 changes you've just downloaded, run "asmver",

Press "space" for next page, "q" to exit.



---- Upgrading Instructions ----

1. Just delete all files and folders in your ASMUpdate folder _EXCEPT_

   ASMGIT, AAGIT, AHMGIT or APMGIT

2. Extract all the files from this new version into your existing

   ASMUpdate folder

3. Re-configure "asmconfig" accordingly



---- Running XBMCUpdate for Windows ----

1. Make sure you run XBMCUpdate from the "xbmcupdate" folder and

   update your XBMC installation successfully at least _ONCE_

   before. After that, every time you run "ASMUpdate.bat", 

   XBMCUpdate will automatically fire to update XBMC at the same

   time.



---- Notes for Normal and Advanced Users ---

a) If you wish to, you can set a schedule for the script via

   Windows scheduler/crontab. If you use a shortcut link, make

   sure that the working directory is set to the current folder

   and not your home or XBMC directories.

b) If you have add-on ASM mods or do _NOT_ wish to automatically

   update your Aeon Skin/Mod(s), just comment out the path

   to XBMC in "asmconfig".

c) You can also comment out the XBMC path if you want to keep a

   local Git copy of the skin(s) on your HDD outside of XBMC.

d) If you have difficulties using the bundled git programs,

   please install a version for your platform and configure

   GITPATH in "asmconfig" as appropriate

e) If you want to get a fresh clone, just delete the ASMGIT,

   AAGIT, AHMGIT and/or APMGIT folders and run "asmupdate" again

f) Reminder for Windows Vista and Windows 7 users:

   If you have XBMC installed in C:\Program Files\ or any other

   system folder, this script and "ASMUpdate.bat" needs to be 

   started with Aministrator priviledges. Try running this from

   an Administrator Console Prompt.



---- Notes for Technical Users ---

The thing about git is that unlike svn, it is a "distributed

version control system". Meaning that when you clone, you are

getting the _WHOLE_ repository and not just doing a checkout.

On top of that, the way git was designed, you (by default) are

supposed to be working on your own branch of the tree.



What we need to do therefore, is download or update a copy of

the respository locally, then force a checkout from our local

copy. This is close(r) in operation to SVN.



So, instead of git pull, which does fetch and merge (which can

result in merge conflicts) to our local branch, we use fetch

and checkout to force git to ignore any changes made locally.



Of course, the downside is that no merging will be performed,

and any changes you do make manually to the skin(s) _WILL_ be

overwritten. But I think for a target audience of "Just Plain

Ordinary Users" who just want to use the skin(s) and keep it up

to date, this is the right mode of operation.



---- Version History ----

20091006

* Added Aeon Phil65 (thanks Mouton!)

* Added Error Messages to error conditions - users know where it

  went wrong

* Use "asmconfig" file to set configuration options - easier setup

  for new users

* Changed Windows script to use functions - easy to add new skins

  or other mods in the future

* Standardised operation between Win/Lin/Mac versions of scripts

  - common script logic

* Updated Windows package to include xbcmupdate 0.7.9

* Should now work more seamlessly across Mac OS X 10.5 and 10.6

* Removed "asmusb", "ASMUpdateExclude.txt"



20090901

* Added XBMCUpdate support for Windows users

* Made Changes to better support MacOS X 10.5 and 10.6 users

* Fixed path bugs on Linux version



20090818

* Fixed problems related to incorrect paths after v20090814



20090814

* Modified XBMCFOLDER variable to allow for skin folders in other

  folder locations (eg. User Roaming Profile folders in Windows)



20090813

* Added Linux Ubuntu 8.04 version

* Stripped down Git on Windows and Ubuntu

* Added support for Aeon Auriga and Aeon Hitched



20090810

* Initial Release, Windows XP, Git Portable 1.6.4, Aeon Showmix



---- Credits ----

Credits to Git/MSysGit project and GitHub, without whom, this

package would not have been possible.



Credits of course to AndyBlac, djh, Hitcher, Phil and all XBMC

developers for coming up with some excellent software and the

reason for this script in the first place :)



Greetz to thread 52755 :)