Project Status

Bundle Sizes

Social Media and Donations

Fork Note

Frok from Favna/hyper-overlay and fixed the issue that focus is not switching back to previous application after hide the overlay window.

Using solution from PR https://github.com/rickgbw/hyperterm-overlay/pull/39.

Related issues:

• https://github.com/rickgbw/hyperterm-overlay/issues/38

The tweaked package is published in npm: giyyapan-hyper-overlay.

Notes below are from the original repo:

PLEASE NOTE

This project should be considered stale. I do not have time nor enough knowledge of Electron and Hyper to support it the current time. I cannot guarantee that I will ever invesst enough time in either the framework or the application to support it. While it may work it should be expected to have bugs, and they will not be fixed.

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

Open your overlay with Option + Space on MacOS or Control + Space on Windows / Linux or by clicking the tray icon. Escape is the hotkey for hiding the overlay, or you can press X , - , or click the tray icon again.

This has been forked from hyperterm-overlay which appears to have been deserted and aims to fix some of the issues on that GitHub repository.

Important: Designed for Hyper >= 2.0.0

Install

Option 1 (using hyper's package manager):

Use hyper i hyper-overlay

Option 2 (manual):

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

plugins: [
    'hyper-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: {
                open: ['Control+Space'], // On MacOS hotkey is default to Option + Space!
                close: ['Shift+Escape'], // On MacOS hotkey is default to Option + Escape!
            },
            position: 'top',
            primaryDisplay: false,
            resizable: true,
            size: {
                width: 0.4,
                height: 0.4
            },
            startAlone: false,
            startup: false,
            tray: true,
            unique: false
        }
    },
    // ...
};

alwaysOnTop

• Value: true or false
• Default: true
• Makes Hyper 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 Hyper Overlay when it loses focus.

hideDock

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

hotkeys

Open

• Value: array of hotkey strings
• Default: ['Option+Space'] on MacOS or ['Control+Space'] on Windows / Linux
• Specify one or more hotkeys to show and hide the Hyper Overlay (see: Accelerator )

Close (hide)

• Value: array of hotkey strings
• Default: ['Option+Escape'] on MacOS or ['Shift+Escape'] on Windows / Linux
• Specify one or more hotkeys to hide the Hyper Overlay (see: Accelerator )

position

• Value: top , bottom , left , right , topRight , topLeft , bottomRight , bottomLeft , center
• Default: 'top'
• Choose where Hyper Overlay will be positioned

primaryDisplay

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

resizable

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

<img src="https://cloud.githubusercontent.com/assets/924158/17121469/5281a916-52aa-11e6-92f5-fa1c3dff75c8.gif" title="resizeMacOS" alt="resizeMacOS" width="430" align="middle" /><img src="https://raw.githubusercontent.com/Favna/hyper-overlay/master/assets/resize.gif" title="resizeWin" alt="resizeWin" width="430" align="middle" />

size

width

• Value: A value between 0.1 and 1
• Default: 0.4
• The width of Hyper Overlay when it is showing.

height

• Value: A value between 0.1 and 1
• Default: 0.4
• The height of Hyper Overlay when it is showing.

visibleOnAllWorkspaces

• Value: true or false
• Default: false
• Let Hyper window be visible in all workspaces

startAlone

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

startup

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

tray

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

<img src="https://cloud.githubusercontent.com/assets/924158/17121470/5294b02e-52aa-11e6-9bca-9d70f186c60b.gif" title="trayMacOS" alt="trayMacOS" width="430" align="middle" /><img src="https://raw.githubusercontent.com/Favna/hyper-overlay/master/assets/hideonblur.gif" title="trayWin" alt="trayWin" width="430" align="middle" />

unique

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

Other plugins in gifs

hyper-material-theme

hyper-tab-icons

hyper2-border

License

Copyright © 2019, Favware. Released under the MIT License.

Buy us a donut

Favware projects are open source and always will be, even if there are no donations. That said, we also know there are people out there that may still want to donate just to show their appreciation so this is for you guys. Thanks in advance!

We accept donations through PayPal, BitCoin, Ethereum and LiteCoin. You can use the buttons below to donate through your method of choice

|Donate With|QR|Address| |:---:|:---:|:---:| ||Donate with PayPal| ||1E643TNif2MTh75rugepmXuq35Tck4TnE5| ||0xF653F666903cd8739030D2721bF01095896F5D6E| ||LZHvBkaJqKJRa8N7Dyu41Jd1PDBAofCik6|