Giraffe+ Manual
This document describs concisely easy usage of Giraffe+ with default settings.
The input string is represented as String, and the keyboard shortcuts are represented as Key.
To view the list of scripts which are available in the Settings Dialog, refer to settings_en.xml.
To know basic software information which contains the working environment or requirements, refer to the readme.
When you want to ask anything about Giraffe+, feel free to email me.
Tutorial
You will understand the basic functions and operations through this tutorial.
Registering Internet Explorer and use the registerd item
You learn how to input a file path and to deal the registered items.
-
Inputting C:\Program Files\Internet Explorer\IEXPLORE.EXE
- Type C:\ to the input window. The files and folders which exist in the C:\ are shown in the Listbox.
- Type p. Only ones whose name starts with p are shown
- As the input text becomes automatically C:\Program Files, type \. (When that doesn't happen, type remaining rogram Files or select the text from the Listbox)
- Files and folders which exist in the C:\Program Files\ are shown in the Listbox as typing C:\.
- Repeat such a operation, and make the input text C:\Program Files\Internet Explorer\IEXPLORE.EXE.
-
Registering C:\Program Files\Internet Explorer\IEXPLORE.EXE
- Type Alt+A as the input text is C:\Program Files\Internet Explorer\IEXPLORE.EXE. The dialog whose elements are filled is shown.
- Type Enter without editing the elements. Ineternet Explorer is registered as IEXPLORE.
-
Clearing the input text
- Type Esc to clear the input text.
-
Inputting the registered IEXPLORE
- Type i. IEXPLORE is shown.
-
Executing the registered IEXPLORE
- Enter as the input text is IEXPLORE. C:\Program Files\Internet Explorer\IEXPLORE.EXE is executed.
- After execution, the main window of Giraffe+ is hidden.
-
Showing and hiding the main window
- Type Win+Space. The main window is shown again.
- Type Esc. When the input text is empty, the main window is hidden.
- Type Win+Space. When the main window is visible, whether the input text is empty or not, the main window is hidden.
-
Accessing C:\Program Files\Internet Explorer\IEXPLORE.EXE from the registered IEXPLORE
- Type \ as the input text is IEXPLORE. C:\Program Files\Internet Explorer\IEXPLORE.EXE is shown in the input window.
-
Accessing C:\Program Files\Internet Explorer\ from the registered IEXPLORE
- Type Ctrl+\ as the input text is IEXPLORE. C:\Program Files\Internet Explorer\ is shown in the input window.
-
Accessing C:\Program Files\Internet Explorer\ from C:\Program Files\Internet Explorer\IEXPLORE.EXE
- Type Ctrl+\ as the input text is C:\Program Files\Internet Explorer\IEXPLORE.EXE. C:\Program Files\Internet Explorer\ is shown in the input window.
-
Accessing C:\Program Files from the registered IEXPLORE
- Type Ctrl+Shift+\ as the input text is IEXPLORE. C:\Program Files\Internet Explorer is shown in the input window.
- Type Ctrl+Shift+\ again. C:\Program Files is shown.
-
Renaming the registeredIEXPLORE to IE
- Type Ctrl+R as the input text is IEXPLORE. The rename dialog is shown.
- Replace the input text IEXPLORE with IE. And type Enter.
- Type i and see that IE is shown.
-
Deleting the registered IE
- Type Ctrl+Delete as the input text is IE. The registered shortcut is deleted as typing Delete with Explorer. (Whether the confirmation dialog is shown or not depends on the settings of Windows.)
- Type i and see that IE isn't shown.
Making a Google-search hotkey with the Settings Dialog
You learn the Settings Dialog, the hotkey and polymorphism of Giraffe+.
-
Opening the Settings Dialog and showing the hotkey list
- Type F5. The Settings Dialog is shown.
- Type Right. The Settings tree opens.
- Type Down twice. The hotkey is selected and the hokey list is shown in the right pane.
-
Enabling Google Mode
- Selects "w-g google-mode Google Mode" and type Space. The item is checked.
- Type Enter. The settings are automatically refreshed and reloaded.
-
Using Google Mode
- Type Win+G. Whether the main window of Giraffe+ is visible or not, the window is shown with the icon of Google.
- Input some words
- Type Enter. The search result of Google is shown with the default browser.
Showing the readme in the Listbox of Giraffe+
You learn how to read a text file with Giraffe+.
-
Showing the directory of Giraffe.exe
- Type F9. The input text becomes The directory where Giraffe.exe exists\.
-
Showing the readme
- Type Alt+V as the input text is The directory where Giraffe.exe exists\readme_jp.txt. The text of the readme file is shown in the Listbox.
-
Scrolling the Listbox without selecting a Listbox item
- Type Ctrl+PageUp to scroll up, type Ctrl+PageDown to scroll down.
Converting hexadecimal to decimal, decimal to binary and binary to hexadecimal back
You learn the base number conversion of the main menu.
-
Inputting a hexadecimal number
- Input 0xff to the input window.
-
Converting hexadecimal to decimal with the main menu
- Type Apps. The main menu is shown.
- Type N, D to select Base Number Conversion and then Dec.
- See that 0xff of the input window is changed into 255.
-
Converting decimal to binary and converting binary to hexadecimal back
- Select Bin in Base Number Conversion of the main menu.
- See that 255 is changed into 11111111.
- Type Home, 0 and B to add 0b to the head of text. The input text becomes 0b11111111.
- Select Hex in Base Number Conversion of the main menu.
- See that 0b11111111 is changed into ff.
Creating a file and a folder, and copying and deleting them
You learn how to manipulate files.
-
Creating a folder in the desktop
- Input :: (two colons).
- Type Ctrl+Shift+N. The folder creation dialog is shown.
- Input giraffe_test and type Enter to send OK to the dialog.
-
Creating a file in the created folder
- Type Ctrl+N as the input text is ::\giraffe_test.
- Input file to the shown dialog and type Enter.
-
Copying the created file
- Type Ctrl+Shift+C as the input text is ::\giraffe_test\file. The file is copied into the clipboard
- Type Ctrl+Shift+\ to make the input text ::\giraffe_test and type Ctrl+Shift+V to paste the file.
- See that the file is copied into ::\giraffe_test.
-
Deleting the created folder
- Type Ctrl+Delete as the input text is ::\giraffe_test. The giraffe_test folder is sent to the recycle bin.
Keyboard Shortcut
Those are the basic keyboard shortcuts. You can find more keys in the settings_en.xml.
- EnterExecute
- Shift+EnterOpen a folder
- Alt+EnterShow properties
- Ctrl+EnterShow the shell context menu (the file menu of the Windows Explorer)
- Alt+ARegister an item
- Ctrl+TabChange icon visiblity
- Shift+TabToggle a function which hides the Giraffe+ after execution
- AppShows the main menu
- F1Invoke the input text as a script
- F2Reload settings
- F3Save settings
- F4Open or close the Listbox
- F5Open the settings dialog
- \Change a registered item text into a file path
- Ctrl+\Change a registered item text into a folder path where the file exists
- Ctrl+Shift+\Change the input path into a folder of the path
- Alt+MToggle a mark of the selected Listbox item
- Alt+Shift+MToggle marks of all Listbox items
- Ctrl+PCopy a file path
- Ctrl+Shift+PShow the menu which copies a file path
- Ctrl+NCreate a file
- Ctrl+Shift+NCreate a folder
- Ctrl+Shift+CCopy a file
- Ctrl+Shift+XCut a file
- Ctrl+Shift+VPaste a file
- Ctrl+DeleteSend a file to the recycle bin
- Ctrl+Shift+DeleteDelete a file without sending to the recycle bin
Drag and Drop
You can use the both Drang and Drop from and to Giraffe+.
-
Registering a file with dropping to Giraffe+
- Dropping a file to the main window of Giraffe+, the registered item creation dialog is shown.
-
Inputting a text with dropping to Giraffe+
- Dropping a file with pressing Ctrl, the file path is input.
-
Dragging from Giraffe+
- Drag the input window as the input text is a file path. (When the main window moves, you are grabbing the frame of the window.)
- When there is a mark in the Listbox, the marked file is dragged.
Settings Dialog
About the dialog which is shown by F5.
-
Editting a value
- The pages Settings::key, Settings::hotkey and Config are editable. To edit a value, select an item and type F2.
-
Representation of keyboard shortcuts
- The delimiter of a modifier key and a key is the '-' (minus) instead of the '+' (plus).
- Modifer keys are represented as a initial. For example: Ctrl+V = c-v
- Multiple modifer keys are concatenated. For example: Ctrl+Shift+V = cs-v
- Many keys other than alphabet and number keys are given multiple key names. Key names are based on general names, printed names of the Japanese 109 keyboard, VK_ definition of WinUser.h etc. Also, key codes can be specified directly.
- Japanese keyboard names can be an issue. For example, the backslash on the US standard keyboard can be specified as one of 0xdc, \1, yen or oem_5. (Note "backslash" isn't included.) Instead, the angle bracket key or the backslash key on RT 102-key keyboard can be specified as 0xe2, \2, \, backslash or oem_102.
- There is a list of the key names in doc/keymaps.txt.
Unsorted Information
Information in old documents which is, though worth noting, hard to explain concisely and to get across easily is left here.
List Item Marking
It is possible to execute multiple items with marking Listbox items.
Alt+M marks/unmarks the selected Listbox item, and Alt+Shift+M marks/unmarks all items. Shfit+Up/Down can mark and Ctrl+Shfit+Up/Down can unmark as selecting.
For example, marking with Alt+Shift+M and executing properties with Alt+Enter, the same effect as Alt+Enter with multiple selecting in the Windows Explroer occurs.
When multiple items are marked, Ctrl+P copies the marked files separated by a new line into the clipboard, and Alt+A acts as dropping multiple files.
ShellExecute
In Windows, the file execution consists of five elements.
- File which is executed
- Parameter
- Working Directory
- Verb
- Window State
In Giraffe+, the string separated by ';' (semicolon) is used to specify those elements. Specify the elements in the above order as file;parameter;working directory;verb;show window.
When the file which is executed is the registered item, the parameter is added to the parameter of the registered item with space. Except parameter, elements are simply overwritten if specified.
What is the verb? It is menu items which shows when right clicking a file in the Windows Explroer.
There are standard ones which are provided by Windows and associations which are registered in the registory.
The copy, paste, properties etc. are the Windows standard.
The open, edit, print etc. are the associations by the Windows default.
The verb names are key names listed in "HKEY_CLASSES_ROOT\[file extention]\shell".
The windows state is specified as number: 1 is normal, 3 is maximized and 7 is minimized.
Shell Namespace
The virtual space of Windows whose root is the desktop you can see in Explorer or file dialogs is the Shell Namespace.
There are some folders which don't exist in the file system such as My Computer and Control Panel.
In Giraffe+, strings which start with "::\" is called as Display ITEMIDLIST, and strings start with "::-" is called as Numeric ITEMIDLIST.
Addresses of the Shell Namespace item are represented by them.
Display ITEMIDLIST doesn't works completely when a file or folder name contains '\', which is used as the separator, or the same name items exist in the same foler.
Numeric ITEMIDLIST works completely because it represents ITEMIDLISTs, which are arrays of bytes, as numbers separated by '-'.
For example, say you want to access Control Panel.
Inputting '::\', items in the desktop are autocompleted, so you can access Control Panel as with Windows Explorer.
You can also access Control Panel with only typing some characters of "Control Panel" and '\' if you register the Control Panel with Alt+A.
SES
When registering an item, an registered shortcut will be a SES file, which is a shortcut file represented as a INI file, if you make Type ".ses".
When you want to specify the verb in a shortcut file or feel that it is slow to read LNK files, using SES files is worth trying.
Adding the string CreateShortcut.Type="ses" to [Shell] section in Giraffe.ini, the default value of Type in the dialog which is shown by Alt+A is ".ses".
Script in Data
You can put scripts in the registered items directory.
For example, make a script which searchs the parameter with Google.
Save the below four lines as Google.giraffe in .\Data.
(Search with Google)
(google.ico)
include((www))
Shell.Execute(cat((http://www.google.com/search?q=)www:url-encode(param(0))))
The first line is the description of the script. The second line is the name of an icon which shows as a registered item.
The third line is the include to use www:url-encode in the forth line.
The forth line does shell-execution (Shell.Execute) the URL which are made by concatenating (cat) the URL of Google and the first argument (pram(0)) which is url-encoded (www:url-encode.)
Though you have to put the icon in .\Icon as google.ico with downloading from http://www.google.com/favicon.ico,
you can accomplish this work automatically with the script included in Giraffe+.
Input @download-google-icon and type F1 to use the script.
Because it is possible to specify an icon as URL, such a work isn't necessary if you do so.
Settings and Settings Dialog
-
What the dialog lists (Representation of the path is the regular expression.):
- Settings = (Script2|Script)/settings/(key|hotkey|setup)/.*\.giraffe$
- Config = contents of doc/reference/config-list.csv
- Color = contents of Color.ini
-
Where the settings are dealt:
- Settings = Script/settings.giraffe
- Config = LoadConfig and SaveConfig in Script/Default.giraffe
- Color = ChangeColor in Script/Default.giraffe
-
Files the settings are saved in:
- Settings = Settings.ini
- Config = Giraffe.ini
- Color = Color.ini
-
Order of invoking scripts:
- Those are invoked in incasesensitive alphabetical order.
- Take the order into account if you want to redefine events or functions partly.
-
Editing scripts with the menu:
- Because scripts are overwridden, how the menu works seems odd.
-
Examples:
- Deleting a script in Script2, a script in Script gets visible.
- It is possible to create a script whose name exsits already in Script
- The both examples change only Path values in the dialog.
- A new script is created always in Script2.
- Edit This Script executes Notepad.exe, or the file path in the variable $settings:editor.
-
Editing values:
- In Config and Settings/(key|hotkey), you can edit a value with F2 key or clicking the selected item.
-
In key and hotkey, it is disabled to input a key listed below.
- Keys already defined.
- Strings unable to recognize as a key.
Examples (The key string as mod-key.):
- Mod has except c, s, a, w, *, ? and !.
- Key has a string which can't be converted into an internal keycode.
- Strings which can be converted into a keycode are defined internally and it is impossible to be defined by users.
- Specify a keycode directly when you want to use a key you don't know a name.
- Values of Config isn't verified by the dialog.
- You can use Preset buttons in Config to configure easily, though roughly. This doesn't affect except Config.
Website: http://www.ric.hi-ho.ne.jp/giraffe/index_en.shtml
Blog (Japanese): http://d.hatena.ne.jp/ijuhs/
Mail: shu@freemail.lt