xdotool - En ligne dans le Cloud

PROGRAMME:

Nom

xdotool - outil d'automatisation X11 en ligne de commande

SYNOPSIS

xdotool cmd arguments...

Notation : Certaines documentations utilisent [la fenêtre] pour désigner un argument de fenêtre facultatif. Cette
case signifie que l'argument, s'il n'est pas présent, sera par défaut « %1 ». Voir "PILE DE FENÊTRES" pour
ce que "%1" signifie.

DESCRIPTION

xdotool vous permet de simuler par programmation (ou manuellement) la saisie au clavier et l'activité de la souris,
déplacer et redimensionner les fenêtres, etc. Il le fait en utilisant l'extension XTEST de X11 et d'autres Xlib
fonctions.

Il existe un certain support pour les astuces Extended Window Manager (alias EWMH ou NetWM). Voir le
Pour plus d'informations, reportez-vous à la section « INDICES DE GESTION DE FENÊTRES ÉTENDU ».

CLAVIER COMMANDES

clé [choix] frappe [frappe ...]
Options :

--la fenêtre fenêtre
Envoyez des frappes à un identifiant de fenêtre spécifique. Vous pouvez utiliser les références "WINDOW STACK"
comme "%1" et "%@" ici. S'il y a une pile de fenêtres, alors "%1" est la valeur par défaut,
sinon la fenêtre courante est utilisée.

Voir aussi : "SENDEVENT NOTES" et "WINDOW STACK"

--clearmodifiers
Effacez les modificateurs avant d'envoyer des frappes. Voir CLEARMODIFICATEURS ci-dessous.

--retard millisecondes
Délai entre les frappes. La valeur par défaut est 12 ms.

Tapez une frappe donnée. Les exemples étant "alt+r", "Control_L+J", "ctrl+alt+n",
"Retour arrière".

En règle générale, toute chaîne X Keysym valide fonctionnera. Les touches multiples sont séparées par '+'.
Des alias existent pour "alt", "ctrl", "shift", "super" et "meta" qui correspondent tous à Foo_L,
tels que Alt_L et Control_L, etc.

Dans les cas où votre clavier n'a pas réellement la touche que vous voulez taper, xdotool
trouvera automatiquement un code clé inutilisé et l'utilisera pour taper la clé.

Par rapport au "CHAINAGE DE COMMANDES", cette commande consomme le reste du
arguments ou jusqu'à ce qu'une nouvelle commande xdotool soit vue, car aucune commande xdotool n'est
frappes valides.

Exemple : envoyer la frappe "F2"
clé xdotool F2

Exemple : envoyez "a" avec un accent dessus (pas sur les claviers anglais, mais fonctionne toujours
avec xdotool)
clé xdotool Aacute

Exemple : envoyez ctrl+l puis BackSpace en tant que frappes distinctes :
Touche xdotool ctrl+l Retour arrière

Exemple : envoyer ctrl+c à toutes les fenêtres correspondant au titre 'gdb' (voir "CHAINAGE DE COMMANDES")
recherche xdotool --name clé gdb ctrl+c

keydown [choix] frappe
Identique à ci-dessus, sauf que seuls les événements keydown (press) sont envoyés.

keyup frappe
Identique à ci-dessus, sauf que seuls les événements de keyup (release) sont envoyés.

type [choix] quelque chose à type
Options :

--la fenêtre ID de fenêtre
Envoyez des frappes à un identifiant de fenêtre spécifique. Voir « ENVOYER DES NOTES SUR L'ÉVÉNEMENT » ci-dessous. Le défaut,
si aucune fenêtre n'est donnée, dépend de la pile de fenêtres. Si la pile de fenêtres est vide
la fenêtre actuelle est tapée à l'aide de XTEST. Sinon, la valeur par défaut est "%1" (voir
"PILE DE FENÊTRES").

--retard millisecondes
Délai entre les frappes. La valeur par défaut est 12 ms.

--clearmodifiers
Effacez les modificateurs avant d'envoyer des frappes. Voir CLEARMODIFICATEURS ci-dessous.

Tapez comme si vous l'aviez tapé. Prend en charge les nouvelles lignes et les tabulations (nouvelle ligne et tabulation ASCII). Chaque
la frappe est séparée par un délai donné par le --retard option.

Par rapport au "CHAINAGE DE COMMANDES", cette commande consomme le reste du
arguments et les tape. C'est-à-dire qu'aucune commande ne peut enchaîner après 'type'.

Exemple : pour taper « Hello world ! » vous feriez:
xdotool tapez 'Bonjour tout le monde !'

SOURIS COMMANDES

souris [choix] x y OR 'restaurer'
Déplacez la souris sur les coordonnées X et Y spécifiques à l'écran.

Vous pouvez déplacer la souris à l'emplacement précédent si vous spécifiez "restaurer" au lieu d'un
Coordonnées X et Y. La restauration ne fonctionne que si vous avez déménagé précédemment dans ce même
appel de commande. De plus, cela ne fonctionne pas avec l'option --window.

Par exemple, pour cliquer sur le coin supérieur gauche de l'écran et déplacer la souris vers le
position d'origine avant de le déplacer, utilisez ceci :
xdotool mousemove 0 0 clic 1 mousemove restaurer

--la fenêtre FENÊTRE
Spécifiez une fenêtre par rapport à laquelle se déplacer. Les coordonnées 0,0 sont en haut à gauche du
fenêtre que vous choisissez.

Les références "WINDOW STACK" sont valides ici, telles que %1 et %@. Cependant, en utilisant %@
n'a probablement pas de sens.

--filtrer ÉCRAN
Déplacez la souris sur l'écran spécifié pour vous déplacer. Ceci n'est utile que si vous avez
plusieurs écrans et N'UTILISENT PAS Xinerama.

La valeur par défaut est l'écran actuel. Si vous spécifiez --window, l'indicateur --screen est
ignoré.

--polaire
Utilisez des coordonnées polaires. Cela fait de « x » un angle (en degrés, 0-360, etc.) et « y »
la distance.

La rotation commence à « haut » (0 degrés) et tourne dans le sens des aiguilles d'une montre : 90 = droite, 180 = bas,
270 = gauche.

L'origine par défaut est le centre de l'écran actuel. Si vous spécifiez un
--window, alors l'origine est le centre de cette fenêtre.

--clearmodifiers
Voir CLEARMODIFICATEURS

--sync
Après avoir envoyé la demande de déplacement de la souris, attendez que la souris soit réellement déplacée. Si
aucun mouvement n'est nécessaire, nous n'attendrons pas. Ceci est utile pour les scripts qui dépendent
sur les actions en cours d'achèvement avant de passer à autre chose.

Remarque : Nous attendons que la souris bouge, pas nécessairement qu'elle
atteint votre destination prévue. Certaines applications verrouillent le curseur de la souris sur
certaines régions de l'écran, il est donc préférable d'attendre un mouvement dans le
cas général que d'attendre une cible spécifique.

mousemove_relative [choix] x y
Déplacez les pixels x,y de la souris par rapport à la position actuelle du curseur de la souris.

--polaire
Utilisez des coordonnées polaires. Cela fait de « x » un angle (en degrés, 0-360, etc.) et « y »
la distance.

La rotation commence à « haut » (0 degrés) et tourne dans le sens des aiguilles d'une montre : 90 = droite, 180 = bas,
270 = gauche.

--sync
Après avoir envoyé la demande de déplacement de la souris, attendez que la souris soit réellement déplacée. Si
aucun mouvement n'est nécessaire, nous n'attendrons pas. Ceci est utile pour les scripts qui dépendent
sur les actions en cours d'achèvement avant de passer à autre chose.

Notez que nous attendons que la souris bouge, pas nécessairement qu'elle
atteint votre destination prévue. Certaines applications verrouillent le curseur de la souris sur
certaines régions de l'écran, il est donc préférable d'attendre un mouvement dans le
cas général que d'attendre une cible spécifique.

--clearmodifiers
Voir CLEARMODIFICATEURS

incroyablement réaliste effect. [choix] bouton (dans la fenêtre de contrôle qui apparaît maintenant)
Envoyez un clic, c'est-à-dire un mousedown suivi de mouseup pour le bouton donné avec un
court délai entre les deux (actuellement 12ms).

Les boutons sont généralement mappés de cette façon : la souris gauche correspond à 1, le milieu correspond à 2, la droite correspond à 3, la molette vers le haut correspond à
4, la roue vers le bas est 5.

--clearmodifiers
Effacez les modificateurs avant de cliquer. Voir CLEARMODIFICATEURS ci-dessous.

--répéter RÉPÉTER
Spécifiez combien de fois cliquer. La valeur par défaut est 1. Pour un double-clic, utilisez '--repeat
2'

--retard MILLISECONDES
Spécifiez le délai, en millisecondes, entre les clics. Cette option n'est pas
utilisé si le --répéter flag est défini sur 1 (par défaut).

--la fenêtre FENÊTRE
Spécifiez une fenêtre à laquelle envoyer un clic. Voir "SENDEVENT NOTES" ci-dessous pour les mises en garde. Les usages
la position actuelle de la souris lors de la génération de l'événement.

La valeur par défaut, si aucune fenêtre n'est donnée, dépend de la pile de fenêtres. Si la fenêtre
la pile est vide, la fenêtre actuelle est tapée à l'aide de XTEST. Sinon, la valeur par défaut
est "%1" (voir "PILE DE FENÊTRES").

souris vers le bas [choix] bouton (dans la fenêtre de contrôle qui apparaît maintenant)
Pareil que incroyablement réaliste effect. , sauf que seul un clic de souris est envoyé.

mouseup [choix] bouton (dans la fenêtre de contrôle qui apparaît maintenant)
Pareil que incroyablement réaliste effect. , sauf que seule une souris vers le haut est envoyée.

obtenir l'emplacement de la souris [--coquille]
Affiche les identifiants x, y, écran et fenêtre du curseur de la souris. Les numéros d'écran seront
différent de zéro si vous avez plusieurs moniteurs et n'utilisez pas Xinerama.

--coquille
Cela rend les données de shell de sortie getmouselocation que vous pouvez évaluer. Exemple:

% xdotool getmouselocation --shell
X = 880
Y = 443
ÉCRAN=0
FENÊTRE=16777250

% évaluation $(xdotool getmouselocation --shell)
% écho $X,$Y
714,324

behavior_screen_edge [choix] où commander ...
Liez une action à des événements lorsque la souris touche le bord ou le coin de l'écran.

Les options sont:

--retard MILLISECONDES
Délai en millisecondes avant l'exécution de la commande. Cela vous permet d'exiger un
un bord ou un coin donné à tenir pendant une courte période avant que votre commande ne s'exécute.
Si vous quittez le bord ou le coin avant l'expiration du délai, le temps sera réinitialisé.

--mettre au repos MILLISECONDES
Délai en millisecondes avant l'exécution de la commande suivante. Cela permet d'éviter
exécuter accidentellement votre commande des fois supplémentaires ; particulièrement utile si vous avez un
très court --delay (comme la valeur par défaut de 0).

Chronologie de l'événement

* La souris frappe un bord ou un coin.
* Si le délai est différent de zéro, la souris doit rester dans ce bord ou ce coin jusqu'à l'expiration du délai.
* Si toujours dans le bord/coin, déclenchez.
* Si la mise au repos est différente de zéro, alors il y a une période de refroidissement où le prochain
le déclencheur ne peut pas se produire

Les valeurs « où » valides sont :

à gauche
en haut à gauche
top
en haut à droite
bien
en bas à gauche
bas
en bas à droite

Exemples :
# Activez google-chrome lorsque vous déplacez la souris vers le coin inférieur gauche :
xdotool behavior_screen_edge en bas à gauche \
recherche --class google-chrome windowactivate

# Allez à l'espace de travail suivant (à droite). Connu pour fonctionner dans GNOME (metacity et compiz)
xdotool behavior_screen_edge --delay 500 touche en bas à droite XF86Forward

# Activez firefox et effectuez une recherche sur le Web dans un nouvel onglet pour le texte dans votre presse-papiers
xdotool behavior_screen_edge --delay 1000 en haut à gauche \
recherche --classname Navigateur \
windowactivate --sync key --delay 250 ctrl+t ctrl+k ctrl+v Retour

FENÊTRE COMMANDES

recherche [choix] modèle
Recherchez des fenêtres avec des titres, des noms ou des classes avec un modèle d'expression régulière.
La sortie est une liste délimitée par des lignes d'identifiants de fenêtre X. Si vous utilisez "COMMAND
CHAINING", la commande de recherche n'écrira les identifiants de fenêtre sur stdout que s'il s'agit du dernier
(ou seulement) commande dans la chaîne ; sinon, il est silencieux.

Le résultat est enregistré dans la pile de fenêtres pour les futures commandes enchaînées. Voir "FENÊTRE
STACK" et "COMMAND CHAINING" pour plus de détails.

Les options par défaut sont "--name --class --classname" (sauf si vous en spécifiez une ou
plus de --name --class ou --classname).

Les options disponibles sont:

--classer
Match contre la classe de fenêtre.

--nom du cours
Faites correspondre le nom de classe de la fenêtre.

--profondeur max N
Définir la profondeur de recherche de récursivité/enfant. La valeur par défaut est -1, ce qui signifie infini. 0 signifie non
profondeur, seules les fenêtres racine seront recherchées. Si vous souhaitez uniquement des fenêtres de niveau supérieur, définissez
maxdepth de 1 (ou 2, selon la façon dont votre gestionnaire de fenêtres fait les décorations).

--Nom
Faites correspondre le nom de la fenêtre. C'est la même chaîne qui est affichée dans le
barre de titre de la fenêtre.

--seulement visible
Afficher uniquement les fenêtres visibles dans les résultats. Cela signifie ceux avec l'état de la carte
Est visualisable.

--pid PID
Faites correspondre les fenêtres qui appartiennent à un identifiant de processus spécifique. Cela peut ne pas fonctionner pour certains X
applications qui ne définissent pas ces métadonnées sur ses fenêtres.

--filtrer N
Sélectionnez les fenêtres uniquement sur un écran spécifique. La valeur par défaut consiste à rechercher tous les écrans. Seul
significatif si vous avez plusieurs écrans et n'utilisez pas Xinerama.

--bureau N
Ne correspond qu'à Windows sur un certain bureau. 'N' est un nombre. La valeur par défaut est de rechercher
tous les ordinateurs de bureau.

--limite N
Arrêtez de chercher après avoir trouvé N fenêtres correspondantes. La spécification d'une limite vous aidera
accélérez votre recherche si vous ne voulez que quelques résultats.

La valeur par défaut n'est pas de limite de recherche (ce qui équivaut à '--limit 0')

--Titre
DÉCONSEILLÉ. Voir --name.

--tout
Exiger que toutes les conditions soient remplies. Par exemple:

xdotool search --all --pid 1424 --name "Hello World"

Cela correspondra uniquement aux fenêtres qui ont "Hello World" comme nom et qui appartiennent à
pid 1424.

--tout
Faites correspondre les fenêtres qui correspondent à n'importe quelle condition (logiquement, 'ou'). Ceci est activé par défaut.
Par exemple :

xdotool search --any --pid 1424 --name "Hello World"

Cela correspondra à toutes les fenêtres appartenant au pid 1424 ou aux fenêtres portant le nom "Hello World"

--sync
Bloquez jusqu'à ce qu'il y ait des résultats. Ceci est utile lorsque vous lancez un
l'application souhaite attendre que la fenêtre de l'application soit visible. Pour
Exemple:

Google Chrome &
xdotool search --sync --onlyvisible --class "google-chrome"

fenêtre de sélection
Obtenez l'identifiant de la fenêtre (pour un client) en cliquant dessus. Utile pour avoir des requêtes de scripts
vous les humains pour quelle fenêtre agir. Par exemple, tuer une fenêtre en cliquant dessus :

xdotool selectwindow windowkill

se comporter fenêtre action commander ...
Lier une action à un événement sur une fenêtre. Cela vous permet d'exécuter des commandes xdotool supplémentaires
chaque fois qu'un événement correspondant se produit.

La commande exécutée à la suite du comportement est exécutée avec %1 étant la fenêtre qui a été
agi sur. Les exemples suivent après la liste des événements.

Les événements suivants sont valides :

souris-entrée
Se déclenche lorsque la souris entre dans une fenêtre. Ceci est similaire aux événements « survoler » dans
javascript, si cela peut vous aider.

souris-congé
Se déclenche lorsque la souris quitte une fenêtre. C'est le contraire de "souris-entrée"

clic de souris
Se déclenche lorsque la souris est cliqué. Plus précisément, lorsque le bouton de la souris est relâché.

concentration
Se déclenche lorsque la fenêtre obtient le focus d'entrée.

tache
Se déclenche lorsque la fenêtre perd le focus.

Exemples :

# Imprime l'emplacement du curseur chaque fois que la souris entre dans un
# la fenêtre:
recherche xdotool --onlyvisible . se comporter %@ mouse-enter getmouselocation

# Affiche le titre de la fenêtre et le pid chaque fois qu'un xterm obtient le focus
xdotool search --class xterm behavior %@ focus getwindowname getwindowpid

# Émuler focus-follows-mouse
recherche xdotool. se comporter %@ mouse-enter windowfocus

obtenirwindowpid [la fenêtre]
Sortir le PID possédant une fenêtre donnée. Cela nécessite des efforts de la part de l'application propriétaire
une fenêtre et peut ne pas fonctionner pour toutes les fenêtres. Cela utilise la propriété _NET_WM_PID du
la fenêtre. Pour plus d'informations, reportez-vous à la section « CONSEILS POUR LE GESTIONNAIRE DE FENÊTRES ÉTENDU » ci-dessous.

Si aucune fenêtre n'est donnée, la valeur par défaut est '%1'. Si aucune fenêtre n'est sur la pile, alors cette
est une erreur. Voir "PILE DE FENÊTRES" pour plus de détails.

Exemple : Trouvez le PID pour tous les xterms :
recherche xdotool --class xterm getwindowpid %@

obtenir le nom de la fenêtre [la fenêtre]
Affiche le nom d'une fenêtre donnée, également appelé titre. C'est le texte affiché
dans la barre de titre de la fenêtre par votre gestionnaire de fenêtres.

Si aucune fenêtre n'est donnée, la valeur par défaut est '%1'. Si aucune fenêtre n'est sur la pile, alors cette
est une erreur. Voir "PILE DE FENÊTRES" pour plus de détails.

obtenir la géométrie de la fenêtre [choix] [la fenêtre]
Sortez la géométrie (emplacement et position) d'une fenêtre. Les valeurs comprennent : x, y,
largeur, hauteur et numéro d'écran.

--coquille
Valeurs de sortie adaptées à 'eval' dans un shell.

obtenirwindowfocus [-F]
Imprime l'identifiant de la fenêtre actuellement focalisée. Enregistre le résultat dans la fenêtre
empiler. Voir "PILE DE FENÊTRES" pour plus de détails.

Si la fenêtre actuelle n'a pas de propriété WM_CLASS, nous supposons qu'il ne s'agit pas d'un niveau supérieur normal
fenêtre et parcourez les parents jusqu'à ce que nous trouvions une fenêtre avec un ensemble WM_CLASS et
renvoyer cet identifiant de fenêtre.

Si vous voulez vraiment que la fenêtre ait actuellement le focus et ne vous souciez pas si elle a un
Paramètre WM_CLASS, puis utilisez 'getwindowfocus -f'

la taille de la fenêtre [options] [fenêtre] largeur hauteur
Définir la taille de la fenêtre de la fenêtre donnée. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut.
Voir "WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

Les pourcentages sont valables pour la largeur et la hauteur. Ils sont relatifs à la géométrie du
écran la fenêtre est allumée. Par exemple, pour faire une fenêtre sur toute la largeur de l'écran,
mais à mi-hauteur :

xdotool taille de la fenêtre I 100% 50%

Les pourcentages sont valides avec --usehints et signifient toujours la largeur de pixel par rapport au
taille de l'écran.

Les options disponibles sont:

--astuces d'utilisation
Utilisez les conseils de dimensionnement des fenêtres (lorsqu'ils sont disponibles) pour définir la largeur et la hauteur. C'est utile
sur les terminaux pour définir la taille en fonction de la ligne/colonne de texte plutôt que des pixels.

--sync
Après avoir envoyé la demande de taille de fenêtre, attendez que la fenêtre soit réellement redimensionnée.
Si aucun changement n'est nécessaire, nous n'attendrons pas. Ceci est utile pour les scripts qui
dépendent des actions en cours avant de passer à autre chose.

Remarque : Étant donné que de nombreux gestionnaires de fenêtres peuvent ignorer ou modifier le redimensionnement d'origine
demande, nous attendrons que la taille change de sa taille d'origine, pas nécessaire
à la taille demandée.

Exemple : Pour définir un terminal sur 80 x 24 caractères, vous utiliseriez :
xdotool windowssize --usehints some_windowid 80 24

fenetre [choix] [la fenêtre] x y
Déplacez la fenêtre à la position donnée. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir
"WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

Si la coordonnée x donnée est littéralement « x », alors la position x actuelle de la fenêtre sera
être inchangé. La même chose s'applique pour 'y'.

Exemples :

xdotool getactivewindow windowmove 100 100 # Passe à 100,100 XNUMX
xdotool getactivewindow windowmove x 100 # Passe à x 100
xdotool getactivewindow windowmove 100 y # Passe à 100, y
xdotool getactivewindow windowmove 100 y # Passe à 100, y

--sync
Après avoir envoyé la demande de déplacement de fenêtre, attendez que la fenêtre soit réellement déplacée. Si
aucun mouvement n'est nécessaire, nous n'attendrons pas. Ceci est utile pour les scripts qui dépendent
sur les actions en cours d'achèvement avant de passer à autre chose.

--relatif
Effectuez un mouvement par rapport à la position actuelle de la fenêtre.

focus de fenêtre [choix] [la fenêtre]
Concentrez une fenêtre. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "PILE DE FENÊTRES" et
" COMMAND CHAINING " pour plus de détails.

Utilise XSetInputFocus qui peut être ignoré par certains gestionnaires de fenêtres ou programmes.

--sync
Après avoir envoyé la demande de focus de fenêtre, attendez que la fenêtre soit réellement focalisée.
Ceci est utile pour les scripts qui dépendent des actions en cours avant le déplacement
sur.

plan de la fenêtre [choix] [la fenêtre]
Mapper une fenêtre. Dans la terminologie X11, mapper une fenêtre signifie la rendre visible sur le
filtrer. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "WINDOW STACK" et "COMMANDE
CHAINAGE" pour plus de détails.

--sync
Après avoir demandé le mappage de la fenêtre, attendez que la fenêtre soit réellement mappée
(visible). Ceci est utile pour les scripts qui dépendent des actions en cours d'exécution
avant de passer à autre chose.

fenêtreminimiser [choix] [la fenêtre]
Réduire une fenêtre. Dans la terminologie X11, cela s'appelle « iconifier ». Si aucune fenêtre n'est
donné, %1 est la valeur par défaut. Voir "WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

--sync
Après avoir demandé la réduction de la fenêtre, attendez que la fenêtre soit réellement réduite.
Ceci est utile pour les scripts qui dépendent des actions en cours avant le déplacement
sur.

lever de fenêtre [wind_id=%1]
Soulevez la fenêtre vers le haut de la pile. Cela peut ne pas fonctionner sur tous les gestionnaires de fenêtres. Si
aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "WINDOW STACK" et "COMMAND CHAINING" pour
plus de détails.

parent de fenêtre [fenêtre_source] fenêtre_de_destination
Reparent une fenêtre. Cela déplace le fenêtre_source être une fenêtre enfant de
fenêtre_de_destination. Si aucune source n'est donnée, %1 est la valeur par défaut. Fenêtre "PILE DE FENÊTRES"
les références (comme %1) sont valides pour les deux fenêtre_source et fenêtre_de_destination See
"WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

fenêtrefermer [la fenêtre]
Fermez une fenêtre. Cette action détruira la fenêtre, mais n'essaiera pas de tuer le
client le contrôlant. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "PILE DE FENÊTRES"
et "COMMAND CHAINING" pour plus de détails.

tue la fenêtre [la fenêtre]
Tuer une fenêtre. Cette action détruira la fenêtre et tuera le client qui la contrôle.
Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir WINDOW STACK et "COMMAND CHAINING" pour
plus de détails.

fenêtreunmap [choix] [wind_id=%1]
Démapper une fenêtre, la faisant n'apparaître plus sur votre écran. Si aucune fenêtre n'est donnée, %1
est la valeur par défaut. Voir "WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

--sync
Après avoir demandé le démappage de la fenêtre, attendez que la fenêtre soit réellement démappée
(caché). Ceci est utile pour les scripts qui dépendent des actions effectuées avant
passer.

set_window [choix] [fenêtre=%1]
Définir les propriétés d'une fenêtre. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "FENÊTRE
STACK" et "COMMAND CHAINING" pour plus de détails.

Options :

--Nom nouveau nom
Définir la fenêtre WM_NAME (le titre de la fenêtre, généralement)

--icon-nom nouveaunom de l'icône
Définir la fenêtre WM_ICON_NAME (le titre de la fenêtre lorsqu'il est minimisé, généralement)

--rôle nouveau rôle
Définir la fenêtre WM_WINDOW_ROLE

--nom du cours nouveau nom de classe
Définir le nom de la classe de fenêtre (à ne pas confondre avec la classe de fenêtre)

--classer nouvelle classe
Définir la classe de fenêtre (à ne pas confondre avec le nom de la classe de fenêtre)

--overrideredirection Plus-value
Définissez la valeur override_redirect de la fenêtre. Cette valeur est un indice pour le gestionnaire de fenêtres
pour savoir s'il doit être géré ou non. Si la valeur de redirection est 0, alors le
Le gestionnaire de fenêtres dessinera des bordures et traitera cette fenêtre normalement. Si la valeur est
1, le gestionnaire de fenêtres ignorera cette fenêtre.

Si vous modifiez cette valeur, votre gestionnaire de fenêtres peut ne pas remarquer le changement jusqu'à ce que le
la fenêtre est à nouveau mappée, vous voudrez peut-être émettre 'windowunmap' et 'windowmap' à
faites en sorte que le gestionnaire de fenêtres en prenne note.

DESKTOP ET FENÊTRE COMMANDES

Ces commandes suivent la norme EWMH. Voir la section "CONSEILS DE GESTIONNAIRE DE FENÊTRES ÉTENDU"
pour plus d'informations.

fenêtreactiver [choix] [la fenêtre]
Activez la fenêtre. Cette commande est différente de windowfocus : si la fenêtre est activée
un autre bureau, nous passerons à ce bureau. Il utilise également une méthode différente pour
monter la fenêtre. Je recommande d'essayer cette commande avant d'utiliser windowfocus, car
cela fonctionnera sur plus de gestionnaires de fenêtres.

Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir "WINDOW STACK" et "COMMAND CHAINING"
pour plus de détails.

--sync
Après avoir envoyé l'activation de la fenêtre, attendez que la fenêtre soit réellement activée.
Ceci est utile pour les scripts qui dépendent des actions en cours avant le déplacement
sur.

getactivefenêtre
Affiche la fenêtre active actuelle. Cette commande est souvent plus fiable que
getwindowfocus. Le résultat est enregistré dans la pile de fenêtres. Voir « PILE DE FENÊTRES » pour en savoir plus
détails.

set_num_desktops nombre
Modifie le nombre de bureaux ou d'espaces de travail.

get_num_desktops
Affiche le nombre actuel de bureaux.

get_desktop_viewport [--coquille]
Indiquez la position actuelle de la fenêtre. Si --shell est donné, la sortie est conviviale pour
coquillage eval.

Les fenêtres d'affichage sont parfois utilisées à la place des « bureaux virtuels » sur certains gestionnaires de fenêtres. UNE
viewport est simplement une vue sur une très grande zone de bureau.

set_desktop_viewport x y
Déplacez la fenêtre à la position donnée. Toutes les demandes ne seront pas satisfaites - certaines
les gestionnaires de fenêtres n'obéissent qu'aux requêtes qui s'alignent sur les limites de l'espace de travail, telles que le
taille de l'écran.

Par exemple, si votre écran fait 1280x800, vous pouvez passer au 2ème espace de travail en faisant :
xdotool set_desktop_viewport 1280 0

set_desktop [choix] numéro_de_bureau
Remplacez la vue actuelle par le bureau spécifié.

--relatif
Utilisez des mouvements relatifs au lieu d'absolus. Cela vous permet de vous déplacer par rapport au
bureau actuel.

get_desktop
Affiche le bureau actuel en vue.

set_desktop_for_window [la fenêtre] numéro_de_bureau
Déplacer une fenêtre vers un autre bureau. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir
"WINDOW STACK" et "COMMAND CHAINING" pour plus de détails.

get_desktop_for_window [la fenêtre]
Affiche le bureau contenant actuellement la fenêtre donnée. Déplacer une fenêtre vers une autre
bureau. Si aucune fenêtre n'est donnée, %1 est la valeur par défaut. Voir PILE DE FENÊTRES et "COMMANDE
CHAINAGE" pour plus de détails.

DIVERS COMMANDES

exec [choix] commander [...]
Exécuter un programme. Ceci est souvent utile lorsqu'il est combiné avec behavior_screen_edge pour faire
des choses comme le verrouillage de votre écran.

Options :

--sync
Bloquer jusqu'à ce que le processus enfant se termine. L'état de sortie du processus fils est ensuite transmis
au processus parent (xdotool) qui le copie.

Exemples :
# Verrouillez l'écran lorsque la souris se trouve dans le coin supérieur droit
xdotool behavior_screen_edge --delay 1000 en haut à droite \
exec commande gnome-économiseur d'écran --lock
# Remplacez 'xscreensaver-command -lock' si vous utilisez ce programme.

# Ce qui suit ne réussira pas à déplacer la souris car nous utilisons '--sync' et
# /bin/faux sorties différentes de zéro :
xdotool exécutable --sync /bin/faux déplacement de la souris 0 0

# Cela réussit, cependant, puisque nous n'utilisons pas --sync sur la commande exec.
exécutable xdotool /bin/faux déplacement de la souris 0 0

sleep secondes
Dormez pendant une période déterminée. Les fractions de secondes (comme 1.3 ou 0.4) sont valides ici.

ÉCRITURES

xdotool peut lire une liste de commandes via stdin ou un fichier si vous le souhaitez. Un script échouera
lorsqu'une commande échoue.

À vrai dire, le mode "script" n'est pas entièrement étoffé et peut tomber en deçà de vos attentes. Si
vous avez des suggestions, veuillez envoyer la liste par e-mail ou signaler un bug (Voir CONTACT).

Les scripts peuvent utiliser des arguments positionnels (représentés par $1, $2, ...) et un environnement
variables (comme $HOME ou $WINDOWID). Les arguments de citation devraient fonctionner comme prévu.

Les scripts sont traités pour l'expansion des paramètres et des variables d'environnement, puis s'exécutent comme si
vous aviez invoqué xdotool avec l'intégralité du script sur une seule ligne (en utilisant COMMAND CHAINING).

· Lire des commandes à partir d'un fichier :

nom de fichier xdotool

· Lire les commandes de stdin :

xdotool -

· Lire les commandes à partir d'un fichier redirigé

xdotool - < monfichier

Vous pouvez également écrire des scripts qui exécutent uniquement xdotool. Exemple:

#!/usr/local/bin/xdotool
recherche --onlyvisible --classname $1

taille de fenêtre %@ $2 $3
lève-fenêtre %@

déplacement de fenêtre %1 0 0
déplacement de fenêtre %2 $2 0
déplacement de fenêtre %3 0 $3
déplacement de fenêtre %4 $2 $3

Ce script prendra toutes les fenêtres correspondant à la requête de nom de classe donnée par arg1 ($1) et
les taille/les déplace dans une grille 2x2 avec des fenêtres dimensionnées par les 2ème et 3ème paramètres.

Voici un exemple d'utilisation :

% ./monscript xterm 600 400

L'exécuter comme ceci prendra 4 xterms visibles, les élèvera et les déplacera dans une tuile 2x2
grille avec chaque fenêtre 600x400 pixels de taille.

CLARMODIFIANTS

Toute commande prenant le --clearmodifiers flag tentera d'effacer toute entrée active
modificateurs pendant la commande et restaurez-les par la suite.

Par exemple, si vous deviez exécuter cette commande :
xdotool clé a

Le résultat serait « a » ou « A » selon que vous mainteniez ou non la touche Maj enfoncée
sur votre clavier. Souvent, il n'est pas souhaitable d'avoir des modificateurs actifs, donc vous pouvez dire
xdotool pour effacer tous les modificateurs actifs.

L'ordre des opérations si vous maintenez la touche Maj enfoncée pendant l'exécution de 'xdotool key --clearmodifiers a'
est la suivante:

1. Requête pour tous les modificateurs actifs (trouve le décalage, dans ce cas)
2. Essayez d'effacer le décalage en envoyant 'key up' pour la touche Shift
3. Exécute la « touche xdotool a » normale
4. Restaurer la touche Shift en envoyant 'key down' pour Shift

Le manuel de formation --clearmodifiers flag peut actuellement supprimer les éléments suivants :

· n'importe quelle touche de votre keymap active qui a un modificateur qui lui est associé. (Voir
xmodmapla sortie 'xmodmap -pm' de (1))

· boutons de la souris (1, 2, 3, 4 et 5)

· verrouillage des majuscules

ENVOYER NOTES

Si vous essayez d'envoyer une entrée de touche à une fenêtre spécifique et qu'il ne semble pas
fonctionne, il est probable que votre application ignore les événements générés par xdotool.
C'est assez courant.

L'envoi de frappes à une fenêtre spécifique utilise une API différente de la simple saisie dans le
fenêtre active. Si vous spécifiez 'xdotool type --window 12345 hello', xdotool générera
événements clés et les envoyer directement à la fenêtre 12345. Cependant, les serveurs X11 définiront un
drapeau spécial sur tous les événements générés de cette manière (voir XEvent.xany.send_event dans X11
Manuel). De nombreux programmes observent ce drapeau et rejettent ces événements.

Il est important de noter que pour les événements de touche et de souris, nous n'utilisons XSendEvent que lorsqu'un
fenêtre spécifique est ciblée. Sinon, nous utilisons XTEST.

Certains programmes peuvent être configurés pour accepter des événements même s'ils sont générés par xdotool.
Consultez la documentation de votre application pour obtenir de l'aide.

Notes d'application spécifiques (issues des tests de l'auteur) : * Firefox 3 semble ignorer tout
entrée lorsqu'il n'a pas le focus. * xterm peut être configuré pendant l'exécution avec
ctrl + clic gauche, 'Autoriser SendEvents' * gnome-terminal semble accepter l'entrée générée par
défaut.

FENÊTRE STACK

Certaines commandes (search, getactivewindow, getwindowfocus) trouveront des fenêtres pour vous.
Ces résultats sont généralement imprimés sur stdout, mais ils sont également enregistrés en mémoire pour de futures
utiliser pendant la durée de vie du processus xdotool. Voir « CHAINAGE DE COMMANDE » pour en savoir plus
</br>L’Information.

Les seules modifications prises en charge pour la pile de fenêtres sont de la remplacer. c'est-à-dire deux sur deux
recherches séquentielles, seuls les derniers résultats seront la pile de fenêtres.

COMMAND CHAÎNE

xdotool prend en charge l'exécution de plusieurs commandes sur une seule invocation. Généralement, vous commencerez
avec une commande de recherche (voir "WINDOW STACK") puis effectuez un ensemble d'actions sur ces
résultats.

Pour interroger la pile de fenêtres, vous pouvez utiliser la notation spéciale "%N" où N est un nombre ou le
'@' symbole. Si %N est donné, la Nième fenêtre sera sélectionnée dans la pile de fenêtres.
En général, vous ne voudrez que la première fenêtre ou toutes les fenêtres. A noter que l'ordre de
fenêtres dans la pile de fenêtres correspond à l'ordre d'empilement des fenêtres, c'est-à-dire le plus bas
fenêtre sera signalée en premier (voir Arbre XQuery(3)). Ainsi, l'ordre des fenêtres dans le
La pile de fenêtres peut ne pas être cohérente entre les appels.

La notation décrite ci-dessus est utilisée comme argument "fenêtre" pour toute commande donnée.

Par exemple, pour redimensionner tous les xterms à 80x24 :

recherche xdotool --class xterm -- windowsize --usehints %@ 80 24

Redimensionner déplacer la fenêtre actuelle :

xdotool getactivewindow windowmove 0 0

Dans tous les cas, l'argument de fenêtre par défaut, s'il est omis, sera par défaut « %1 ». Il est
évidemment une erreur si vous omettez l'argument window et que la pile de fenêtres est vide. Si tu
essayez d'utiliser la pile de fenêtres et elle est vide, c'est aussi une erreur.

Pour activer la première fenêtre firefox trouvée :

recherche xdotool --class firefox windowactivate

Ceux-ci feraient erreur :

activer la fenêtre xdotool
activation de la fenêtre xdotool %1
fenêtre xdotoolactiver %@

Lorsque xdotool se ferme, la pile de fenêtres actuelle est perdue.

De plus, les commandes qui modifient la « PILE DE FENÊTRES » n'imprimeront pas les résultats si elles
ne sont pas la dernière commande. Par exemple:

# Affiche la fenêtre active :
% xdotool getactivewindow
20971533

# Affiche le pid de la fenêtre active, mais pas l'identifiant de la fenêtre active :
% xdotool getactivewindowgetwindowpid
4686

ÉLARGI FENÊTRE DE VENTE ASTUCES

Les éléments suivants de la norme EWMH sont pris en charge :

_NET_SUPPORTÉ
Demande au gestionnaire de fenêtres ce qui est pris en charge

_NET_CURRENT_DESKTOP
Interrogez et définissez le bureau actuel. La prise en charge de ceci active ces commandes :
"set_desktop", "get_desktop".

_NET_WM_DESKTOP
Interrogez et définissez sur quel bureau une fenêtre vit. La prise en charge de cela permet à ces
commandes : "set_desktop_for_window", "get_desktop_for_window".

_NET_ACTIVE_WINDOW
Vous permet d'interroger et de définir la fenêtre active en demandant au gestionnaire de fenêtres de l'apporter
effronté. La prise en charge de ceci active les commandes suivantes : "windowactivate", "getactivewindow".

_NET_WM_PID
Cette fonctionnalité dépend de l'application et non du gestionnaire de fenêtres. Interroger le PID
posséder une fenêtre donnée. La prise en charge de ceci active ces commandes : "getwindowpid".

PRISE EN CHARGE Fonctionnalités

xdotool (et libxdo) essaieront de fonctionner en toutes circonstances. Cependant, il peut y avoir
certains cas où la fonctionnalité n'est pas fournie par votre serveur X ou par votre gestionnaire de fenêtres.
Dans ces cas, xdotool essaiera de détecter et de vous dire si une action nécessite une fonctionnalité
pas actuellement pris en charge par votre système.

Pour les fonctionnalités spécifiques au gestionnaire de fenêtres, voir "CONSEILS ÉTENDUS POUR LE GESTIONNAIRE DE FENÊTRES".

XTEST
Si votre serveur X ne prend pas en charge XTEST, certaines fonctionnalités de saisie et de mouvement de la souris
peut ne pas fonctionner. Concrètement, les actions de frappe et de souris qui agissent sur la "fenêtre courante"
(fenêtre 0 dans libxdo) sont peu susceptibles de fonctionner.

Dans la plupart des cas, XTEST est une fonctionnalité que vous pouvez activer sur votre serveur X si elle n'est pas activée
par défaut.

Vous pouvez voir la liste des extensions X prises en charge en tapant 'xdpyinfo' et en regardant le
text 'nombre d'extensions : ...'

Utilisez xdotool en ligne en utilisant les services onworks.net