Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ahungry/puny-gui
A Puny GUI System
https://github.com/ahungry/puny-gui
Last synced: 3 months ago
JSON representation
A Puny GUI System
- Host: GitHub
- URL: https://github.com/ahungry/puny-gui
- Owner: ahungry
- License: gpl-3.0
- Created: 2020-04-24T02:52:59.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2020-06-28T04:38:41.000Z (over 4 years ago)
- Last Synced: 2024-08-01T00:37:34.713Z (6 months ago)
- Language: C
- Size: 1 MB
- Stars: 105
- Watchers: 6
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-janet - Puny GUI - built (Random / Server)
README
# Puny GUI
This is a small cross-platform (native) GUI setup (GNU/Linux + Windows).
To start creating GUIs requires NO compilation, installation, or large
downloads (entire bin/exe setup is less than 5 MB).
You can see the complete source for a GUI to fetch a random dog
picture on a single screen (with said resultant app):
Everything you need to get started can be found on the releases tab
here:
https://github.com/ahungry/puny-gui/releases
Simply download the appropriate release bundles and start modifying
the app.janet and/or other .janet files to adjust the basic template
to fit your needs.
For iterative development, you can run 'super-repl' instead of 'app'.
The kit supports the following, thanks to the underlying software being
bundled with it (via dll for Windows or dynamic linking for GNU/Linux):
- Script Language (via https://janet-lang.org)
- Native GUI (via IUP http://webserver2.tecgraf.puc-rio.br/iup/en/)
- Web Client (via cURL https://curl.haxx.se/)
- Web Server (via Mongoose https://github.com/cesanta/mongoose)
- Persistence (via sqlite https://sqlite.org/index.html)
- JSON (via https://github.com/janet-lang/json)
To follow along with a step by step process, use the blog/tutorial
here:
https://ahungry.com/blog/2020-04-24-Puny-GUI-Puppy-Finder.html
# Installation
None - just download, inflate, and start hacking a new app together
for some users to enjoy.
Due to the shared linking, you/your users *will* need to ensure you
have the appropriate shared libs/packages installed on your host *nix
system, as such:
- gtk+-3
- curl
- sqlite
For very lazy Ubuntu users, they can simply run the included
'./ubuntu-packages.sh' script.
# Building
See Makefile for GNU/Linux and Wakefile for Windows (I built the
release things for Windows using mingw64).
Running 'make' depends on having a nested Janet source code in the
build directory.
The nested Janet source code depends upon having IUP files in the
build directory.
Building anything at all requires the necessary build files.
If you want a widely distributable GNU/Linux build, you may want to
copy me and do so in an Ubuntu 18.04 docker image, by using the
attached dockerfile with the following make commands:
```sh
make docker-build docker-run docker-get
```
This will pull a produced tarball out of the docker image and into
your root repository directory.
If you like doing things manually, ensure you have done the following
in this order:
```sh
./ubuntu-build-packages.sh # For Ubuntu users only!
./get-iup-linux-files.sh # Will download IUP GNU/Linux files
./get-janet.sh # Will download + build a custom Janet runtime
make -Bj # Will force build app.bin + super-repl.bin
```
Now enjoy your custom build.
# License
All linked/included works that are not my own are subject to their
original licenses (the majority are MIT, Mongoose is GPLv2).
You can find the original sources on the associated links above.
All original works are copyright Matthew Carter and
licensed under GPLv3.
If you make a derivative work, you need to adhere to the license here
(as well as those in the dependencies, which may be GPLv2 in the case
of the mongoose/circlet stuff).