Widgets

class HyprlandWorkspaces (buttons: Iterable[WorkspaceButton] | None = None, buttons_factory: Callable[[int], WorkspaceButton | None] | None = Workspaces.default_buttons_factory, invert_scroll: bool = False, empty_scroll: bool = False, **kwargs)

Bases: Workspaces

• Parameters:
  • buttons (Iterable *[*WorkspaceButton ] | None , optional) — a list of predefined buttons, if a workspace was opened but no button representing it in the given list was found, call the buttons factory function to create a button for that workspace, defaults to None
  • buttons_factory (Callable [ *[*int ] , WorkspaceButton | None ] | None , optional) — a factory for creating buttons once they’re needed, the given function will only be called if no button was found for the new workspace in the given list of predefined buttons, the function can return None instead of a button to ignore adding that workspace, defaults to default_buttons_factory
  • invert_scroll (bool , optional) — invert the scroll wheel’s direction (for switching via the wheel), defaults to False
  • empty_scroll (bool , optional) — scroll through empty workspaces (if found in the list), defaults to False

class HyprlandActiveWindow (formatter: FormattedString = FormattedString("{'Desktop' if not win_title else truncate(win_title, 42)}", truncate=truncate), **kwargs)

Bases: ActiveWindow

• Parameters:
  • label (str | None , optional) — the label’s text to use as the child of this button, defaults to None
  • image (Gtk.Image | None , optional) — an image widget to be added inside this button, defaults to None
  • child (Gtk.Widget | None , optional) — a child widget to put inside this button, defaults to None
  • name (str | None , optional) — the name identifer for this widget (useful for styling), defaults to None
  • visible (bool , optional) — whether should this widget be visible or not once initialized, defaults to True
  • all_visible (bool , optional) — whether should this widget and all of its children be visible or not once initialized, defaults to False
  • style (str | None , optional) — inline stylesheet to be applied on this widget, defaults to None
  • style_classes (Iterable *[*str ] | str | None , optional) — a list of style classes to be added into this widget once initialized, defaults to None
  • tooltip_text (str | None , optional) — the text that should be rendered inside the tooltip, defaults to None
  • tooltip_markup (str | None , optional) — same as tooltip_text but it accepts simple markup expressions, defaults to None
  • h_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — horizontal alignment of this widget (compared to its parent), defaults to None
  • v_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — vertical alignment of this widget (compared to its parent), defaults to None
  • h_expand (bool , optional) — whether should this widget fill in all the available horizontal space or not, defaults to False
  • v_expand (bool , optional) — whether should this widget fill in all the available vertical space or not, defaults to False
  • size (Iterable *[*int ] | int | None , optional) — a fixed size for this widget (not guranteed to get applied), defaults to None

class HyprlandLanguage (keyboard: str = '.*', formatter: FormattedString = FormattedString('{language}'), **kwargs)

Bases: Language

• Parameters:
  • label (str | None , optional) — the label’s text to use as the child of this button, defaults to None
  • image (Gtk.Image | None , optional) — an image widget to be added inside this button, defaults to None
  • child (Gtk.Widget | None , optional) — a child widget to put inside this button, defaults to None
  • name (str | None , optional) — the name identifer for this widget (useful for styling), defaults to None
  • visible (bool , optional) — whether should this widget be visible or not once initialized, defaults to True
  • all_visible (bool , optional) — whether should this widget and all of its children be visible or not once initialized, defaults to False
  • style (str | None , optional) — inline stylesheet to be applied on this widget, defaults to None
  • style_classes (Iterable *[*str ] | str | None , optional) — a list of style classes to be added into this widget once initialized, defaults to None
  • tooltip_text (str | None , optional) — the text that should be rendered inside the tooltip, defaults to None
  • tooltip_markup (str | None , optional) — same as tooltip_text but it accepts simple markup expressions, defaults to None
  • h_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — horizontal alignment of this widget (compared to its parent), defaults to None
  • v_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — vertical alignment of this widget (compared to its parent), defaults to None
  • h_expand (bool , optional) — whether should this widget fill in all the available horizontal space or not, defaults to False
  • v_expand (bool , optional) — whether should this widget fill in all the available vertical space or not, defaults to False
  • size (Iterable *[*int ] | int | None , optional) — a fixed size for this widget (not guranteed to get applied), defaults to None

class WorkspaceButton (id: int, label: FormattedString | str | None = None, image: Image | None = None, child: Widget | None = None, name: str | None = None, visible: bool = True, all_visible: bool = False, style: str | None = None, style_classes: Iterable[str] | str | None = None, tooltip_text: str | None = None, tooltip_markup: str | None = None, h_align: Literal['fill', 'start', 'end', 'center', 'baseline'] | Align | None = None, v_align: Literal['fill', 'start', 'end', 'center', 'baseline'] | Align | None = None, h_expand: bool = False, v_expand: bool = False, size: Iterable[int] | int | None = None, **kwargs)

Bases: Button

• Parameters:
  • label (str | None , optional) — the label’s text to use as the child of this button, defaults to None
  • image (Gtk.Image | None , optional) — an image widget to be added inside this button, defaults to None
  • child (Gtk.Widget | None , optional) — a child widget to put inside this button, defaults to None
  • name (str | None , optional) — the name identifer for this widget (useful for styling), defaults to None
  • visible (bool , optional) — whether should this widget be visible or not once initialized, defaults to True
  • all_visible (bool , optional) — whether should this widget and all of its children be visible or not once initialized, defaults to False
  • style (str | None , optional) — inline stylesheet to be applied on this widget, defaults to None
  • style_classes (Iterable *[*str ] | str | None , optional) — a list of style classes to be added into this widget once initialized, defaults to None
  • tooltip_text (str | None , optional) — the text that should be rendered inside the tooltip, defaults to None
  • tooltip_markup (str | None , optional) — same as tooltip_text but it accepts simple markup expressions, defaults to None
  • h_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — horizontal alignment of this widget (compared to its parent), defaults to None
  • v_align (Literal [ “fill” , “start” , “end” , “center” , “baseline” ] | Gtk.Align | None , optional) — vertical alignment of this widget (compared to its parent), defaults to None
  • h_expand (bool , optional) — whether should this widget fill in all the available horizontal space or not, defaults to False
  • v_expand (bool , optional) — whether should this widget fill in all the available vertical space or not, defaults to False
  • size (Iterable *[*int ] | int | None , optional) — a fixed size for this widget (not guranteed to get applied), defaults to None

property id int

property active bool

property urgent bool

property empty bool

def get_hyprland_connection ()Hyprland

def Language (*args, **kwargs)

def Workspaces (*args, **kwargs)

def ActiveWindow (*args, **kwargs)