Giter VIP home page Giter VIP logo

windows-terminal-quake's Introduction

windows-terminal-quake

Companion program for the new Windows Terminal that enables Quake-style drop down

Preview

  • Runs alongside the new Windows Terminal
  • Toggle using CTRL+~ or CTRL+Q (configurable, see below)
  • Shows up on the screen where the mouse is (eg. multi-monitor and multi-workspace)
  • Transparency
  • Configurable as fullscreen, or partial screen

Usage

There are a couple of options:

  • Download the latest release from the releases page.
  • Clone/download the source and run build.ps1 (uses Cakebuild).
  • Clone/download the source and build using Visual Studio.

Settings

Since v0.4, the app supports a JSON settings file. The file can be placed at either "C:\Users\(username)\windows-terminal-quake.json", or next to the app .exe.

Changing the file automatically results in the app reloading the settings.

Suggested by Mike F

Hot Keys

Multiple hot keys are supported, with an optional modifier.

{
  // The keys that can be used to toggle the terminal
  "HotKeys": [

    // Tilde, without modifiers
    {
      "Key": "OemTilde"
    },

    // Ctrl + Q
    {
      "Modifiers": "Control",
      "Key": "Q"
    }

  ]
}

Toggle Duration

How long it should take for the terminal to come down or go back up. This is an estimate, since because of the way the toggling works, some slow downs can happen.

Setting this to 0 makes the toggle instant.

{
  // How long the toggle up/down takes in milliseconds
  "ToggleDurationMs": 150
}

Suggested by Mike F

Transparency

The terminal window can be made transparent through the "Opacity"-setting. Note that this controls the transparency of the entire window, including the title bar.

{
  // Make the window see-through (applies to the entire window, including the title bar)
  // 0 (invisible) - 100 (opaque)
  "Opacity": 80
}

Transparency

Suggested by ukWaqas

Vertical Screen Coverage

The vertical space that is taken up by the terminal window can be configured through "VerticalScreenCoverage".

{
  // How far the terminal should come down, in percentage (eg. 50 = half way, 100 = full screen)
  "VerticalScreenCoverage": 60
}

Vertical Screen Coverage

Suggested by ukWaqas

Vertical Offset

How much room to leave between the top of the terminal and the top of the screen.

{
  // How much room to leave between the top of the terminal and the top of the screen
  "VerticalOffset": 50
}

Vertical Offset

Suggested by Neil Santos

Horizontal Screen Coverage

Should you want the terminal to not take the entire width of the screen, take a look at the "HorizontalScreenCoverage" setting.

{
  // How much horizontal space the terminal should use. When this is below 100, the terminal is centered.
  // This can also be above 100, which can be useful to compensate for the window not always taking a 100% of the screen width,
  // due to the terminal being bound to column widths (eg. try 100.5 or 101).
  "HorizontalScreenCoverage": 80
}

Horizontal Coverage

Suggested by baslas

Horizontal Align

When "HorizontalScreenCoverage" is below 100, this setting determines where the terminal is place horizontally.

{
  // When "HorizontalScreenCoverage" is below 100, this setting determines whether the terminal is place horizontally.
  // "Center", "Left" or "Right".
  "HorizontalAlign": "Center"
}

Left

Center

Right

Suggested by Rafael Pereira

Hide On Focus Lost

When clicking or alt-tabbing away to another app, the terminal will automatically (and instantly) hide.

Defaults to "true".

{
  // When clicking or alt-tabbing away to another app, the terminal will automatically (and instantly) hide.
  "HideOnFocusLost": true
}

Suggested by Douglas Lara

windows-terminal-quake's People

Contributors

flyingpie avatar webbertakken avatar zakius 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.