/i3-quake

quake mode for terminal in i3 window manager

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

i3 quake

Quake mode for terminal in i3 window manager

quake

Requirements

  • i3wm
  • i3ipc (pip install i3ipc)
  • terminal supported:
    • alacritty
    • gnome-terminal
    • roxterm
    • st
    • termite
    • urxvt
    • xfce4-terminal
    • xterm

Installation

  • Install all dependencies
  • Download the python file and put it in $PATH

Usage

Open terminal dropdown in quake style (or bottom up). Each workspace can have one terminal in quake mode. If the focused workspace already have quake terminal. The next command will toggle visiblity state of said console regardless of the input arguments

Options

$ i3_quake -h
usage: i3_quake [-h] [-i] [-p POS] [-H RATIO] [-t TERM] [CMD]

positional arguments:
  CMD                   command to execute in new terminal

optional arguments:
  -h, --help            show this help message and exit
  -i, --in-place        set current terminal at top down position and execute
                        cmd
  -p POS, --pos POS     open terminal at top or bottom (default is top)
  -H RATIO, --height RATIO
                        height of terminal in percentage of monitor height
  -t TERM, --term TERM  terminal name (default is xterm)

Examples

$ i3_quake # default use xterm and open $SHELL
$ i3_quake -H 0.6 -t termite htop
$ i3_quake -p bottom -H 0.2 -t xfce4-terminal ipython

Flickering

Add this line to i3 config (~/.config/i3/config) to hide the terminal immediately when created to prevent flickering issue

for_window [title="quake_.*"] move window to scratchpad

Credit

Original work is i3-quickterm by ibonn which will open terminal dropdown from selected shell in rofi dmenu. i3-quake generalize the idea with command argument to run when open terminal.

Licenses

BSD 3 Clauses