From AwkwardTV
Revision as of 00:28, 17 November 2008 by Tomcool420 (talk | contribs)
Jump to: navigation, search

Software is an AppleTV (ATV) plugin that allows the user to manage plugins, enables hiding of original scripts, downloading of new scripts and so forth. WORKS ONLY ON TV 2.0+ ---

Version 0.74 Should work perfectly on 2.2 AND 2.0 (and of course 2.1 and 2.0.2)

version 0.74
November 5, 2008


  1. In the version before 0.73, you must execute FixPerm in the Scripts Menu,
  2. if you are running version<2.1 scripts menu will not work (before 0.73) and you must run the FixPerm Script in it resources Folder: you can also call it form the command line as shown later in this file

Copyright (C) 2008 Thomas Cool


If Something doesn't work, especially right after install, use FixPerm under scripts


  1. download the file SoftwareMenu-0.74.tar.gz,
  2. extract it this should give you a folder SoftwareMenu.frappliance
  3. put it on your TV
  4. install it to the plugins folder (/System/Library/CoreServices/

If you have software menu installed >=0.61 you should be able to update it from within softwaremenu



from now on, SoftwareMenu will be updatable from within itself.


here is the script for people running TV OS<2.1 & SM<0.73
echo "frontrow" | sudo -S mount -uw /
cd /System/Library/CoreServices/
sudo chown -R root:wheel SoftwareMenu.frappliance
sudo chmod u+s SoftwareMenu.frappliance/Contents/Resources/installHelper


3rd Party

select Check for updates

select refresh (handles redrawing of menu)
select plugins and do your stuff
in the plugin menu itself, the only time you should use refresh is after installing Important Note: to have the plugins show or be removed, you have to restart Finder


Simply allows to show and hide builtin fraps (except settings ...)


same functionality as Iscripts except that you don't need to create the .plist anymore (handled using a NSFileManager)
has two execution modes:

  1. Fire and Forget (FaF), which launches the script in the background
  2. Fire and Wait (FaW), wait for output Pipe and error Pipe and then displays them at completion of task

    The left arrow changes script settings too
  1. a check mark will allow the scripts to be displayed on the main menu
  2. Removing the check mark will remove it form the main menu


The first three options allow you to hide or show the menus
enable auto restart finder after popping out of a frap menu (after doing a change)
add untrusted (manually added sources)


There is a special trick to this. you can add them in the settings menu. please make sure that the url actually exists (not tested to see what happens otherwise. there is an example available for you guys: type in :

Plugins Working

  1. nitoTV
  2. CouchSurfer
  3. Sapphire
  4. XBMCLauncher
  5. SoftwareMenu
  6. ATVFiles
  7. And anything else people want



Bug Fixes Software Menu now shows Permanently


2.0 Somehow works now
Interface upgrades
settings upgrade
better coding
scripts can now be displayed on the main menu


2.2 Virtual Keyboard fix
2.2 hashValue fix
scripts menu fix
some more small updates


Added manual sources much improved interface settings menu


stupid bug fixes


script functionality added
Trusted sources added
uses setuid tool now
looks nicer
can update itself
handles zip files
handles .pkg installers


bug fixes


initial release


  1. add settings menu
  2. add option of adding scripts to main menu for quick execution
  3. only a couple of plugins work for the moment - solved all trusted added
  4. it will download nito but it doesn't install it yet... on the flip side you can hide it and so forth -- nito works perfectly
  5. need to support extraction of zip files and installing self installers -done
  6. PLEASE tell me if there are any problems



Copyright (C), 2008 Thomas Cool iScripts is licensed under GPL3. The full license can be found in LICENSE.txt.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see


Thanks to person who made FRAppliance 200 which in turn is based on the work of alan_quatermain
thanks to nito/|bile| for the insane amount of help
thanks to gbooker who didn't laugh at my stupid questions in the forum
thanks to emulators frappliance which was my first concrete example for a menu
If i forgot someone, please feel free to yell at me in a PM