Request flags

By default, the following post-processing options modify the entire request.



An example of functional usage of request flags would look like this:

!req Taxi Driver [40:40] [45:00] –contrast 10 –aspect-quotient 1.1

General processing


Don’t crop the images.


Like –raw, but don’t draw quotes.


An indexed range of images that will be processed with the flags set. By default, every image is processed. The flag can contain a single index or a hyphen separated range (e.g. 1 or 1-2). The index start is 1.

Font processing


A custom font to use for every image (default: segoesm).

Available font values:

nfsans helvetica helvetica-italic clearsans clearsans-regular clearsans-italic opensans comicsans impact segoe segoe-italic segoesm papyrus bangers timesnewroman oldenglish segoe-bold-italic


Ensure that your joke is really funny when you request Comic Sans, Papyrus or Impact.


Kinobot will default to segoesm if you type a non-existent font value.


Most of the following descriptions were partially taken from the Pillow (PIL Fork) documentation.


A relative (to the image) float or integer value defining the font size (default: 27.0).


Acolor string; it can be a common html name (e.g. black, white, etc.) or a hexadecimal value (default: white).


An integer value defining the number of pixels between lines (default: 1.0).


The relative alignment of lines; it can be left, center or right (default: center).


An integer value defining the relative vertical offset of the text (default: 85).


An integer value defining the relative stroke width (font border size for technologically illiterate cinephiles) (default: 3).


Same as –font-color, but for the stroke (default: black).


Same as –font-color, but a background color for the text (default: None).


The font stroke will be removed if –text-background is set.

Image processing


A float value defining the aspect ratio’s quotient that will be applied for every image. By default, Kinobot will detect the “ideal” aspect ratio by amount of images (e.g. 1.6 for one image; 1.8 for two images).


This flag will raise InvalidRequest if the quotient is greater than 2.4 or lesser than 1.1.


An integer value defining -100 to 100 brightness to apply to all the images (default: 0)


An integer value defining -100 to 100 color to apply to all the images (default: 0)


An integer value defining -100 to 100 contrast to apply to all the images (default: 20)


An integer value defining -100 to 100 sharpness to apply to all the images (default: 0)

Collage processing


Don’t try to draw a collage, no matter the amount of frames (default: False)


–no-collage is highly discouraged as it is spammy; you might piss off people in the server with your experimental dumbassery. Use it only when you know what you are doing.


The dimensions of the collage that Kinobot should draw. By default, Kinobot will detect this automatically. You can choose between 1x2, 1x3, 2x1, 2x2, 1x4, 1x5, 2x3, 1x7 and 2x4.


These values should match the amount of frames produced (e.g 2x2 for 4 frames, 1x2 for 2 frames, etc).


A custom list of comma separated integer values defining the relative extra colored border values that will be applied to every image (default 0,0). Only works for collages.


Same as –font-color, but for borders (default: white).