OpsApi is operation automation tool by CLI and REST API. not need environment set up, one binary solution! for Windows and Linux.

when you must boring web task(ex meny registration made of checkbox!), or input for monthly bussiness imfomation.
you should many input by human operation. and your team mate same. usual solution are

• install RPA. and make flow.
• python, ansible, such program language. make operation into code.
• implemented OS Scripts.

and then, you distribute your way to teammate.

in my opinion, there are must prepare enviroment, and flexible customize difficulty. moreover must login your OS.
and Above all, keyboard input can't emulate,and capture operation result easily (you need it, you implement by append code).
Is it easy way?
do you want operation share casually? or your absolute trust teammate controlled instead of you? OpsApi solv it, easily.

• keyboard input emulation (same to hardware input)
• automatic capture to picture and can create animetion gif
• implemented by golang, one binary file.
• support HTTPS
• support multi os (Windows or Linux)

git clone https://github.com/yasutakatou/opsapi
cd opsapi
go build .

or download binary from release page.
save binary file, copy to entryed execute path directory.

delete that binary. del or rm command. (it's simple!)

important!
in advance, you must decide operations to what do.
(send text to your application. emulate your keystroke on your web browser. such more)
if you don't know, cli mode help you. you can test operation on cli. or liveRecord mode make your operation into code in auto.
cli mode can use like linux shell. tab interpolation, upper key is history one before, etc.

this tool run example in local. token is test. execute command on our OS for get file lists.

$ opsapi -token=test 

Linux example:

curl -k -H "Content-type: application/json" -X POST http://127.0.0.1:8080/ -d '{"token":"test","command":"exec","params":"ls -la"}'

Windows example:

curl -k -H "Content-type: application/json" -X POST http://127.0.0.1:8080/ -d "{\"token\":\"test\",\"command\":\"exec\",\"params\":\"dir\"}"

if tool run in another server(192.168.0.1) with https. token is customized and more changed port number.

# opsapi -https -port=18080 -token=custompassword

Linux example:

curl -k -H "Content-type: application/json" -X POST https://192.168.0.1:18080/ -d '{"token":"custompassword","command":"exec","params":"ls -la"}'

Windows example:

curl -k -H "Content-type: application/json" -X POST https://192.168.0.1:18080/ -d "{\"token\":\"custompassword\",\"command\":\"exec\",\"params\":\"dir\"}"

note: two api not use json. use form format.

in case of you upload text.txt to target server, follow. name is file name of upload file into target server, file is data to be uploaded file.

Windows example:

curl -F token=test -F name=test.txt -F [email protected]  http://127.0.0.1:8080/upload

note: you must spec "@" ago file name.

in case of you download text.txt, follow. name is file name of download file from target server, after -o is file name into download data.

Windows example:

curl -F token=test -F name=test.txt http://127.0.0.1:8080/download -o test.txt

opsapi -h : display help 

note: if you want to use https, you prepare cert file beforehand. (use mkcert and such more)

functions is almost supported Windows and Linux. but, "liveRecord" "AnimetionGIF" and "titles" are only do Windows.

view current config. argument isn't need.

config value change. you can set value one by one. format is left(option name)=right(value). each value detail are "config" reference.

keyboard emulation. argument is input strings by keyboard.

note: in what Windows, keyboard emulate on target window. in what Linux, keyboard emulate on terminal console (/dev/ttyX such). therefore, must permted permisson to /dev/ttyX.

example) [ops test] (keyboard emulaton to your terminal. input "test")
note: when running cli mode. and when your inputs aren't functions. your inputs are treat to "ops".

special define.

and can use integer among LiveRawcodeChar value to ascii code emulate. example [\\~38~; \\~38~]
in case of LiveRawcodeChar value is "~"(default).input are double "↑".

note: by what "SeparateChar" define, strings can input Continuously.
example [hoge; \n ; wait10; fuga] -> input are "hoge" , newline , (10 second waits), "fuga"
waitXX is embedded sleep function. program waits xx integer second.

execute os command. argument is os command.

capture from target. argument is os file name. but, must exclude extension.
if omit argument, filename is current year-month-days-hour-minits. example: now 2020/03/01 22:08 -> 2020-03-01-22-08
note: in case of Windows capturing is picture. (PNG format) in case of Linux capturing is text. (/dev/vcs device export)

view running window title and handle id.
example) "Google - Google Chrome : 4080c",
window title: "Google - Google Chrome" handle id: "4080c"

1st time: starting capture. 2nd time: capturing stop, and create file.
argument is os file name. but, must exclude extension.
note: if you capture long time, your pc maybe memory depletion.
if omit argument, filename is current year-month-days-hour-minits. example: now 2020/03/01 22:08 -> 2020-03-01-22-08.

history is cleared

delete history one or more. argumet is single integer or use "-" range integer value.
example)

[  1] Command:        ops Params: test
[  2] Command:        ops Params: \n
[  3] Command:        ops Params: input

if you want delete "\n", you input [deleteHistory 2]
if you want delete "test" and "\n", you input [deleteHistory 1-2]

view current history for cli. argument isn't need.

export current history. argument is two type.
1st: export format. 2nd: file name. (two arguments can omit.)
export format are "tsv" and "shell". if you set "tsv", your history export to tab spread value format.
if you set "shell", your history export to custom format. "ExportFormat" in cli option can set custom format.
if omit file name argument, filename is current year-month-days-hour-minits.
also export format is tsv by default. example: now 2020/03/01 22:08 -> 2020-03-01-22-08.

example)
in case of export format is "tsv", and file name is "test.txt". you set [exportHistory tsv test.txt].

import of exported history file before. argument is filename. also, file format must be "tsv".
note: when you run now history is all delete.

insert one by one history into now historys. argument is three type.
1st: insert place 2nd: api name 3rd: api value. (three arguments can't omit every.)

example)

[  1] Command:        ops Params: test
[  2] Command:        ops Params: \n
[  3] Command:        ops Params: input

if you want insert tab input before "\n", you input [insertHistory 2 \t]

when by keyboard operating to target window, operation convert to and add history.
note: until what you press ascii code "LiveExitAsciiCode" of cli config, program record your operation. (default is 27[Esc].)

operation replay along now history. note: when "runHistory" running, not add history.

note: if space string include, refer following.

>>> configSet Shebang="## space string include example ##"

if you run "ops", keyboard emulation do to application of this value. you can set title of window, or id of handle.
note: value can get by "titles" function. also, value can set partially included. if not found value, return error.

example) "Google - Google Chrome : 4080c",
window title: "Google - Google Chrome" handle id: "4080c"
if you want to set target this, you input [configSet Target=Chrome] or [configSet Target=4080c].

this option, capture target window after "ops" every. detail wrote in "capture" function above.
*note: filename is current year-month-days-hour-minits fixed. example: now 2020/03/01 22:08 -> 2020-03-01-22-08. *
if you want to set true this, you input [configSet AutoCapture=true].

can set save path, when you use capturing function.

when use "ops" function, use this value strings can input Continuously.
example [hoge; \n ; wait10; fuga]
input are "hoge" , newline , (10 second waits), "fuga"

when use "ops" function, can input ascii code among this value.
about ascii code, please refer this site.
example [\\~38~; \\~38~]
input are double "↑".

when "AutoCapture" is true, wait this value after capture. program waits xx integer milli second.

capturing interval. The smaller, the larger the file size.

gif animation play delay time. The smaller, the fastest the playing.

"liveRecord" function wait this value ascii code for recording exit.
about ascii code, please refer this site.

if you use Shebang, set this value.
example) Shebang=#!/bin/bash

when you export history by shell formatted, convert along this value.

example: Command: -> #COMMAND#, Params: #PARAMS# replace. displayHistory

[  1] Command:        ops Params: test

to exportHistory

curl -H "Content-type: application/json" -X POST http://127.0.0.1:8080/ -d "{\"token\":\"%1\",\"command\":\"ops\",\"params\":\"test\"}"

if this value is true, record history every inputs. if you want to set true this, you input [configSet Record=true].

"runHistory" function wait this value every do. program waits xx integer milli second.

if more request, I consider to implementation.

• animetion gif is split save, and finally merge to one file.

therefore, can more record at long time. I don't know how, append gif data after once save on golang.
not impossible to use external command (FFmpeg such more), but I don't like.
(you must prepare external command, not one binary environment.)

• see to real time operating screen from remote client (such use websocket).

if you do that, I suggest to use RDP, VNC.