Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 94 lines (53 sloc) 4.357 kB
d5e8839 @orangeraven initial commit
orangeraven authored
1 # Finder Toolbar Items
2
a81dd26 @orangeraven documentation: + Installation , + Odds and Ends
orangeraven authored
3 A collection of scripts & icons for Finder.app toolbar items (droplets & applets) and a Rakefile to produce the corresponding .app's.
d5e8839 @orangeraven initial commit
orangeraven authored
4
a81dd26 @orangeraven documentation: + Installation , + Odds and Ends
orangeraven authored
5 ## Installation
6
7 There are two ways to use this:
8
9 1. The I-Just-Want-To-Use-This way
10
11 * download a pre-built archive from the [project's Github Downloads](http://github.com/Orangenhain/Finder-Toolbar-Items/downloads) page
12 * unpack it to somewhere you feel comfortable with
13 * drag & drop the files into your Finder's toolbar
14
15 2. The DIY way
16
17 * clone the repository
18 * `cd` to resulting directory & maybe modify the icons or scripts
19 * run `rake` - this will result in all the toolbar items being built into a folder specified in the Rakefile
20
21 You can also run `rake "toolbar item name"` to just get a specific item.
22
23 Change the `DROPLET_DIR` constant in the Rakefile to have the resulting items be built into a directory of your choosing. The path is relative, i.e. using `../toolbar-items` is possible.
24
503e8be @orangeraven documentation: + description for each toolbar items
orangeraven authored
25 ## Description of Items
26
27 ### Open in GitX
28
29 Click on it, to open the directory of the current Finder window in GitX.
30
31 ### Open in iTerm
32
33 Click it to open the directory of the currently selected file in an iTerm tab. If the selection is a directory, it will open the directory. If there is no selection, it will open the directory of the current Finder window.
34
35 Drop a directory on it have it open in an iTerm Tab.
36
37 ### Open in {SubEthaEdit,TextMate}
38
39 Click to open current Finder selection in your favourite editor. If there is no selection, uses the directory of the current Finder window.
40
41 Also opens items dropped on it.
42
43 ### Open in Xcode
44
45 Tired of looking for the `*.xcodeproj` file in a directory to open the project? Just click on the little item, and it will automatically open it for you.
46
47 If you have selected a folder, it will `cd` into it, and look there. Works with multiple selections.
48
49 Also works with dropped items.
50
51 TODO: If a file is selected, don't just ignore it. Instead, look for a .xcodeproj in its containing directory.
52
53 ### Open Terminal Here
54
55 Quoting from the projects ReadMe:
56
57 Clicking it opens a new Terminal window and changes directory to the location of the selected file/folder. Drag and dropping items on the icon opens one Terminal window per item.
58
59 Holding down the ⌘ key opens tabs instead of windows.
60
61 Holding down the ⌥ key changes directory in the front-most Terminal window instead of opening a new one. When the frontmost window is busy it opens a new window/tab (depending on the state of the ⌘ key)
62
63 Shows how to use modifier keys in scripts. If someone knows of an easier way, please let me know.
64
65 ### Zsh glob select
66
67 Click on the toolbar item to get a window where you can enter a globbing-string (as in `*.h`). On Enter the script will select all files matching the glob in the current Finder window.
68
69 Modified version of the [lselect](http://anoved.net/software/lselect/) script. This will use Zsh to evaluate the globbing-string, for more information see <http://michael-prokop.at/blog/2008/12/24/mikas-advent-calendar-day-24-zsh-globbing/>.
70 Be careful with strings that will match files in subdirectories (e.g. `**/build(/)`), as the script will open the window necessary to see the match.
71
a81dd26 @orangeraven documentation: + Installation , + Odds and Ends
orangeraven authored
72 ## Odds and Ends
73
74 There is a `_droplet.png` file in the repository you can use to create your own droplet icons.
75
76 If someone has a higher-resolution of that image, please let me know.
d5e8839 @orangeraven initial commit
orangeraven authored
77
503e8be @orangeraven documentation: + description for each toolbar items
orangeraven authored
78 If there is no matching \_name\_.icns for a \_name\_.applescript, the Rakefile will leave the default icon in place.
79
bf046f9 @orangeraven documentation: + proper credits
orangeraven authored
80 ## Credits & Contributors
d5e8839 @orangeraven initial commit
orangeraven authored
81
bf046f9 @orangeraven documentation: + proper credits
orangeraven authored
82 * Jim DeVona -- <http://anoved.net/lselect.html>
83 * Simon Dorfman -- <http://snippets.dzone.com/posts/show/1037>
84 * JiHO -- [Github](http://github.com/jiho) , <http://maururu.net/2007/enhanced-open-terminal-here-for-leopard/>
85 * Marc Liyanage -- [Github](http://github.com/liyanage) , <http://www.entropy.ch/software/applescript/welcome.html>
86 * Henrik Nyh -- [Github](http://github.com/henrik) , <http://henrik.nyh.se>
87 * roddi -- [Github](http://github.com/roddi)
88
89 & probably a lot more people who helped, or whose code I found on the Internet.
90 Thank you all!
91
92 In case I missed someone who wants to be mentioned, just contact me, and it will be done.
93 If you don't want to see your name / code here, let me know and it will be removed.
Something went wrong with that request. Please try again.