Render a text into a pretty image. Originally meant for making sharable pictures of quotations.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
Test
README.md
situation.sh

README.md

situation.sh

SITUATION QUOTE CREATOR

Render a text into a pretty image.
Requires: imagemagick (=>7.0), ttf-linux-libertine (optional, for default fonts)

Usage

situation.sh "{QUOTE STRING}" [OPTION]

Options

QUOTE STRING    set text (see QUOTE STRING FORMAT) (mandatory)
-o FILE         set output file (default: '/tmp/situation.png')
-b NAME         set background color (default: 'black')
-bf FILE        set background image (overrides -b)
-s {X}x{Y}      set size of rendered image in pixels with a 4:3 aspect ratio 
                (e.g. 2000x1500) (default: '1000x750')
                NOTE: a size larger than 3000x2250 is not recommended
-fontq {PATH|NAME} 
-fonts {PATH|NAME}
                set font for quote and source with path to font file or name
                 (default: 'Linux-Biolinum-O', 'Linux-Biolinum-O-Italic')
-c COLOR
                set font color with hexadecimal code (e.g. "#FF00FF"), RGB
                 values (e.g. "rgb(255,0,123)") or ImageMagick color
                 (default: 'snow3')
                NOTE: always put quotes around this argument
-f              force overwrite of output file (default: no)
-h, --help      display this help
--open          open rendered image file via `xdg-open`
--list-fonts    show list of available fonts via `magick -list font`
--list-colors   show list of available colors via `magick -list color`

Quote string format

The text of a quote is parsed from a string formatted as follows:
    {quote}@{source}
Examples:
    "Désormais, la fête à proportion de l'ennui spectaculaire qui suinte de tous les pores des espaces du fétichisme de la marchandise est partout puisque la vraie joie y est absolument et universellement déficiente à mesure que progresse la crise permanente de la jouissance véridique.@Francis Cousin, L'Être contre l’Avoir"
    "La domination consciente de l’histoire par les hommes qui la font, voilà tout le projet révolutionnaire.@Internationale Situationniste, De la Misère en Milieu Étudiant (1966)"

Examples:

situation.sh "The Capital is really like, shit bruh, I swear!@Karlos Marakas to Fredo Engeles, in a bar" -bf my_bg.png -c \#FF00FF -fontq Gentium -fonts my_font.otf -s 2000x1500 -o quote.png -f

  • By the example above, from this picture: my_bg.jpg and this OTF font: direct link, we get: quote.png

situation.sh "La domination consciente de l’histoire par les hommes qui la font, voilà tout le projet révolutionnaire.@Internationale Situationniste, De la Misère en Milieu Étudiant (1966)"

  • The previous command, using default font, colors, and background image, gives us: situation-render.png

situation.sh "Le principe de la production marchande, c’est la perte de soi dans la création chaotique et inconsciente d’un monde qui échappe totalement à ses créateurs. Le noyau radicalement révolutionnaire de l’autogestion généralisée, c’est, au contraire, la direction consciente par tous de l’ensemble de la vie. [...] La tâche des Conseils Ouvriers ne sera donc pas l’autogestion du monde existant, mais sa transformation qualitative ininterrompue : le dépassement concret de la marchandise (en tant que gigantesque détour de la production de l’homme par lui-même).@Internationale Situationniste, De la Misère en Milieu Étudiant (1966)" -o longer.png -f

  • Same with a longer quote: longer.png