Skip to content

matyalatte/tuw

Repository files navigation

Simple-Command-Runner ver 0.4.0

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)

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.

FAQ

Frequently Asked Questions

Platforms

Simple Command Runner uses cross-platform framework.
I made sure I can build it with the following platforms and compilers.

  • Windows10 + MSVC 19.31
  • MacOS 11 + AppleClang 13.0
  • Ubuntu 20.04 + GCC 9.4
  • Alpine Linux 3.16 + GCC 11.2

And it should support your platform as well if wxWidgets library supports.

Building

CMake

There are platform-specific documents for building the executable with CMake.

You can also see batch files, shell scripts, and CMakePresets.json to understand the workflow.

Docker

Linux users can use dockerfiles to build the executable.
See the dockerfiles for the details.

Github Actions

There are some building workflows for Github Actions.
You can make Github build and upload the executable for your platform.

See here for the details.
How to Build With Github Actions

License

Files in this repository are available under the GPL2+.

External Projects

Project Used for License
wxWidgets library GUI framework Modified LGPL
nlohmann's json library JSON handling MIT
UPX EXE compression Modified GPL2+