A complete and customizable solution for a permanent, dropdown, hotkey and overlay window in your Hyper.app


Keywords
hyperterm, hyper.app, hyper, terminal, overlay, hotkey, window, visor, iterm, guake, yakuake, dropdown, iterm2
License
MIT
Install
npm install hyperterm-overlay@0.4.0

Documentation

HyperTerm Overlay

A complete and customizable solution for a permanent / dropdown / hotkey / overlay window in your Hyper.app, accessible via hotkeys and/or toolbar icon (tray).

Important: Designed for Hyper.app >= 0.7.0

home2

Install

Edit your ~/.hyper.js (Cmd+,) and insert the hyperterm-overlay in your plugins array:

plugins: [
  'hyperterm-overlay'
],

Configuration

Add overlay in your ~/.hyper.js config. The configuration below shows all possibilities with their respective default values.

module.exports = {
  config: {
    // other configs...
    overlay: {
      alwaysOnTop: true,
      animate: true,
      hasShadow: false,
      hideDock: false,
      hideOnBlur: false,
      hotkeys: ['Option+Space'],
      position: 'top',
      primaryDisplay: false,
      resizable: true,
      startAlone: false,
      startup: false,
      size: 0.4,
      tray: true,
      unique: false
    }
  },
  //...
};

alwaysOnTop

  • Value: true or false
  • Default: true
  • Makes Hyperterm Overlay window stay always on top.

animate

  • Value: true or false
  • Default: true
  • Enable animation when show and hide the window.

hasShadow

  • Value: true or false
  • Default: false
  • Controls the default macOS window shadows.

hideOnBlur

  • Value: true or false
  • Default: false
  • Hides the HyperTerm Overlay when it loses focus.

hideDock

  • Value: true or false
  • Default: false
  • Removes the HyperTerm dock icon. It works only when the unique option is activated.

hotkeys

  • Value: array of hotkey strings
  • Default: ['Option+Space']
  • Specify one or more hotkeys to show and hide the HyperTerm Overlay (see: Accelerator)

position

  • Value: 'top', 'bottom', 'left' or 'right'
  • Default: 'top'
  • Choose where HyperTerm Overlay will be positioned: top, bottom, left or right.

primaryDisplay

  • Value: true or false
  • Default: false
  • Show HyperTerm Overlay only on primary display.

resizable

  • Value: true or false
  • Default: true
  • Allow the HyperTerm Overlay be resizable.

resize

size

  • Value: float or number
  • Default: 0.4
  • The size of HyperTerm Overlay when it is showing. The possible values are a number or a float. If is a number, it represents the size um pixels. Else, if is a float, it means the percentage of the screen.

startAlone

  • Value: true or false
  • Default: false
  • Makes HyperTerm Overlay the unique window displayed when started.
  • Other windows started will be default Hyper.app windows.

startup

  • Value: true or false
  • Default: true
  • Open HyperTerm Overlay on Hyper.app startup.

tray

  • Value: true or false
  • Default: true
  • Add icon to the system notification area, for access HyperTerm Overlay.

tray

unique

  • Value: true or false
  • Default: false
  • Makes HyperTerm Overlay the unique window of Hyper.app. Any other window will be removed.

Licence

MIT