# @robbplo/hyperterm-summon

> Summon your Hyperterm windows with a system-wide hotkey

Latest version **2.0.10** (published 2020-01-18) · ISC license · 0 weekly downloads

## Install

```sh
npm install @robbplo/hyperterm-summon
pnpm add @robbplo/hyperterm-summon
yarn add @robbplo/hyperterm-summon
bun add @robbplo/hyperterm-summon
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.10 |
| Published | 2020-01-18 |
| First published | 2020-01-18 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 21.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | John Soutar |
| Maintainers | robbplo |
| Keywords | hyper, hyper.app, hyper-plugin, plugin, hotkey, shortcut, global, system, focus, summon |

## Links

- npm: https://www.npmjs.com/package/@robbplo/hyperterm-summon
- Repository: https://github.com/robbplo/hyperterm-summon
- Homepage: https://github.com/robbplo/hyperterm-summon#readme
- Issues: https://github.com/robbplo/hyperterm-summon/issues
- npm.io page: https://npm.io/package/@robbplo/hyperterm-summon

## Dependencies (2)

- [lodash](https://npm.io/package/lodash.md) ^4.17.11
- [hyperterm-register-shortcut](https://npm.io/package/hyperterm-register-shortcut.md) ^1.3.0

## Alternatives

- [unionfs](https://npm.io/package/unionfs.md) — 2.2M weekly downloads
- [path-starts-with](https://npm.io/package/path-starts-with.md) — 35.9K weekly downloads
- [redzip](https://npm.io/package/redzip.md) — 1.2K weekly downloads
- [vscode-anymatch](https://npm.io/package/vscode-anymatch.md) — 848 weekly downloads
- [@ledgerhq/coin-filecoin](https://npm.io/package/@ledgerhq/coin-filecoin.md) — 793 weekly downloads

## Recent versions

- 2.0.10 (latest) — 2020-01-18
- 2.0.9 — 2020-01-18

## README

# hyperterm-summon

[![Build Status](https://travis-ci.org/soutar/hyperterm-summon.svg?branch=master)](https://travis-ci.org/soutar/hyperterm-summon)
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg)](https://github.com/prettier/prettier)

Summon your Hyper windows with a system-wide hotkey.

In a multi-window situation, hyperterm-summon will remember the last active
window and restore focus to it.

If Hyper is already active when the hotkey is pressed, your terminal windows
will be hidden and (on macOS only) your previously-active application will
regain focus.

## Installation

Use the Hyper CLI, bundled with your Hyper app, to install hyperterm-summon
by entering the following into Hyper:

```bash
hyper i hyperterm-summon
```

## Options

| Key          | Description                                             | Default  |
| ------------ | ------------------------------------------------------- | -------- |
| `hideDock`   | Hide the Hyper icon in the dock and app switcher.       | `false`  |
| `hideOnBlur` | Hide Hyper when the windows lose focus.                 | `false`  |
| `hotkey`     | Shortcut<sup>1</sup> to toggle Hyper window visibility. | `Ctrl+;` |

## Example Config

```js
module.exports = {
  config: {
    summon: {
      hideDock: true,
      hideOnBlur: true,
      hotkey: 'Alt+Super+O',
    },
  },
  plugins: ['hyperterm-summon'],
};
```

<sup>1</sup> For a list of valid shortcuts, see [Electron Accelerators](https://github.com/electron/electron/blob/master/docs/api/accelerator.md).

---
_Source: https://npm.io/package/@robbplo/hyperterm-summon · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
