Package pywingo :: Module commands :: Class WingoCommands
[frames] | no frames]

Class WingoCommands

source code

object --+
         |
        WingoCommands
Known Subclasses:

Instance Methods
 
__init__(self)
x.__init__(...) initializes x; see help(type(x)) for signature
source code
 
AddWorkspace(self, Name)
Adds a new workspace to Wingo with a name Name.
source code
 
And(self, Op1, Op2)
Returns the logical AND of Op1 and Op2.
source code
 
AutoCycle(self, Workspace)
Cycles to the next automatic tiling layout in the workspace specified by Workspace.
source code
 
AutoMakeMaster(self, Workspace)
Switches the current window with the first master in the layout for the workspace specified by Workspace.
source code
 
AutoMaster(self, Workspace)
Focuses the (first) master window in the layout for the workspace specified by Workspace.
source code
 
AutoMastersFewer(self, Workspace)
Allows one fewer master window to fit into the master split.
source code
 
AutoMastersMore(self, Workspace)
Allows one more master window to fit into the master split.
source code
 
AutoNext(self, Workspace)
Moves focus to the next client in the layout.
source code
 
AutoPrev(self, Workspace)
Moves focus to the next client in the layout.
source code
 
AutoResizeMaster(self, Workspace, Amount)
Increases or decreases the size of the master split by Amount in the layout on the workspace specified by Workspace.
source code
 
AutoResizeWindow(self, Workspace, Amount)
Increases or decreases the size of the current window by Amount in the layout on the workspace specified by Workspace.
source code
 
AutoSwitchNext(self, Workspace)
Switches the current window with the next window in the layout.
source code
 
AutoSwitchPrev(self, Workspace)
Switches the current window with the previous window in the layout.
source code
 
AutoTile(self, Workspace)
Initiates automatic tiling on the workspace specified by Workspace.
source code
 
AutoUntile(self, Workspace)
Stops automatic tiling on the workspace specified by Workspace, and restores windows to their position and geometry before being tiled.
source code
 
Close(self, Client)
Closes the window specified by Client.
source code
 
CycleClientChoose(self)
Activates the current choice in a cycle prompt.
source code
 
CycleClientHide(self)
Hides (i.e., cancels) the current cycle prompt.
source code
 
CycleClientNext(self, OnlyActiveWorkspace, OnlyVisible, ShowIconified)
Shows the cycle prompt for clients and advances the selection to the next client.
source code
 
CycleClientPrev(self, OnlyActiveWorkspace, OnlyVisible, ShowIconified)
Shows the cycle prompt for clients and advances the selection to the previous client.
source code
 
Dale(self)
Make sure "audio_play_cmd" is set to a program that can play wav files.
source code
 
Deiconify(self, Client)
Deiconifies (unminimizes) the window specified by Client.
source code
 
False(self)
Always returns 0.
source code
 
Float(self, Client)
Floats the window specified by Client.
source code
 
Focus(self, Client)
Focuses the window specified by Client.
source code
 
FocusRaise(self, Client)
Focuses and raises the window specified by Client.
source code
 
FrameBorders(self, Client)
Set the decorations of the window specified by Client to the "Borders" frame.
source code
 
FrameFull(self, Client)
Set the decorations of the window specified by Client to the "Full" frame.
source code
 
FrameNada(self, Client)
Set the decorations of the window specified by Client to the "Nada" frame.
source code
 
FrameSlim(self, Client)
Set the decorations of the window specified by Client to the "Slim" frame.
source code
 
GetActive(self)
Returns the id of the currently active window.
source code
 
GetAllClients(self)
Returns a list of all client ids separated by new lines.
source code
 
GetClientHeight(self, Client)
Returns the height of the window specified by Client, including decorations.
source code
 
GetClientList(self, Workspace)
Returns a list of client ids separated by new lines on the workspace specified by Workspace.
source code
 
GetClientName(self, Client)
Returns the name of the window specified by Client active window.
source code
 
GetClientStatesList(self, Client)
Returns a list of states that the client is in.
source code
 
GetClientType(self, Client)
Returns the type of the window specified by Client active window.
source code
 
GetClientWidth(self, Client)
Returns the width of the window specified by Client, including decorations.
source code
 
GetClientWorkspace(self, Client)
Returns the workspace of the window specified by Client active window.
source code
 
GetClientX(self, Client)
Returns the relative X position of the window specified by Client, where the X position refers to the left-most region of the window, including decorations.
source code
 
GetClientY(self, Client)
Returns the relative Y position of the window specified by Client, where the Y position refers to the left-most region of the window, including decorations.
source code
 
GetHead(self)
Returns the index of the current head.
source code
 
GetHeadHeight(self, Head)
Gets the workable height of the head indexed at Head.
source code
 
GetHeadWidth(self, Head)
Gets the workable width of the head indexed at Head.
source code
 
GetHeadWorkspace(self, Head)
Returns the name of the workspace currently visible on the monitor indexed by Head.
source code
 
GetLayout(self, Workspace)
Returns the name of the currently active (or "default") layout on the workspace specified by Workspace.
source code
 
GetNumHeads(self)
Returns the number of active Heads.
source code
 
GetNumHeadsConnected(self)
Returns the number of Heads connected.
source code
 
GetWorkspace(self)
Returns the name of the current workspace.
source code
 
GetWorkspaceId(self, Workspace)
Returns the id (the index) of the workspace specified by Workspace.
source code
 
GetWorkspaceList(self)
Returns a list of all workspaces, in the order that they were added.
source code
 
GetWorkspaceNext(self)
Returns the name of the "next" workspace.
source code
 
GetWorkspacePrefix(self, Prefix)
Returns the first non-visible workspace starting with Prefix.
source code
 
GetWorkspacePrev(self)
Returns the name of the "previous" workspace.
source code
 
HeadFocus(self, Head)
Focuses the head indexed at Head.
source code
 
HeadFocusWithClient(self, Head, Client)
Focuses the head indexed at Head, and move the Client specified by client to that head.
source code
 
HideClientFromPanels(self, Client)
Sets the appropriate flags so that the window specified by Client is hidden from panels and pagers.
source code
 
Iconify(self, Client)
Iconifies (minimizes) the window specified by Client.
source code
 
Input(self, Label)
Shows a centered prompt window that allows the user to type in text.
source code
 
MatchClientClass(self, Client, Class)
Returns 1 if the "class" part of the WM_CLASS property on the window specified by Client contains the substring specified by Class, and otherwise returns 0.
source code
 
MatchClientInstance(self, Client, Instance)
Returns 1 if the "instance" part of the WM_CLASS property on the window specified by Client contains the substring specified by Instance, and otherwise returns 0.
source code
 
MatchClientIsTransient(self, Client)
Returns 1 if the window specified by Client is a transient window, and otherwise returns 0.
source code
 
MatchClientMapped(self, Client)
Returns 1 if the window specified by Client is mapped or not.
source code
 
MatchClientName(self, Client, Name)
Returns 1 if the name of the window specified by Client contains the substring specified by Name, and otherwise returns 0.
source code
 
MatchClientType(self, Client, Type)
Returns 1 if the type of the window specified by Client matches the type named by Type, and otherwise returns 0.
source code
 
Maximize(self, Client)
Maximizes the window specified by Client.
source code
 
Message(self, Text)
Shows a centered prompt window with the text specified by Text.
source code
 
MouseMove(self)
Initiates a drag that allows a window to be moved with the mouse.
source code
 
MouseResize(self, Direction)
Initiates a drag that allows a window to be resized with the mouse.
source code
 
Move(self, Client, X, Y)
Moves the window specified by Client to the x and y position specified by X and Y.
source code
 
MovePointer(self, X, Y)
Moves the pointer to the x and y position specified by X and Y.
source code
 
MovePointerRelative(self, X, Y)
Moves the pointer to the x and y position specified by X and Y relative to the current workspace.
source code
 
MoveRelative(self, Client, X, Y)
Moves the window specified by Client to the x and y position specified by X and Y, relative to its workspace.
source code
 
Not(self, Op)
Returns the negation of Op.
source code
 
Or(self, Op1, Op2)
Returns the logical OR of Op1 and Op2.
source code
 
Quit(self)
Stops Wingo.
source code
 
Raise(self, Client)
Raises the window specified by Client to the top of its layer.
source code
 
RemoveWorkspace(self, Workspace)
Removes the workspace specified by Workspace.
source code
 
RenameWorkspace(self, Workspace, NewName)
Renames the workspace specified by Workspace to the name in NewName.
source code
 
Resize(self, Client, Width, Height)
Resizes the window specified by Client to some width and height specified by Width and Height.
source code
 
Restart(self)
Restarts Wingo in place using exec.
source code
 
Script(self, Command)
Executes a script in $XDG_CONFIG_HOME/wingo/scripts.
source code
 
SelectClient(self, TabCompletion, OnlyActiveWorkspace, OnlyVisible, ShowIconified)
Shows a centered prompt window with a list of clients satisfying the arguments provided.
source code
 
SelectWorkspace(self, TabCompletion)
Shows a centered prompt window with a list of all workspaces.
source code
 
SetLayout(self, Workspace, Name)
Sets the current layout of the workspace specified by Workspace to the layout named by Name.
source code
 
SetOpacity(self, Client, Opacity)
Sets the opacity of the window specified by Client to the opacity level specified by Opacity.
source code
 
Shell(self, Command)
Attempts to execute the shell command specified by Command.
source code
 
ShowClientInPanels(self, Client)
Sets the appropriate flags so that the window specified by Client is shown on panels and pagers.
source code
 
TagGet(self, Client, Name)
Retrieves the tag with name Name for the client specified by Client.
source code
 
TagSet(self, Client, Name, Value)
Sets the tag with name Name to value Value for the client specified by Client.
source code
 
ToggleFloating(self, Client)
Toggles whether the window specified by Client should be forced into the floating layout.
source code
 
ToggleIconify(self, Client)
Iconifies (minimizes) or deiconifies (unminimizes) the window specified by Client.
source code
 
ToggleMaximize(self, Client)
Maximizes or restores the window specified by Client.
source code
 
ToggleStackAbove(self, Client)
Toggles the layer of the window specified by Client from normal to above.
source code
 
ToggleStackBelow(self, Client)
Toggles the layer of the window specified by Client from normal to below.
source code
 
ToggleSticky(self, Client)
Toggles the sticky status of the window specified by Client.
source code
 
True(self)
Always returns 1.
source code
 
Unfloat(self, Client)
Unfloats the window specified by Client.
source code
 
Unmaximize(self, Client)
Unmaximizes the window specified by Client.
source code
 
WingoExec(self, Commands)
Executes a series of Wingo commands specified by Commands.
source code
 
WingoHelp(self, CommandName)
Shows the usage information for a particular command specified by CommandName.
source code
 
Workspace(self, Workspace)
Sets the current workspace to the one specified by Workspace.
source code
 
WorkspaceGreedy(self, Workspace)
Sets the current workspace to the one specified by Workspace in a greedy fashion.
source code
 
WorkspaceGreedyWithClient(self, Workspace, Client)
Sets the current workspace to the workspace specified by Workspace in a greedy fashion, and moves the window specified by Client to that workspace.
source code
 
WorkspaceHead(self, Workspace)
Retrieves the head index of the workspace specified by Workspace.
source code
 
WorkspaceSendClient(self, Workspace, Client)
Sends the window specified by Client to the workspace specified by Workspace.
source code
 
WorkspaceToHead(self, Head, Workspace)
Sets the workspace specified by Workspace to appear on the head specified by the Head index.
source code
 
WorkspaceWithClient(self, Workspace, Client)
Sets the current workspace to the workspace specified by Workspace, and moves the window specified by Client to that workspace.
source code

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties

Inherited from object: __class__

Method Details

__init__(self)
(Constructor)

source code 

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__
(inherited documentation)

AddWorkspace(self, Name)

source code 

Adds a new workspace to Wingo with a name Name. Note that a workspace name must be unique with respect to other workspaces and must have non-zero length.

The name of the workspace that was added is returned.

And(self, Op1, Op2)

source code 

Returns the logical AND of Op1 and Op2.

If Op1 or Op2 is not in {0, 1}, then a warning is logged and nil is returned.

AutoCycle(self, Workspace)

source code 

Cycles to the next automatic tiling layout in the workspace specified by Workspace.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoMakeMaster(self, Workspace)

source code 

Switches the current window with the first master in the layout for the workspace specified by Workspace.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoMaster(self, Workspace)

source code 

Focuses the (first) master window in the layout for the workspace specified by Workspace.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoMastersFewer(self, Workspace)

source code 

Allows one fewer master window to fit into the master split.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoMastersMore(self, Workspace)

source code 

Allows one more master window to fit into the master split.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoNext(self, Workspace)

source code 

Moves focus to the next client in the layout.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoPrev(self, Workspace)

source code 

Moves focus to the next client in the layout.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoResizeMaster(self, Workspace, Amount)

source code 

Increases or decreases the size of the master split by Amount in the layout on the workspace specified by Workspace.

Amount should be a ratio between 0.0 and 1.0.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoResizeWindow(self, Workspace, Amount)

source code 

Increases or decreases the size of the current window by Amount in the layout on the workspace specified by Workspace.

Amount should be a ratio between 0.0 and 1.0.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoSwitchNext(self, Workspace)

source code 

Switches the current window with the next window in the layout.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoSwitchPrev(self, Workspace)

source code 

Switches the current window with the previous window in the layout.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoTile(self, Workspace)

source code 

Initiates automatic tiling on the workspace specified by Workspace. If tiling is already active, the layout will be re-placed.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

AutoUntile(self, Workspace)

source code 

Stops automatic tiling on the workspace specified by Workspace, and restores windows to their position and geometry before being tiled. If tiling is not active on the specified workspace, this command has no effect.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

Close(self, Client)

source code 

Closes the window specified by Client.

Client may be the window id or a substring that matches a window name.

CycleClientNext(self, OnlyActiveWorkspace, OnlyVisible, ShowIconified)

source code 

Shows the cycle prompt for clients and advances the selection to the next client. If the cycle prompt is already visible, then the selection is advanced to the next client.

OnlyActiveWorkspace specifies that only clients on the current workspace should be listed. Valid values are "yes" or "no".

OnlyVisible specifies that only clients on visible workspaces should be listed. Valid values are "yes" or "no".

ShowIconified specifies that iconified clients will be shown. Valid values are "yes" or "no".

CycleClientPrev(self, OnlyActiveWorkspace, OnlyVisible, ShowIconified)

source code 

Shows the cycle prompt for clients and advances the selection to the previous client. If the cycle prompt is already visible, then the selection is advanced to the previous client.

OnlyActiveWorkspace specifies that only clients on the current workspace should be listed. Valid values are "yes" or "no".

OnlyVisible specifies that only clients on visible workspaces should be listed. Valid values are "yes" or "no".

ShowIconified specifies that iconified clients will be shown. Valid values are "yes" or "no".

Deiconify(self, Client)

source code 

Deiconifies (unminimizes) the window specified by Client. If the window is already deiconified, this command has no effect.

Client may be the window id or a substring that matches a window name.

Float(self, Client)

source code 

Floats the window specified by Client. If the window is already floating, this command has no effect.

Client may be the window id or a substring that matches a window name.

Focus(self, Client)

source code 

Focuses the window specified by Client.

Client may be the window id or a substring that matches a window name.

FocusRaise(self, Client)

source code 

Focuses and raises the window specified by Client.

Client may be the window id or a substring that matches a window name.

FrameBorders(self, Client)

source code 

Set the decorations of the window specified by Client to the "Borders" frame.

Client may be the window id or a substring that matches a window name.

FrameFull(self, Client)

source code 

Set the decorations of the window specified by Client to the "Full" frame.

Client may be the window id or a substring that matches a window name.

FrameNada(self, Client)

source code 

Set the decorations of the window specified by Client to the "Nada" frame.

Client may be the window id or a substring that matches a window name.

FrameSlim(self, Client)

source code 

Set the decorations of the window specified by Client to the "Slim" frame.

Client may be the window id or a substring that matches a window name.

GetActive(self)

source code 

Returns the id of the currently active window. If there is no active window, 0 is returned.

GetAllClients(self)

source code 

Returns a list of all client ids separated by new lines. Clients are listed in the order in which they were managed, starting with the oldest client.

GetClientHeight(self, Client)

source code 

Returns the height of the window specified by Client, including decorations. If the client id is invalid, 0 is returned.

Client may be the window id or a substring that matches a window name.

GetClientList(self, Workspace)

source code 

Returns a list of client ids separated by new lines on the workspace specified by Workspace. Clients are listed in their focus orderering, from most recently focused to least recently focused.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

GetClientName(self, Client)

source code 

Returns the name of the window specified by Client active window.

Client may be the window id or a substring that matches a window name.

GetClientStatesList(self, Client)

source code 

Returns a list of states that the client is in. These states are in correspondence with the possible values of the _NET_WM_STATE property. The following states may appear in the list: STICKY, MAXIMIZED_VERT, MAXIMIZED_HORZ, SKIP_TASKBAR, SKIP_PAGER, HIDDEN, FULLSCREEN, ABOVE, BELOW, DEMANDS_ATTENTION and FOCUSED.

More details can be found here: http://goo.gl/FHdjl

Client may be the window id or a substring that matches a window name.

GetClientType(self, Client)

source code 

Returns the type of the window specified by Client active window. A window type will either be "desktop", "dock" or "normal".

Client may be the window id or a substring that matches a window name.

GetClientWidth(self, Client)

source code 

Returns the width of the window specified by Client, including decorations. If the client id is invalid, 0 is returned.

Client may be the window id or a substring that matches a window name.

GetClientWorkspace(self, Client)

source code 

Returns the workspace of the window specified by Client active window.

Client may be the window id or a substring that matches a window name.

GetClientX(self, Client)

source code 

Returns the relative X position of the window specified by Client, where the X position refers to the left-most region of the window, including decorations. Note that "relative" in this case refers to the workspace that the client is on.

Relative positions can be used as arguments to MoveRelative.

If the client id is invalid, or the client is not visible, -9999 is returned.

Client may be the window id or a substring that matches a window name.

GetClientY(self, Client)

source code 

Returns the relative Y position of the window specified by Client, where the Y position refers to the left-most region of the window, including decorations. Note that "relative" in this case refers to the workspace that the client is on.

Relative positions can be used as arguments to MoveRelative.

If the client id is invalid, or the client is not visible, -9999 is returned.

Client may be the window id or a substring that matches a window name.

GetHead(self)

source code 

Returns the index of the current head. Indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

GetHeadHeight(self, Head)

source code 

Gets the workable height of the head indexed at Head. If the head specified is not visible, then 0 is returned.

Indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

GetHeadWidth(self, Head)

source code 

Gets the workable width of the head indexed at Head. If the head specified is not visible, then 0 is returned.

Indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

GetHeadWorkspace(self, Head)

source code 

Returns the name of the workspace currently visible on the monitor indexed by Head. Indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

GetLayout(self, Workspace)

source code 

Returns the name of the currently active (or "default") layout on the workspace specified by Workspace. Note that when a workspace is set to a tiling layout, it is still possible for clients to be floating.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

GetNumHeadsConnected(self)

source code 

Returns the number of Heads connected. This number may be greater than the number returned by GetNumHeads.

GetWorkspaceId(self, Workspace)

source code 

Returns the id (the index) of the workspace specified by Workspace.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

GetWorkspaceList(self)

source code 

Returns a list of all workspaces, in the order that they were added.

The special "Sticky" workspace is not included.

GetWorkspaceNext(self)

source code 

Returns the name of the "next" workspace. The ordering of workspaces is the order in which they were added. This might cause confusing behavior in multi-head setups, since multiple workspaces can be viewable at one time.

GetWorkspacePrefix(self, Prefix)

source code 

Returns the first non-visible workspace starting with Prefix. If the current workspace starts with Prefix, then the first workspace *after* the current workspace starting with Prefix will be returned.

GetWorkspacePrev(self)

source code 

Returns the name of the "previous" workspace. The ordering of workspaces is the order in which they were added. This might cause confusing behavior in multi-head setups, since multiple workspaces can be viewable at one time.

HeadFocus(self, Head)

source code 

Focuses the head indexed at Head. Indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

HeadFocusWithClient(self, Head, Client)

source code 

Focuses the head indexed at Head, and move the Client specified by client to that head. Indexing of heads starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

Client may be the window id or a substring that matches a window name.

HideClientFromPanels(self, Client)

source code 

Sets the appropriate flags so that the window specified by Client is hidden from panels and pagers.

Client may be the window id or a substring that matches a window name.

Iconify(self, Client)

source code 

Iconifies (minimizes) the window specified by Client. If the window is already iconified, this command has no effect.

Client may be the window id or a substring that matches a window name.

Input(self, Label)

source code 

Shows a centered prompt window that allows the user to type in text. If the user presses the Confirm Key (i.e., enter), then the text typed into the input box will be returned.

Label will be shown next to the input box.

This command may be used as a sub-command to pass user provided arguments to another command.

MatchClientClass(self, Client, Class)

source code 

Returns 1 if the "class" part of the WM_CLASS property on the window specified by Client contains the substring specified by Class, and otherwise returns 0. The search is done case insensitively.

Client may be the window id or a substring that matches a window name.

MatchClientInstance(self, Client, Instance)

source code 

Returns 1 if the "instance" part of the WM_CLASS property on the window specified by Client contains the substring specified by Instance, and otherwise returns 0. The search is done case insensitively.

Client may be the window id or a substring that matches a window name.

MatchClientIsTransient(self, Client)

source code 

Returns 1 if the window specified by Client is a transient window, and otherwise returns 0. A transient window usually corresponds to some kind of dialog window.

Client may be the window id or a substring that matches a window name.

MatchClientMapped(self, Client)

source code 

Returns 1 if the window specified by Client is mapped or not.

Client may be the window id or a substring that matches a window name.

MatchClientName(self, Client, Name)

source code 

Returns 1 if the name of the window specified by Client contains the substring specified by Name, and otherwise returns 0. The search is done case insensitively.

Client may be the window id or a substring that matches a window name.

MatchClientType(self, Client, Type)

source code 

Returns 1 if the type of the window specified by Client matches the type named by Type, and otherwise returns 0.

Valid window types are "Normal", "Dock" or "Desktop".

Client may be the window id or a substring that matches a window name.

Maximize(self, Client)

source code 

Maximizes the window specified by Client. If the window is already maximized, this command has no effect.

Client may be the window id or a substring that matches a window name.

Message(self, Text)

source code 

Shows a centered prompt window with the text specified by Text. The message will not disappear until it loses focus or when the confirm or cancel key is pressed.

MouseMove(self)

source code 

Initiates a drag that allows a window to be moved with the mouse.

This is a special command that can only be assigned in Wingo's mouse configuration file. Invoking this command in any other way has no effect.

MouseResize(self, Direction)

source code 

Initiates a drag that allows a window to be resized with the mouse.

Direction specifies how the window should be resized, and what the pointer should look like. For example, if Direction is set to "BottomRight", then only the width and height of the window can change---but not the x or y position.

Valid values for Direction are: Infer, Top, Bottom, Left, Right, TopLeft, TopRight, BottomLeft and BottomRight. When "Infer" is used, the direction is determined based on where the pointer is on the window when the drag is initiated.

This is a special command that can only be assigned in Wingo's mouse configuration file. Invoking this command in any other way has no effect.

Move(self, Client, X, Y)

source code 

Moves the window specified by Client to the x and y position specified by X and Y. Note that the origin is located in the top left corner.

X and Y may either be pixels (integers) or ratios in the range 0.0 to 1.0 (specifically, (0.0, 1.0]). Ratios are measured with respect to the window's workspace's geometry.

Client may be the window id or a substring that matches a window name.

MovePointer(self, X, Y)

source code 

Moves the pointer to the x and y position specified by X and Y. Note the the origin is located in the top left corner.

MovePointerRelative(self, X, Y)

source code 

Moves the pointer to the x and y position specified by X and Y relative to the current workspace. Note the the origin is located in the top left corner of the current workspace.

X and Y may either be pixels (integers) or ratios in the range 0.0 to 1.0 (specifically, (0.0, 1.0]). Ratios are measured with respect to the workspace's geometry.

MoveRelative(self, Client, X, Y)

source code 

Moves the window specified by Client to the x and y position specified by X and Y, relative to its workspace. Note that the origin is located in the top left corner of the client's workspace.

X and Y may either be pixels (integers) or ratios in the range 0.0 to 1.0 (specifically, (0.0, 1.0]). Ratios are measured with respect to the window's workspace's geometry.

Client may be the window id or a substring that matches a window name.

Not(self, Op)

source code 

Returns the negation of Op. When Op is 0, Not returns 1. When Op is 1, Not returns 0.

If Op is not in {0, 1}, then a warning is logged and nil is returned.

Or(self, Op1, Op2)

source code 

Returns the logical OR of Op1 and Op2.

If Op1 or Op2 is not in {0, 1}, then a warning is logged and nil is returned.

Raise(self, Client)

source code 

Raises the window specified by Client to the top of its layer.

Client may be the window id or a substring that matches a window name.

RemoveWorkspace(self, Workspace)

source code 

Removes the workspace specified by Workspace. Note that a workspace can *only* be removed if it is empty (i.e., does not contain any windows).

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

RenameWorkspace(self, Workspace, NewName)

source code 

Renames the workspace specified by Workspace to the name in NewName.

Workspace may be a workspace index (integer) starting at 0, or a workspace name. NewName can only be a string.

Resize(self, Client, Width, Height)

source code 

Resizes the window specified by Client to some width and height specified by Width and Height.

Width and Height may either be pixels (integers) or ratios in the range 0.0 to 1.0 (specifically, (0.0, 1.0]). Ratios are measured with respect to the window's workspace's geometry.

Client may be the window id or a substring that matches a window name.

Restart(self)

source code 

Restarts Wingo in place using exec. This should be used to reload Wingo after you've made changes to its configuration.

Script(self, Command)

source code 

Executes a script in $XDG_CONFIG_HOME/wingo/scripts. The command may include arguments.

SelectClient(self, TabCompletion, OnlyActiveWorkspace, OnlyVisible, ShowIconified)

source code 

Shows a centered prompt window with a list of clients satisfying the arguments provided.

OnlyActiveWorkspace specifies that only clients on the current workspace should be listed. Valid values are "yes" or "no".

OnlyVisible specifies that only clients on visible workspaces should be listed. Valid values are "yes" or "no".

ShowIconified specifies that iconified clients will be shown. Valid values are "yes" or "no".

TabCompletetion can be set to either "Prefix", "Any" or "Multiple". When it's set to "Prefix", the clients can be searched by a prefix matching string. When it's set to "Any", the clients can be searched by a substring matching string. When it's set to "Multiple", the clients can be searched by multiple space- separated substring matching strings.

This command may be used as a sub-command to pass a particular client to another command.

SelectWorkspace(self, TabCompletion)

source code 

Shows a centered prompt window with a list of all workspaces.

TabCompletetion can be set to either "Prefix", "Any" or "Multiple". When it's set to "Prefix", the clients can be searched by a prefix matching string. When it's set to "Any", the clients can be searched by a substring matching string. When it's set to "Multiple", the clients can be searched by multiple space- separated substring matching strings.

This command may be used as a sub-command to pass a particular workspace to another command.

SetLayout(self, Workspace, Name)

source code 

Sets the current layout of the workspace specified by Workspace to the layout named by Name. If a layout with name Name does not exist, this command has no effect.

Note that this command has no effect if the workspace is not visible.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

SetOpacity(self, Client, Opacity)

source code 

Sets the opacity of the window specified by Client to the opacity level specified by Opacity.

This command won't have any effect unless you're running a compositing manager like compton or cairo-compmgr.

Client may be the window id or a substring that matches a window name.

Opacity should be a float in the range 0.0 to 1.0, inclusive, where 0.0 is completely transparent and 1.0 is completely opaque.

Shell(self, Command)

source code 

Attempts to execute the shell command specified by Command. If an error occurs, it will be logged to Wingo's stderr.

ShowClientInPanels(self, Client)

source code 

Sets the appropriate flags so that the window specified by Client is shown on panels and pagers.

Client may be the window id or a substring that matches a window name.

TagGet(self, Client, Name)

source code 

Retrieves the tag with name Name for the client specified by Client.

Client may be the window id or a substring that matches a window name.

Tag names may only contain the following characters: [-a-zA-Z0-9_].

TagSet(self, Client, Name, Value)

source code 

Sets the tag with name Name to value Value for the client specified by Client.

Client may be the window id or a substring that matches a window name.

Tag names may only contain the following characters: [-a-zA-Z0-9_].

ToggleFloating(self, Client)

source code 

Toggles whether the window specified by Client should be forced into the floating layout. A window forced into the floating layout CANNOT be tiled.

Client may be the window id or a substring that matches a window name.

ToggleIconify(self, Client)

source code 

Iconifies (minimizes) or deiconifies (unminimizes) the window specified by Client.

Client may be the window id or a substring that matches a window name.

ToggleMaximize(self, Client)

source code 

Maximizes or restores the window specified by Client.

Client may be the window id or a substring that matches a window name.

ToggleStackAbove(self, Client)

source code 

Toggles the layer of the window specified by Client from normal to above. When a window is in the "above" layer, it will always be above other (normal) clients.

Client may be the window id or a substring that matches a window name.

ToggleStackBelow(self, Client)

source code 

Toggles the layer of the window specified by Client from normal to below. When a window is in the "below" layer, it will always be below other (normal) clients.

Client may be the window id or a substring that matches a window name.

ToggleSticky(self, Client)

source code 

Toggles the sticky status of the window specified by Client. When a window is sticky, it will always be visible unless iconified. (i.e., it does not belong to any particular workspace.)

Client may be the window id or a substring that matches a window name.

Unfloat(self, Client)

source code 

Unfloats the window specified by Client. If the window is not floating, this command has no effect.

Client may be the window id or a substring that matches a window name.

Unmaximize(self, Client)

source code 

Unmaximizes the window specified by Client. If the window is not maximized, this command has no effect.

Client may be the window id or a substring that matches a window name.

WingoExec(self, Commands)

source code 

Executes a series of Wingo commands specified by Commands. If an error occurs while executing the command, it will be shown in a popup message.

Workspace(self, Workspace)

source code 

Sets the current workspace to the one specified by Workspace.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

WorkspaceGreedy(self, Workspace)

source code 

Sets the current workspace to the one specified by Workspace in a greedy fashion.

A greedy switch *always* brings the specified workspace to the currently focused head. (N.B. Greedy is only different when switching between two visible workspaces.)

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

WorkspaceGreedyWithClient(self, Workspace, Client)

source code 

Sets the current workspace to the workspace specified by Workspace in a greedy fashion, and moves the window specified by Client to that workspace.

A greedy switch *always* brings the specified workspace to the currently focused head. (N.B. Greedy is only different when switching between two visible workspaces.)

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

Client may be the window id or a substring that matches a window name.

WorkspaceHead(self, Workspace)

source code 

Retrieves the head index of the workspace specified by Workspace. If the workspace is not visible, then -1 is returned.

Head indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

WorkspaceSendClient(self, Workspace, Client)

source code 

Sends the window specified by Client to the workspace specified by Workspace.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

Client may be the window id or a substring that matches a window name.

WorkspaceToHead(self, Head, Workspace)

source code 

Sets the workspace specified by Workspace to appear on the head specified by the Head index.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

Head indexing starts at 0. Heads are ordered by their physical position: left to right and then top to bottom.

WorkspaceWithClient(self, Workspace, Client)

source code 

Sets the current workspace to the workspace specified by Workspace, and moves the window specified by Client to that workspace.

Workspace may be a workspace index (integer) starting at 0, or a workspace name.

Client may be the window id or a substring that matches a window name.