Difference between revisions of "SoftwareMenu"

From AwkwardTV
Jump to: navigation, search
Line 1: Line 1:
'''SoftwareMenu''' 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+ ---
'''SoftwareMenu''' 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.9.1 Is latest. Has a whole slew of new functions
  Version 1.0b1 Is latest. compatible with OS3.0.1
<br>version 0.9.0
<br>version 0.9.0
<br>April 29, 2009
<br>April 29, 2009

Revision as of 15:22, 17 November 2009

SoftwareMenu 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 1.0b1 Is latest. compatible with OS3.0.1

version 0.9.0
April 29, 2009


  1. None known

Copyright (C) 2008 Thomas Cool


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


atvusb-creator includes SoftwareMenu in its default installation. If you don't already have ssh access to your ATV, this is the easiest route. Be sure to use SoftwareMenu's self-update functionality once atvusb-creator installs it!

If you already have ssh access:

  1. Download the current version of SoftwareMenu, linked at the top of the page
  2. Extract it. This should give you a folder SoftwareMenu.frappliance.
  3. Put it on your TV (e.g. copy it to your home directory via sftp or Cyberduck)
  4. ssh to your TV and install it to the plugins folder (/System/Library/CoreServices/Finder.app/Contents/Plugins/).

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/Finder.app/Contents/PlugIns
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).
All scripts must be placed in the Documents/Scripts folder. This folder has to be created (mkdir Documents/Scripts).

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 :



Allows you to modify a lot of display features of SoftwareMenu.
also allows you to upgrade and downgrade AppleTV and patch at the same time: No More patchstick



Plugins Working

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



  • Rewritten code
  • improved updater
  • compatible with OS 3.0-3.0.1
  • Media Shelf


  • New Photos Mode
  • Custom screensaver
  • Tweaks menu
  • Installs Perian
  • Installs Rowmote for AppleTV
  • Improved updater
  • All around improvements
  • Beautified


Works for 2.0.2 to 2.3.1 OS Upgrader/Downgrader FrapMover... and more


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 http://www.gnu.org/licenses/


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