BotreamDokümanlar Web sitesi English v0.1.1

Masaüstü komutları

window · desktop · sendkeys · mouse · screenshot · ocr · image · clipboard

window Window

Uygulama pencerelerini yönetir.

İşlemler (--action)

--action:open

Bir programı başlatır ve penceresini bir değişkene bağlar.

ParametreDeğerVarsayılanAçıklama
--path zorunlumetinProgram, ör. notepad.exe veya C:\Apps\erp.exe Ajan makinesindeki bir dosya.
--argumentsmetin
--titlemetinBeklenecek pencerenin başlığı (joker karakterler); başka bir program açan başlatıcılar için
--timeoutsayı30Saniye cinsinden zaman aşımı
--output zorunludeğişken adıBu pencere için değişken; masaüstü komutları onu --window:$name$ ile hedefler
--action:attach

Zaten açık olan bir pencereyi bir değişkene bağlar.

ParametreDeğerVarsayılanAçıklama
--titlemetinPencere başlığı (joker karakterler: *Invoice*)
--pathmetinProgram (joker karakterler), ör. erp.exe Ajan makinesindeki bir dosya.
--timeoutsayı30Saniye cinsinden zaman aşımı
--output zorunludeğişken adıBu pencere için değişken; masaüstü komutları onu --window:$name$ ile hedefler
--action:activate
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--action:close
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--action:maximize
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--action:minimize
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--action:restore
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--action:resize
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--width zorunlusayı
--height zorunlusayı
--action:move
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--x zorunlusayı
--y zorunlusayı
--action:exists
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--output zorunludeğişken adıSonucu alan değişken
--action:wait
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--timeoutsayı30Saniye cinsinden zaman aşımı
--action:getproperty
ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--property zorunlumetinPencere özelliği
--output zorunludeğişken adıSonucu alan değişken
--action:list
ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken

Örnekler

window --action:activate --window:$notepadWin$
window --action:wait --window:$notepadWin$ --timeout:30
window --action:exists --window:$notepadWin$ --output:isOpen
window --action:close --window:$notepadWin$
window --action:maximize --window:$notepadWin$
window --action:minimize --window:$notepadWin$
window --action:restore --window:$notepadWin$
window --action:resize --window:$notepadWin$ --width:800 --height:600
window --action:move --window:$notepadWin$ --x:100 --y:100
window --action:list --output:allWindows

window --action:open --path:"notepad.exe" --output:editor
window --action:attach --title:"*Invoice*" --path:"erp.exe" --output:erp
desktop --action:settext --window:$editor$ --by:classname --target:"Edit" --value:"Hello"

desktop Desktop

Windows UI Automation aracılığıyla masaüstü arayüz elementleriyle etkileşim kurar.

Tüm türlerde geçerli parametreler

ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--by zorunluşunlardan biri: automationid, name, classname, xpath, index
--target zorunlumetinTanımlayıcı değeri
--propertiesmetinYakalanan elementin nesne özellikleri. İşaretli her özellik eşleşmelidir; seçici bunlardan oluşturulur
--anchormetinYakında bulunan ve değişmeyen bir element, ör. name=Amount, automationid=lblTotal, classname=Static veya bir XPath; --target için birden çok eşleşme varsa ona en yakın olan kullanılır
--anchorpositionşunlardan biri: near, right, left, below, abovenearElementin çapaya göre konumu: o taraftaki en yakın eşleşme kullanılır
--fallbackmetinİlki hiçbir şey bulamadığında denenecek diğer seçiciler, " || " ile ayrılır. Özellikler tablosundaki alternatifler bunlardan sonra otomatik olarak denenir
--timeoutsayı30Saniye cinsinden zaman aşımı
--retrysayıYeniden deneme sayısı. Belirtilmezse ekran ve dosya komutları geçici bir sorundan (hâlâ yüklenen bir sayfa, örtülü bir öğe, kilitli bir dosya) sonra bir kez daha dener; 0 bunu kapatır
--retryintervalsayı1Yeniden denemeler arasındaki saniye

İşlemler (--action)

--action:click

Başka parametre yok.

--action:doubleclick

Başka parametre yok.

--action:rightclick

Başka parametre yok.

--action:clear

Başka parametre yok.

--action:check

Başka parametre yok.

--action:uncheck

Başka parametre yok.

--action:hover

Başka parametre yok.

--action:focus

Başka parametre yok.

--action:expandcollapse

Başka parametre yok.

--action:scrollto

Başka parametre yok.

--action:waitfor

Başka parametre yok.

--action:settext

Bir alanın metnini değiştirir (eski adı: type).

ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:appendtext

Bir alanda zaten bulunan metnin sonuna metin ekler.

ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:select
ParametreDeğerVarsayılanAçıklama
--value zorunlumetin
--action:getproperty

Elementin bir özelliğini, bir durumunu (enabled, checked, visible), seçili öğesini veya konumunu okur.

ParametreDeğerVarsayılanAçıklama
--property zorunlumetinElement özelliği
--output zorunludeğişken adıSonucu alan değişken
--action:setproperty
ParametreDeğerVarsayılanAçıklama
--property zorunlumetinYalnızca value ayarlanabilir
--value zorunlumetin
--action:exists
ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:getchildren
ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken

Örnekler

desktop --action:click --window:$notepadWin$ --by:automationid --target:"btnSave"
desktop --action:settext --window:$notepadWin$ --by:name --target:"Text Editor" --value:"Hello World"
desktop --action:getproperty --window:$notepadWin$ --by:automationid --target:"statusBar" --property:value --output:statusText
desktop --action:exists --window:$notepadWin$ --by:name --target:"Save" --output:saveExists

sendkeys Send keys

Bir pencereye metin ve özel tuşlar yazar. Özel tuşlar köşeli parantez içinde yazılır: [ENTER], [TAB], [CTRL+C].

Parametreler

ParametreDeğerVarsayılanAçıklama
--window zorunlu$değişken$window --action:open/attach ile alınan pencere veya bir set --type:window deseni
--keys zorunlutuşlarYazılacak metin; özel tuşlar köşeli parantez içinde, ör. Hello[ENTER] veya [CTRL+A]. Düz bir [ için [[ kullanın
--intervalsayı0Tuş vuruşları arasındaki milisaniye cinsinden gecikme
--activatetrue / falsetrueÖnce pencereyi öne getir

mouse Mouse

Fareyle piksel konumlarında tıklar, hareket ettirir, sürükler ve kaydırır: elementleri yakalanamayan programlar için (uzak masaüstleri, çizimler). Çalıştığı yerde Capture'ı tercih edin; düzen değiştiğinde konumlar bozulur.

Tüm türlerde geçerli parametreler

ParametreDeğerVarsayılanAçıklama
--window$değişken$Konumlar öne getirilen bu pencerenin sol üst köşesinden sayılır; boşsa ekranın köşesinden

İşlemler (--action)

--action:click
ParametreDeğerVarsayılanAçıklama
--xsayıSoldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın
--ysayıÜstten piksel
--action:doubleclick
ParametreDeğerVarsayılanAçıklama
--xsayıSoldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın
--ysayıÜstten piksel
--action:rightclick
ParametreDeğerVarsayılanAçıklama
--xsayıSoldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın
--ysayıÜstten piksel
--action:middleclick
ParametreDeğerVarsayılanAçıklama
--xsayıSoldan piksel; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın
--ysayıÜstten piksel
--action:move
ParametreDeğerVarsayılanAçıklama
--x zorunlusayıSoldan piksel. Pick: ekrandaki noktaya tıklayın
--y zorunlusayıÜstten piksel
--action:drag

Sol düğmeye x,y konumunda basar, tox,toy konumuna taşır ve bırakır.

ParametreDeğerVarsayılanAçıklama
--x zorunlusayıBasılacak yer. Pick: ekrandaki noktaya tıklayın
--y zorunlusayı
--tox zorunlusayıBırakılacak yer. Pick: ekrandaki noktaya tıklayın
--toy zorunlusayı
--action:scroll
ParametreDeğerVarsayılanAçıklama
--amount zorunlusayıTekerlek adımları: pozitif yukarı, negatif aşağı kaydırır
--xsayıBu konumun üzerinde kaydır; boşsa işaretçinin bulunduğu yer. Pick: ekrandaki noktaya tıklayın
--ysayı
--action:getposition

İşaretçinin konumu, X ve Y içeren bir kayıt olarak.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken

Örnekler

mouse --action:click --x:420 --y:310
mouse --action:doubleclick --window:$erp$ --x:120 --y:80
mouse --action:rightclick
mouse --action:drag --window:$erp$ --x:100 --y:200 --tox:400 --toy:200
mouse --action:scroll --amount:-3
mouse --action:move --x:10 --y:10
mouse --action:getposition --output:pos

screenshot Screenshot

Ekranın, bir pencerenin veya bunların bir alanının resmini kaydeder, ör. bir şeyler ters gittiğinde kanıt olarak.

Parametreler

ParametreDeğerVarsayılanAçıklama
--file zorunlumetinYazılacak resim: .png, .jpg veya .bmp Ajan makinesindeki bir dosya.
--window$değişken$Görüntüsü alınacak pencere (önce öne getirilir); boşsa tüm ekran. Mark area: ekranda bir dikdörtgen sürükleyin
--xsayı0Alan: pencereye (veya ekrana) göre sol kenar
--ysayı0Alan: pencereye (veya ekrana) göre üst kenar
--widthsayıAlan: piksel cinsinden genişlik (boşsa tüm pencere)
--heightsayıAlan: piksel cinsinden yükseklik (boşsa tüm pencere)
--outputdeğişken adıKaydedilen dosyanın yolunu alan değişken

Örnekler

screenshot --file:"C:\Shots\error-$orderNo$.png"
screenshot --file:"C:\Shots\erp.jpg" --window:$erp$ --x:0 --y:40 --width:800 --height:500 --output:saved

ocr OCR

Windows'un yerleşik OCR özelliğiyle ekrandan veya bir resimden metin okur: elementlerin yakalanamadığı uygulamalar ve taramalar için (terminaller, Citrix, görüntüler).

Tüm türlerde geçerli parametreler

ParametreDeğerVarsayılanAçıklama
--window$değişken$Okunacak pencere; boşsa tüm ekran (--file ile kullanılmaz). Mark area: ekranda bir dikdörtgen sürükleyin
--xsayı0Alan: pencereye (veya ekrana) göre sol kenar
--ysayı0Alan: pencereye (veya ekrana) göre üst kenar
--widthsayıAlan: piksel cinsinden genişlik (boşsa tüm pencere)
--heightsayıAlan: piksel cinsinden yükseklik (boşsa tüm pencere)
--filemetinEkran yerine bir resim dosyası (.png, .jpg, .bmp, .tif) oku Ajan makinesindeki bir dosya.
--languagemetinWindows'ta yüklü OCR dili, ör. tr, en, de; boşsa Windows görüntüleme dilleri

İşlemler (--action)

--action:read

Tüm metin, satırlar satır sonlarıyla ayrılmış olarak.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:readlines

Her satır konumuyla birlikte: Text, X, Y, Width, Height, CenterX, CenterY.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:find

Bir metnin konumu: Found ve konumu içeren bir kayıt (mouse --x:$pos.CenterX$ --y:$pos.CenterY$ ile tıklayın).

ParametreDeğerVarsayılanAçıklama
--text zorunlumetinAranacak metin (satırın bir parçası, büyük/küçük harf önemsiz)
--output zorunludeğişken adıSonucu alan değişken
--action:languages

Ajan makinesinde yüklü OCR dilleri.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken

Örnekler

ocr --action:read --window:$terminal$ --x:0 --y:60 --width:900 --height:400 --language:tr --output:screenText
ocr --action:readlines --window:$erp$ --output:lines
ocr --action:find --window:$erp$ --text:"Toplam" --output:pos
mouse --action:click --window:$erp$ --x:$pos.CenterX$ --y:$pos.CenterY$
ocr --action:read --file:"C:\Scans\invoice.png" --output:scanText
ocr --action:languages --output:installed

image Image

Ekranda bir resmi (bir düğme, bir simge, bir logo) bulur ve ona tıklar ya da nerede olduğunu söyler: öğeleri yakalanamayan ekranlar için (Citrix ve uzak masaüstleri, canvas uygulamaları, oyunlar).

Tüm türlerde geçerli parametreler

ParametreDeğerVarsayılanAçıklama
--image zorunlumetinAranacak resim: ekranda işaretleyin (Capture) veya ajan makinesindeki bir .png/.jpg/.bmp dosyası
--window$değişken$Yalnızca bu pencerede ara (önce öne getirilir); boşsa tüm ekran
--similaritysayı90Bir noktanın yüzde olarak ne kadar benzer olması gerektiği (50–100). Düşük değer biraz değişmiş resimleri de bulur (renkler, yumuşatma); yüksek değer benzerlerini önler
--timeoutsayıResim için beklenecek saniye (varsayılan 10; exists: 0, beklemez)

İşlemler (--action)

--action:find

Resmin nerede olduğu: Found, X, Y, Width, Height, CenterX, CenterY ve Similarity içeren bir record (zamanında görünmediyse Found false).

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:exists

Resim ekrandaysa true.

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:click
ParametreDeğerVarsayılanAçıklama
--offsetxsayı0Resim merkezinin sağındaki piksel (negatif: sol)
--offsetysayı0Resim merkezinin altındaki piksel (negatif: üst)
--action:doubleclick
ParametreDeğerVarsayılanAçıklama
--offsetxsayı0Resim merkezinin sağındaki piksel (negatif: sol)
--offsetysayı0Resim merkezinin altındaki piksel (negatif: üst)
--action:rightclick
ParametreDeğerVarsayılanAçıklama
--offsetxsayı0Resim merkezinin sağındaki piksel (negatif: sol)
--offsetysayı0Resim merkezinin altındaki piksel (negatif: üst)
--action:hover
ParametreDeğerVarsayılanAçıklama
--offsetxsayı0Resim merkezinin sağındaki piksel (negatif: sol)
--offsetysayı0Resim merkezinin altındaki piksel (negatif: üst)
--action:waitvanish

Resim ekrandan kaybolana kadar bekler (bir yükleniyor simgesi, bir "Please wait" bandı); --timeout sonrasında başarısız olur.

Başka parametre yok.

Örnekler

image --action:click --image:4f1d2c3b-aaaa-4bbb-8ccc-123456789abc --window:$citrix$ --offsetx:-10
image --action:find --image:"C:\Pictures\approve.png" --similarity:85 --timeout:20 --output:pos
image --action:waitvanish --image:<id> --timeout:60

clipboard Clipboard

Windows panosundaki metni okur ve yazar, ör. sendkeys [CTRL+C] sonrasında.

İşlemler (--action)

--action:settext
ParametreDeğerVarsayılanAçıklama
--text zorunluherhangi bir değer
--action:gettext

Panodaki metin (metin yoksa boş).

ParametreDeğerVarsayılanAçıklama
--output zorunludeğişken adıSonucu alan değişken
--action:clear

Başka parametre yok.

Örnekler

clipboard --action:settext --text:$orderNo$
clipboard --action:gettext --output:copied
clipboard --action:clear
Botream 0.1.1 · Oluşturulma 2026-10-14