SoftwareMenu

From AwkwardTV

Jump to: navigation, search

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.0b2.1 Is latest. compatible with OS3.0.1

THIS PAGE NEEDS TO BE UPDATED
http://appletv.tomcool.org/

SoftwareMenu
version 0.9.0
April 29, 2009
http://iscripts.googlecode.com/files/SoftwareMenu-1.0b2.1.zip
http://iscripts.googlecode.com/files/SoftwareMenu-1.0b1.run


BUGS:

  1. None known

Copyright (C) 2008 Thomas Cool

Contents

Note

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

Installation

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

Notes

Updating

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

FixPerm

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

Usage

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

Builtin

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

Scripts

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

Settings


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)

Untrusted

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 :

http://web.me.com/tomcool420/Emulators.plist

Settings


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

FrapMover


Guess.

Plugins Working

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

Changes

1.0b1

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

0.9.0

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

0.8

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

0.74

Bug Fixes
Software Menu now shows Permanently

0.73

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

0.71

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

0.7

Added manual sources much improved interface settings menu

0.61-62

stupid bug fixes

0.60

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

0.51


bug fixes

0.5


initial release

TODO

  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

License

THIS IS NOT TO BE COMMERCIALLY DISTRIBUTED WITHOUT AUTHOR PERMISSION


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/

Acknowledgements

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

Personal tools