LibrarySE 'ReadMe.txt'
"LibrarySE" Plugin for Script Editor # # # # # # # # # # # # # # # # # # # # # # # # # Author: Jed Green (jobu10000@yahoo.com) # beta version 0.9.4 # public release date: 12.19.06 # # # # # # # # # # # # # # # # # # # # # # # # # # Please read all of this document before # installing the plugin for important # information about installation and # uninstallation of LibrarySE. # # # # # # # # # # # # # # # # # # # # # # # # # # Thanks to Jon Nathan for helping with # beta testing and conceptual issues. # # # # # # # # # # # # # # # # # # # # # # # # Release Notes: ----------------------- Version 0.9.4: - Now distributed as a universal Binary for intel compatibility # # # # # # # # # # # # # # # # # # # # # # # Beta Version Notes: ----------------------- Although I have tested the plugin extensively, it is impossible to work out all bugs and undesirable side-effects during development. Please take the time to use the plugin, checking out all of the features and User Interface elements. Pay particular attention to how the plugin manages data and displays items. If you find any behaviors that are unexpected or destructive, PLEASE report them to "jobu10000@yahoo.com". Any suggestions, comments, or complaints are welcome from all users. If you are concerned about the data in your current Library, I encourage you to make a backup copy of your Script Editor plist file located at "~/Library/Preferences/com.apple.ScriptEditor2.plist", before you install the plugin. If you find that LibrarySE causes any problems or you just wish to restore the library to it's state before using the plugin, simply quit script editor, move the backup copy back into the preferences directory, and restart script editor. # # # # # # # # # # # # # # # # # # # # # # # Requirements: ----------------------- - Script Editor 2+ - OSX 10.3+ Discussion: ----------------------- The LibrarySE plugin creates a new menu in Script Editor's main menu bar, titled "Library". It lists all of your Library items in the main menu, rather than in the annoying, inaccessible window used in Apple's library plugin. It uses the same dictionary of scriptable applications and osax that the pre-installed library plugin uses. Compatibility Notes: ----------------------- Although the LibrarySE plugin is intended for use as a replacement for Apple's pre-installed library plugin, it does not disable or uninstall the Apple Library plugin. Since Apple's library plugin is bundled in the Script Editor application itself, it is up to users to risk removing it. It will work simultaneously with the Apple plugin, but using both at the same time may result in conflicts that the author can not fully predict. It is recommended that LibrarySE plugin users do not use both library plugins at the same time. Installation: ----------------------- The plugin is distributed with a small applescript application that will install and/or update the plugin automatically. Simply launch the "Install LibrarySE" applet and follow the instructions. LibrarySE can also be easily installed manually. The plugin can be installed in one of two locations, depending on which users will have access to the plugin. To install the plugin globally (i.e. for all machine users) it should be installed in the directory... "/Library/Application Support/Apple/Script Editor/" If the plugin is to be installed only for individual users, each user should install it in the directory... "~/Library/Application Support/Apple/Script Editor/" The '~' in the path above represents the path to your user Home folder (i.e. '/Users/YOU/'). After installing the plugin, restart Script Editor. If you have installed the plugin in one of the approved locations, you should be alerted that a new plugin has been detected, and prompted to confirm that you wish to enable the plugin. *** NOTE *** The directories listed above may not (and probably will not) exist when you go to install the plugin. Since there aren't many Script Editor plugins available, Apple does not create it by default, but rather leaves it to individual users to create them if needed. If the directory you choose to install in does not already exist, you must create any directories listed in the destination directory as necessary. Uninstalling LibrarySE: ----------------------- Depending on the location in which you installed the plugin (as outlined in the "installation" section above), simply remove the plugin from the installation directory. Script Editor will also automagically add miscellaneous plist entries to your script editor plist file (as described in "Beta Version Notes" above) that record window locations and other default settings for the plugin. These entries will not effect Script Editor after uninstalling the plugin, although you may wish to look through the plist file and delete any you find manually, or create a backup of the file before installing the plugin and then restore that backup after uninstalling. As noted in the "Installation" section above, Script Editor will confirm that you wish to enable the LibrarySE plugin after installing it. Plugins can be managed in the "Plug-ins" tab in Script Editor's Preferences. Script Editor records the current plugins and their status in it's plist file under the key "PluginPreferences". If you uninstall the plugin, it will remain listed in the plugins pane in Script Editor's preferences. To remove it from this list, delete the "LibrarySE" key/value pair from the "PluginPreferences" plist dictionary entry in the Script Editor preference file. After performing any/all of the desired procedures outlined above, restart Script Editor to confirm 'uninstallation'. # # # # # # # # # # # # # # # # # # # # # # # Disclaimer: ----------------------- I have made every attempt to make sure that this software does what it's supposed to, and doesn't cause any problems, crashes or data loss. I have tested this software on OSX version 10.4.3 and 10.3.9, using script editor versions 2.1.1 and 2.0. Until more beta testing has been done, I can not say with any certainty that this software will not cause any undesirable problems. Please use this software with caution and an open mind :-), and back up copies of your script editor plist file as you feel is necessary. The author is not responsible for any loss of data, profits, or sleep caused by the use of this software.
LibrarySE ‹
Home ‹
