Giter VIP home page Giter VIP logo

hyper-overlay's Introduction

logo

Hyper Overlay

Elegant way to have your hyper terminal at your fingers anywhere, anytime

homeMacOShomeWin


Project Status

GitHub

Bundle Sizes

npm bundle size npm bundle size npm

Social Media and Donations

Join Discord server Twitter Follow Patreon Donate PayPal Donate


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

hyper-overlay's People

Contributors

rickgbw avatar favna avatar sahewat avatar benchr267 avatar shadyvb avatar yamalight avatar imgbot[bot] avatar ppot avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.