forked from SamRothCA/Today-Scripts
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
modified: TodayScripts.h modified: TodayScripts.m
- Loading branch information
Showing
3 changed files
with
30 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,27 @@ | ||
#Today Scripts | ||
|
||
A widget for running scripts in the Today View in OS X Yosemite's Notification Center. | ||
|
||
##Features | ||
|
||
* [Colorized Output](http://i.imgur.com/Yvj2ePG.png). Today Scripts supports colorized terminal output from your scripts, as well as bold and underline. | ||
* [Custom Labels](http://i.imgur.com/WJPWQN7.png). Today Scripts has a form for setting up scripts, which gives you the option of picking a label to display instead of the script itself. | ||
* Custom Interpreters: When setting up a script, you may specify any program to run in place of your shell. This means you can directly run scripts in Python, Perl, AppleScript, etcetera, simply by specifying their associated interpreter. | ||
* Manually Run Scripts: Scripts may be run on command by clicking on their label. You may also specify that scripts not be run automatically when Notification Center is opened. | ||
* Output text selection: You may highlight the output of your scripts, allowing you to copy it to the clipboard or drag it where you please. | ||
|
||
##Usage | ||
|
||
After building, simply copy "Today Scripts.app" wherever you'd like to store it, then open it. In Notification Center, you will see "1 New" appear on the edit button, and you may use that to add Today Scripts to your Tdoay View in order to begin using it. | ||
|
||
To begin editing your list of scripts, click the "Info" symbol in the title of the widget. | ||
|
||
To run a script on command, click its label in your list. | ||
|
||
To edit an existing script, click the "action" button to the right of its label. | ||
|
||
##Technical Details | ||
|
||
* An interpreter can be speficied using a path to any valid executable (it need not be an "interpreter" at all). The provided script is piped to the interpreter via its standard input. | ||
* Today Scripts emulates a 40-column terminal. When running a script, a pseudo-TTY is opened for it, and the standard output and standard error of it is set to that. The `COLUMNS` environment variable for scripts is set to `40`, and `PAGER` is set to `/bin/cat`. | ||
* Today Scripts supports all ANSI color sequences; both standard and bright, as well as both foreground and background. The `TERM` environment variable for scripts is set to `ansi`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,5 +1,5 @@ | ||
// | ||
// ScriptsArray.m | ||
// TodayScripts.m | ||
// Today Scripts | ||
// | ||
// Created by Sam Rothenberg on 8/14/14. | ||
|