to.shell_command

shell_command executes the shell command.

Examples

Open application

{
    "description": "Open Safari by right_command+s",
    "manipulators": [
        {
            "type": "basic",
            "from": {
                "key_code": "s",
                "modifiers": {
                    "mandatory": ["right_command"],
                    "optional": ["caps_lock"]
                }
            },
            "to": [{ "shell_command": "open -a 'Safari.app'" }]
        }
    ]
}

Execute shell from file

💡 How to use this example

{
    "description": "Execute hello.sh by right_command+s",
    "manipulators": [
        {
            "type": "basic",
            "from": {
                "key_code": "s",
                "modifiers": {
                    "mandatory": ["right_command"],
                    "optional": ["caps_lock"]
                }
            },
            "to": [{ "shell_command": "/bin/sh ~/opt/shell_commands/hello.sh" }]
        }
    ]
}

Advanced topic

The very limited environment variables are passed to the command, $HOME, $UID, $USER, etc.

Export environment variables in shell_command if your commands depend them.

For example, the following command does not work well with unicode characters because tr command depends the current locale.

{
    "to": [
        {
            "shell_command": "pbpaste | tr '[:upper:]' '[:lower:]' | pbcopy"
        }
    ]
}

You have to set LC_ALL in shell_command in this case.

{
    "to": [
        {
            "shell_command": "export LC_ALL=en_US.UTF-8; pbpaste | tr '[:upper:]' '[:lower:]' | pbcopy"
        }
    ]
}