Skip to main content

i3a

i3a is a set of scripts used for automation of i3 and sway window manager layouts.

Automation list

i3a-master-stack

Provides automatic master-stack layout, which is known from e.g. DWM. The following kinds of the layout are possible:

  • master-stack area with DWM-like stack (stack windows are split)
  • master-stack area with i3-like stack (stack windows are actual stack)

To use, run i3a-master-stack with selected options (i3a-master-stack --help for details). One way to run it automatically is via a systemd user service.

  1. Create the following file in ~/.config/systemd/user/i3a-master-stack:
[Unit]
Description=i3a-master-stack

[Service]
ExecStart=%h/.local/bin/i3a-master-stack --stack=dwm --stack-size=35
Restart=on-failure
  1. Add the following entry to your i3 or sway configuration file:
exec "systemctl --user restart i3a-master-stack.service"

i3a-swap

Swap currently focused window between master and stack areas from i3a-master-stack (technically it doesn't require running i3-master-stack).

To use it, add the following binding to your i3 or sway configuration file:

bindsym $mod+f exec i3a-swap

i3a-swallow

Provides automatic "swallowing": when a program runs a child process, the parent is automatically hidden (moved to the scratchpad), which looks like if it was replaced, or "swallowed" by the child window. It is especially useful for graphical programs (video player, document viewer etc.) run from the terminal.

Provides a means of filtering both parent programs which can be swallowed and child programs which can trigger swallowing.

To use it, run i3a-swallow with selected options. One way to run it automatically is via a systemd user service.

  1. Create the following file in ~/.config/systemd/user/i3a-swallow:
[Unit]
Description=i3a-swallow

[Service]
ExecStart=%h/.local/bin/i3a-swallow
Restart=on-failure
  1. Add the following entry to your i3 or sway configuration file:
exec "systemctl --user restart i3a-swallow.service"

i3a-move-to-empty

Moves currently focused container to the first empty workspace. Keep in mind that this script relies on numbering of the workspaces.

To use it, add the following binding to your i3 or sway configuration file:

bindsym $mod+w exec i3a-move-to-empty

i3a-resize-compass

Extension of resize command. Currently focused window will automatically grow or shrink in a direction passed to i3a-resize-compass.

bindsym $mod+Up exec i3a-resize-compass up 2ppt
bindsym $mod+Down exec i3a-resize-compass down 2ppt
bindsym $mod+Right exec i3a-resize-compass right 2ppt
bindsym $mod+Left exec i3a-resize-compass left 2ppt

i3a-cycle-focus

Change the currently focused window up or down, cycling the tiled windows within the current workspace.

bindsym $mod+j exec i3a-cycle-focus down
bindsym $mod+k exec i3a-cycle-focus up 

i3a-scale-cycle

sway-specific

Changes output's scale factor to the next or previous one on a given list. Current scale factor is then printed for each requested output (or all available outputs if none was explicitly set).

-f, --scale-factors is a comma-separated list of factors which i3a-scale will cycle so it must be escaped in configuration file:

bindsym $mod+s exec "i3a-scale-cycle -f 1.0,1.5,2.0 -o HDMI-1 -o HDMI-2 --next"

i3a-trail

Dynamically toggle trailmarks (a kind of special marks) on windows and use them to quickly cycle between trailmarks in the same groups. It's possible to have many different groups of trailmarks (trails) and windows may belong to many different groups.

Use i3a-trail new-trail|delete-trail|next-trail|previous-trail create and activate trails. Use i3a-trail mark to add and remove trailmarks. Use i3a-trail next|previous to traverse marked windows.

bindsym $mod+grave exec i3a-trail mark
bindsym $mod+Tab exec i3a-trail next
bindsym $mod+Shift+Tab exec i3a-trail previous

bindsym $mod+n exec i3a-trail new-trail
bindsym $mod+Shift+n exec i3a-trail delete-trail
bindsym $mod+bracketright exec i3a-trail next-trail
bindsym $mod+bracketleft exec i3a-trail previous-trail

Installation

  • PyPI
  • AUR (Arch Linux - unofficial)

Metadata

Release files for i3a 2.4.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for i3a 2.4.1
File Size Uploaded Provenance Actions
i3a-2.4.1.tar.gz 24.7 kB Without provenance Details for i3a-2.4.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for i3a 2.4.1
File Interpreter ABI Platform Actions
i3a-2.4.1-py3-none-any.whl Python 3 none any Details for i3a-2.4.1-py3-none-any.whl

Total release size: 52.4 kB

Release files / i3a-2.4.1.tar.gz

Download URL i3a-2.4.1.tar.gz
Size 24.7 kB
Tags Source
SHA-256 checksum
How to use checksums
d712b6cdabbaef981359d11c3a27015f70b17de9cd9ee92e557540e8566923e1
BLAKE2b-256 checksum
How to use checksums
1aca74dd9356d84f2ef42fd580b02c71e978cf87d60adb3d005564d22a8e170d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":null,"id":"forky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / i3a-2.4.1-py3-none-any.whl

Download URL i3a-2.4.1-py3-none-any.whl
Size 27.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1ec47ad4fc7e62e414cd7a5ce96ffc924db20e99a3eec1786e33961d9436cfe0
BLAKE2b-256 checksum
How to use checksums
1de57e98116c14896992d1a71c3de8c0bbadc81f33ed7d80c3be1b1951ecb634
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":null,"id":"forky","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for i3a 2.4.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page