frozone

A tool to save and restore the position of windows using wmctrl


Keywords
window, manager, position, gnome, desktop, linux, wmctrl, x11, xorg, cli, freeze, utility
License
GPL-3.0
Install
pip install frozone==0.1.1

Documentation

Frozone

PyPI - Python Version

Buy Me a Coffee at ko-fi.com

A tool to save and restore the position of windows using wmctrl.

Requirements

  • wmctrl
  • Python >= 3.2
  • pip

Tested on Zorin OS 17 Core.

Installation

$ pip3 install frozone

Usage

Saving open windows

frozone freeze

Restoring open windows

frozone restore

Command line arguments

Argument Description
--help Show the help message
-v, --verbose Increase output verbosity
-r, --restore Restore the windows to their previous state using the default JSON file. Can be used with -i, --input to specify the JSON file location
-o OUTPUT, --output OUTPUT Set an output path for the JSON file
-i INPUT, --input INPUT Set the input path for the JSON file
-c CMD_REGEX, --cmd-regex CMD_REGEX Set the command regex to filter the windows to be saved

Configuration

wmctrl has an issue with positioning due to window frames. To mitigate this issue, you can configure the top and left offsets in the ~/.config/frozone/frozone.conf.

cmd_regex can also be configured in the same file.

About

By recoskyler - Adil Atalay Hamamcioglu - 2024