/crystal

Window manager agnostic clear transparent workflow for Unix

Primary LanguageShellGNU General Public License v3.0GPL-3.0

Crystal: Window manager agnostic clear transparent workflow for Unix

Crystal helps you maintains a single transparent window all throughout multiple windows and workspaces.

This is the next iteration of Mono Trans BSPWM

Features

  • Can be used on any window manager
  • No background windows on fullscreen mode
  • No background windows on monocle mode
  • Navigation between hidden windows
  • Auto navigate to previews hidden window after closing
  • Runs as fast as it gets! (hint: POSIX compliant shellscript)

Dependencies

  • tail, xargs
  • A compositor( ex. xcompmgr, picom etc )
  • xdo
  • xdotool

Installation

git clone https://github.com/salman-abedin/crystal.git && cd crystal && sudo make install

Usage

  • Get the WM_NAME of your status bar using xprop and create an environment variable named STATUSBAR accordingly.

    For example, put the following in your .profile/.xprofile if you are using yabar

export STATUSBAR=yabar

  • Restart

  • Bind these commands to your preferred key combinations

Command Effect
crystal --toggle [solo,fullscreen] Toggles crystal mode on fullscreen or solo mode
crystal --navigate [next, prev] navigates between hidden windows
crystal --close closes the current window and focuses on the last hidden one

Uninstallation

sudo make uninstall

FAQ

What if I change my status bar?

Change the STATUSBAR environment variable and you are good to go.

Patches

  • 05/07/20:- Added tmux status toggling for fullscreen mode

Repos you might be interested in

Bolt : The lightning fast workflow creator

Uniblocks : The statusbar wrapper

puri : Minimal URL launcher

Magpie : The dotfiles

Alfred : The scripts

Devour : Terminal swallowing

Contact

SalmanAbedin@disroot.org