https://github.com/coderofsalvation/bashwapp
Deadsimple desktop application skeleton using only bash,,http, nc and a webbrowser
https://github.com/coderofsalvation/bashwapp
Last synced: about 1 year ago
JSON representation
Deadsimple desktop application skeleton using only bash,,http, nc and a webbrowser
- Host: GitHub
- URL: https://github.com/coderofsalvation/bashwapp
- Owner: coderofsalvation
- License: agpl-3.0
- Created: 2013-11-10T16:35:02.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2020-05-28T18:18:13.000Z (about 6 years ago)
- Last Synced: 2025-02-12T06:22:57.935Z (over 1 year ago)
- Language: Shell
- Homepage:
- Size: 448 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
bashwapp
========
Deadsimple desktop application skeleton using only bash,nc and a webbrowser
### Why is this handy ###
Just use bash and html instead of fiddling with gui toolkits, textmode interfaces, c/c++.
Great for rapid prototyping or interfacing with commandline-stuff.
### Features ###
* quickndirty-easy-peasy lightweight httpserver
* direct html-interface to the shell
* bash (html) templates
* portable / no compilation
### How does it work ###
Well just run ./app and you'll see something like this:
$ git clone https://github.com/coderofsalvation/bashwapp.git
$ cd bashwapp
$ ./app
Connection from 127.0.0.1 port 8000 [tcp/*] accepted
Created new window in existing browser session.
[Sun Nov 10 17:32:01 CET 2013] out> HTTP/1.1 200 OK
[Sun Nov 10 17:32:01 CET 2013] out>
[Sun Nov 10 17:40:46 CET 2013] in> GET /
[Sun Nov 10 17:40:46 CET 2013] out> HTTP/1.1 200 OK
[Sun Nov 10 17:40:46 CET 2013] out>
See? It started a miniwebserver, and if you'll see the image below if you surf to http://localhost:8000:
### Tips ###
The `app`-bashscript looks for a folder `html`. To get simple web<->bashscript interfacing going on (getargs/forms) run `rm html; cp -R html.skeleton html`.
### Dependancies ###
There are little dependancies, best is to have a linux system, because then the following is already installed in most cases:
* a linux system bash
* nc
* browser
In theory this could also work on windows using cygwin or a standalone bash-binary.
### Limitations ###
Well ofcoarse security..only use this for quick prototyping or personal use.
Singlepage application are adviced since inclusion of external files is unpredictable with netcat. Netcat (nc) runs in a bash while-loop which
causes small breaks in listening to the socket. Therefore, when a browser rapidly fires parallel requests, it'll probably not serve all files well.
### Applications made with bashwapp ###
* [Sample Multishotifier](https://github.com/coderofsalvation/sample-multi-shotifier)
### Credits ###
* bootstrap template from startbootstrap.com