Skip to content

matyalatte/tuw

Repository files navigation

Simple Command Runner ver 0.4.1

build test Codacy Badge Buy Me A Coffee

Small and simple GUI wrapper for command-line tools.

Only 1MB for a portable GUI!

Simple Command Runner will give a very simple GUI to your scripts.
All you need is write a .json file and run a small executable.
It can make a GUI to run commands of your scripts.
No need coding, no need browsers, and no need stupidly large executables!

sample

Features

  • Define GUI in .json
  • Save arguments
  • Input paths by drag and drop
  • Cross-platform
  • Native look and feel
  • Portable
  • Small size (under 1MB)
  • UTF-8 support

Downloads

You can download executables from the release page

  • SimpleCommandRunner*-Windows*.zip is for Windows.
  • SimpleCommandRunner*-macOS*.tar.bz2 is for macOS.
  • SimpleCommandRunner*-Linux*.tar.bz2 is for Ubuntu (20.04 or later).

*-packed.* are the 1MB executables that were compressed by UPX.
But they might cause some problems (e.g. false positives by anti-viruses) on your machine.
Use the uncompressed ones if they won't work.

The linux builds only support Ubuntu due to the glibc dependences.
Build the executable by yourself if you want to use it on other linux distros.

Examples

There are some json files to learn how to define GUIs.

JSON Schema

There is a schema for gui_definition.json.
You can use it to validate definitions while editing files.

VSCode

For VSCode, you can add the schema path to settings.json (File > Preferences > Settings > JSON:Schemas > Edit in settings.json.)

"json.schemas": [    
    {
        "fileMatch": [ "gui_definition.json" ],
        "url": "https://raw.githubusercontent.com/matyalatte/Simple-Command-Runner/main/schema/schema.json"
    }
]

react-jsonschema-form

You can also make gui_definition.json with web forms

FAQ

Frequently Asked Questions

Building

Building Executables

License

Files in this repository are available under the GPL2+.

External Projects

Project Used for License
wxWidgets library GUI framework Modified LGPL
RapidJSON JSON handling MIT
UPX EXE compression Modified GPL2+