hyprpy

Hymprpy

HYPRPY est une bibliothèque qui fournit des liaisons Python pour le compositeur de Hyprland Wayland.

Avec HYPRPY, vous pouvez très facilement récupérer des informations sur les fenêtres, les espaces de travail et les moniteurs dans une instance HYPRLAND en cours d'exécution. Il propose également un moniteur d'événements, vous permettant d'écrire vos propres fonctions de rappel qui s'exécutent en réponse aux événements HYPRLAND.

HYPRPY utilise des sockets Unix pour communiquer avec HYPRLAND, ce qui le rend rapide et efficace .

Veuillez consulter la documentation! HYPRPY est entièrement dactylographié et largement documenté. Bonne hacking?

Start

Installation

Pépin

Installez HYPRPY avec PIP en fonctionnant:

pip install hyprpy

Arch Linux

HYPRPY est disponible dans l'AUR en tant que python-hyprpy .

Si vous utilisez une aide AUR comme PARU, installez-la simplement en fonctionnant:

paru -S python-hyprpy

Exemples d'utilisation

 from hyprpy import Hyprland

instance = Hyprland ()


# Fetch active window and display information:
window = instance . get_active_window ()
print ( window . wm_class )
print ( window . width )
print ( window . position_x )


# Print information about the windows on the active workspace
workspace = instance . get_active_workspace ()
for window in workspace . windows :
    print ( f" { window . address } : { window . title } [ { window . wm_class } ]" )


# Get the resolution of the first monitor
monitor = instance . get_monitor_by_id ( 0 )
if monitor :
    print ( f" { monitor . width } x { monitor . height } " )


# Get all windows currently on the special workspace
special_workspace = instance . get_workspace_by_name ( "special" )
if special_workspace :
    special_windows = special_workspace . windows
    for window in special_windows :
        print ( window . title )


# Show a desktop notification every time we switch to workspace 6
from hyprpy . utils . shell import run_or_fail

def workspace_changed ( sender , ** kwargs ):
    current_workspace_id = kwargs . get ( 'active_workspace_id' )
    if current_workspace_id == 6 :
        run_or_fail ([ "notify-send" , "We are on workspace 6." ])

instance . signal_active_workspace_changed . connect ( workspace_changed )
instance . watch ()

Développement

HYPRPY est en développement actif! Veuillez déposer un problème si vous trouvez des bogues ou si vous avez une demande de fonctionnalité.

Vos contributions sont grandement appréciées.

Feuille de route

• Inclure les répartiteurs dans l'API des composants