https://github.com/anko/xwincat

simple X11 window position logger
https://github.com/anko/xwincat

log tool window x11

Last synced: 3 months ago
JSON representation

simple X11 window position logger

• Host: GitHub
• URL: https://github.com/anko/xwincat
• Owner: anko
• License: isc
• Created: 2014-12-07T01:24:21.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2019-02-13T05:26:28.000Z (almost 6 years ago)
• Last Synced: 2024-10-04T10:28:15.770Z (4 months ago)
• Topics: log, tool, window, x11
• Language: C
• Homepage:
• Size: 4.88 KB
• Stars: 4
• Watchers: 5
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: readme.markdown
  • License: LICENSE

Awesome Lists containing this project

README

        
# xwincat

X11 window position logger with a simple output format: One window position

change per line on `stdout`.

![Window cats. The name is referringto the UNIX cat program though.][1]


Image credit: [Pixabay][2] user 123090

Nice for drawing some sort of composited overlay, or for fun statistics.

## Format

On startup, `xwincat` prints a line

    screen  

where the integers `` and `` represent the dimensions of the

first screen it found.

Whenever a window changes position or size, it prints a line

    window     

where the fields are again pretty self-explanitory.  The (x,y) position is from

top-left of the screen.

Popup windows (with the `override_redirect`-flag set) are ignored by default,

but can be enabled if you want them with the `-popups` flag.

If you passed `-time`, an epoch timestamp is additionally printed at the end of

`window` lines.

## Compilation

Just `make`.

Don't have `clang`? Edit the `makefile` to use `gcc`.

## Usage

Flags you can pass (all optional):

 - `-display `: set target X display (default `:0`)

 - `-time`: also append epoch timestamps (default: don't)

 - `-popup`: also print popup window changes (default: don't)

 - `-help`: print usage hints and exit

Interrupt signal (`C-c`) to end.

## Related programs

If you want to similarly log what keys are pressed, you might like

[`xkbcat`][3].

## License

[ISC][4].

[1]: https://cloud.githubusercontent.com/assets/5231746/5329631/5b4f0714-7db8-11e4-8476-921b166ad1c3.jpg

[2]: http://pixabay.com/en/cat-window-sit-pet-masonry-437973/

[3]: https://github.com/anko/xkbcat

[4]: http://opensource.org/licenses/ISC