Previous: Managing tools | Up: User-defined Tools | Next: Lua scripts

### Storing tools in files

It is possible to create tools without using the Preferences dialog, they can be stored in files in `tools` subfolder of the medit data folders (or `tools-context` for tools which appear in the document context menu). In particular, on Unix systems you can place files into `$HOME/.local/share/medit/tools/` folder.

Names of the files in the `tools` folder are used as their menu item labels, after stripping first three characters, so you can use trhee-character prefix to affect the order of the menu items, e.g. you can have `00-Do Something`, `01-Another tool` files to have them in that order in the menu. The files may be of three types: files with extension "`.py`", they will be used as Python scripts; files with extension "`.lua`", they will be used as Lua scripts; and executable files, they will be executed in the same way as shell commands.

To set parameters for a tool, place them on the first or the second line of the file in the following format:

    !! key=value; key=value; ... !!

key may be one of the following:

`position` | it can be `start` or `end`, and defines whether the menu item will be located at the start or at the end of the menu.
`id` | the tool identificator.
`name` | the tool name, i.e. the label used in the menu item. Overrides the file name.
`os` | `windows` or `unix`. If specified, then the tool will not be used when medit is running on a different operating system.
`accel` | default keyboard accelerator used to invoke this tool.
`menu` | the menu to place this tool into. By default the tools are located in the Tools menu, but they can be as well put into any other menu.
`langs` | comma-separated list of languages for which this tool will be enabled.
`file-filter` | defines for which files this tool will be enabled. The value has the same format as in the Preferences dialog.
`options` | same as the Options entry content in the Preferences dialog.

In addition to these, you can set input and output options for executable files:

`input` | can be `none`, `lines`, `selection`, or `doc`.
`output` | can be `none`, `async`, `pane`, `insert`, or `new-doc`.
`filter` | the output filter name.

Previous: Managing tools | Up: User-defined Tools | Next: Lua scripts