I cannot get this to work. The instructions are a bit fuzzy, what do you exactly mean by "stack it with the intended window"?

I wanted to test this myself before merging anything, but don't have the time for it right now. But for all that I know i3 does not support the X shape extension, and without this the click through cannot work AFAIK. See also i3/i3#2742 .

@McKean Is clicking and interacting with the recorded content possible for you or just the recording? Do you have a compositor (e.g. compton) running?

I'm not getting it to click through eventhough I'm floating both windows with peek on top. I'm also having issues with the tmp file having no content in it when I use i3.

@sQVe see this screenshot:

@phw yes I'm using compton, I'm not sure if it works without. Clicking works perfectly fine too. I can upload a video if this would help.

One thing that would be beneficial is to be able to start peek without that top bar, that way it would record the whole window which is stacked (you can see in the screenshot that it will not capture the top part). Other than that it works really well.

edit:
@phw I just tested disabling compton and it worked!

i3 stacked windows no compton:

I can now confirm that using either stacked, tabbed or floating both windows (peek and the window to be recorded) in i3 is working to record with peek 👍.

@sQVe great to hear, instead of using the two floating windows approach I would recommend using the scratchpad method, where you put Peek into a scratch pad if you want to have a strictly defined area to record.

I am not an i3 user, but I think now I get it. While click-through is not working on i3, i3 is flexible enough to do with Peek whatever you want, also having it ignore Peek's wish to be always on top and send it to that hidden scratchpad workspace where it is not visible but still maintains its coordinates. Is this about right?

Thanks for this addition to the documentation.

@phw That is correct. There are plenty of different ways for it to work with i3. 👍

@phw yeah that's pretty much it. Also the reason why I'm requesting: #203
But perhaps I should just try and contribute towards such a feature myself :)