diff options
| -rw-r--r-- | Makefile | 2 | ||||
| -rw-r--r-- | README.md | 61 | ||||
| -rw-r--r-- | cqrlogo.png | bin | 0 -> 509 bytes |
3 files changed, 61 insertions, 2 deletions
@@ -116,4 +116,4 @@ check: $(GREP) -e '^This QR Code has been stolen from https://eworm.net/!$$' clean: - $(RM) -f *.o *~ cqrlogo + $(RM) -f *.o *~ check.png cqrlogo @@ -1,4 +1,63 @@ cqrlogo ======= -CGI QR-Code logo +**CGI QR-Code logo** + +The resulting QR-Code should look something like this: + + + +It is generated dynamically from referer URL sent by the user agent. + +Requirments +----------- + +To compile and run `cqrlogo` you need: + +* [libpng](http://www.libpng.org/pub/png/libpng.html) +* [zlib](http://www.zlib.net/) (which is a dependency for libpng) +* [qrencode](http://megaui.net/fukuchi/works/qrencode/index.en.html) + +Additionally it is expected to have `make` and `pkg-config` around to +successfully compile. + +Some systems may require additional development packages for the libraries. +Look for `libpng-dev`, `libz-dev` and `libqrencode-dev` or similar. + +For `make check` to work you have to install optional dependency +[zbar](http://zbar.sourceforge.net/). + +Build and install +----------------- + +Building and installing is very easy. Just run: + +> make + +followed by: + +> make install + +This will place an executable at `/usr/share/webapps/cqrlogo/cqrlogo`. + +The file `config.h` (copy from `config.def.h` if it does not exist) provides +some build time configuration, so feel free to make your changes there and +rerun the commands above. + +Usage +----- + +This is a **CGI executable** (*Common Gateway interface*), so it is expected +to be run inside a web server. Consult your web server's documentation +to get information about how to run CGI executables. + +By default `cqrlogo` generates a file with scale two, so one QR-Code pixel +results in 2x2 pixels. The border is one pixel (though scale takes effect) +and error correction level is the lowest available. + +Runtime options can be given with request method GET. These are available: + +* `scale`: scale the QR-Code up by this factor +* `border`: width of the border +* `level`: error correction level + diff --git a/cqrlogo.png b/cqrlogo.png Binary files differnew file mode 100644 index 0000000..964f749 --- /dev/null +++ b/cqrlogo.png |
