Metadata-Version: 2.1
Name: frozone
Version: 0.1.0
Summary: A tool to save and restore the position of windows using wmctrl
Author-email: Adil Atalay Hamamcioglu <38231748+recoskyler@users.noreply.github.com>
Project-URL: Homepage, https://github.com/recoskyler/frozone
Project-URL: Issues, https://github.com/recoskyler/frozone/issues
Keywords: window manager,window position,gnome,desktop,linux,wmctrl,x11,xorg
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Environment :: Console
Classifier: Natural Language :: English
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Utilities
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Desktop Environment :: Window Managers
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.2
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: setuptools
Requires-Dist: Click

# Frozone

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

```bash
$ 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](https://github.com/recoskyler) - Adil Atalay Hamamcioglu - 2024
