Skip to content

rotten77/sekubu

Repository files navigation

Sekubu

Sekubu is a simple GUI command and/or script runner.

How it works

  1. Edit the config file sekubu.xml and define your commands or scripts (the example config file will be generated after the first run). See the config description below.
  2. Run the application. It's just a simple window containing buttons and other elements that you have defined in the config file.
  3. Click the button to run the command.
  4. Your command was executed!

How Sekubu works

Configuration sekubu.xml

You can add these elements:

Button is the foundation of Sekubu. You have to set the command that will be run and the label of the button as well.

<button label="Click me!">run_this_app.exe</button>
  • Attributes:

    • label
    • new_console [default: True]: runs the command in a new window (subprocess.CREATE_NEW_CONSOLE) or in the background (subprocess.CREATE_NO_WINDOW)
    • show_output [default: 'never']: shows stdout in a modal dialog if new_console=false, possible options are:
      • never
      • always
      • if_not_empty

Text can be used as a section separator or for some fancy notes.

<text>Some fancy text note</text>

The separator is just a horizontal line. It can be useful in case of a big amount of buttons.

<separator/>

You can set a light or dark theme in the root element <sekubu>. Don't worry about width and height, you can resize the window with the mouse and the size will be saved.

<sekubu theme="dark" width="264" height="303">

Examples

You can run any app the same way as within the Windows Run:

<button label="Calculator">calc.exe</button>

Executing PowerShell script with -NoExit tag so the window will not close after the script finishes:

<button label="My script">powershell.exe -NoExit "./my_script.ps1"</button>

It's also possible to just run commands right from the app (ipconfig /all in this case):

<button label="ipconfig">powershell.exe -NoExit -Command "ipconfig /all"</button>

Run the command in the background and show stdout after it's executed:

<button label="Hello World!" new_console="false" show_output="if_not_empty">powershell.exe -Command "Write-Host 'Hello World!'"</button>

Run a Python script:

<button label="Python script">powershell "C:\...\python.exe .\my_python_script.py"</button>

Run a script using Windows Terminal:

<button label="Windows Terminal">wt powershell.exe "./my_script.ps1"</button>

Run a script inside a defined location/folder:

<button label="My script">powershell "Set-Location C:\my_folder\; ./my_script.cmd"</button>

Open a desired local folder in Windows Explorer:

<button label="Open C:\my_folder">explorer "C:\my_folder"</button>

Open a desired network folder in Windows Explorer:

<button label="Open C:\my_folder">explorer "\\\\network_path\\folder"</button>

Changelog

1.1.4

  • A command can be executed in the background using the new attribute new_console.

1.0

  • The first version of Sekubu.