CapThis allows you to give it an image, some text along with various other options and then it overlays that text onto the image, like a caption.

It runs with a HTTP interface, a server is started and image / text data is then sent to allow CapThis to process everything and output the final result.

This project is still in development and while it may work currently, there is still a lot of work to be done that will soon allow you to configure the way it works in a lot more detail.

Using an image of a sunset and a cartoon styled font CapThis generated this:

You will need:

• Git
• Go (versions 1.1 or 1.2)
• Make
• Imagick

Homebrew

$ brew install imagemagick

MacPorts

$ sudo port install ImageMagick

$ sudo apt-get install libmagickwand-dev

$ git clone https://github.com/GroundSix/capthis.git
$ cd capthis
$ make
$ sudo make install

You can start the server like so:

$ capthis

By default CapThis will run on port 8080. You can change this by specifying:

$ capthis 2020

At the moment CapThis by default runs on port 8080. Below are the post fields you must populate:

• image_name - The full path to the original image you need to process
• text - The text you are going to overlay the image with
• font - The full path to a ttf font file of your choice
• font_size - The font size (int) in pixels
• fill_color - The fill colour of your text (e.g. 'black')
• stroke_color - The stroke color of your text (e.g. 'black')
• output - The full path of the output (e.g. 'my_image.png')

An example request:

Headers

• URL: http://localhost:8080/
• Accept: /
• Accept-Encoding: gzip, deflate, compress
• Content-Length: 179
• Content-Type: application/x-www-form-urlencoded

Paramaters

• fill_color: black
• font: /path/to/my/font.ttf
• font_size: 32
• image_name: /path/to/my/image.png
• output: /path/to/output.png
• stroke_color: black
• text: Hello, World!

image_name=%2Fpath%2Fto%2Fmy%2Fimage.png&text=Hello%2C+World%21&fill_color=black&font_size=32&font=%2Fpath%2Fto%2Fmy%2Ffont.ttf&output=%2Fpath%2Fto%2Foutput.png&stroke_color=black

$ make test

MIT