NAME¶

tuxpaint -- "Tux Paint", a drawing program for young children.

SYNOPSYS¶

tuxpaint [--help --version --verbose-version --usage --copying]

tuxpaint

[--fullscreen {yes|native|no}]
[--allowscreensaver]
[--WIDTHxHEIGHT]
[--native]
[--orient=portrait]
[--buttonsize SIZE | --buttonsize auto]
[--startblank]
[--nosound]
[--nostereo]
[--noquit]
[--noprint]
[--printdelay=SECONDS]
[--printcfg]
[--altprintalways | --altprintnever]
[--papersize PAPERSIZE | --papersize help]
[--printcommand COMMAND]
[--altprintcommand COMMAND]
[--simpleshapes]
[--uppercase]
[--grab]
[--noshortcuts]
[--nowheelmouse]
[--nobuttondistinction]
[--nofancycursors]
[--hidecursor]
[--nooutlines]
[--nostamps]
[--nostampcontrols]
[--nostamprotation]
[--nomagiccontrols]
[--nomagicsizes]
[--ungroupmagictools]
[--noshapecontrols]
[--nolabel]
[--nobrushspacing]
[--complexity=beginner | --complexity=novice]
[--notemplateexport]
[--newcolorslast]
[--mirrorstamps]
[--colorsrows=ROWS]
[--mouse-accessibility]
[--onscreen-keyboard]
[--onscreen-keyboard-layout LAYOUT]
[--onscreen-keyboard-disable-change]
[--joystick-dev=DEVICE]
[--joystick-dev=list]
[--joystick-slowness=SPEED]
[--joystick-threshold=THRESHOLD]
[--joystick-maxsteps=STEPS]
[--joystick-hat-timeout=MILLISECONDS]
[--joystick-hat-slowness=SPEED]
[--joystick-btn-escape=BUTTON]
[--joystick-btn-brush=BUTTON]
[--joystick-btn-stamp=BUTTON]
[--joystick-btn-lines=BUTTON]
[--joystick-btn-shapes=BUTTON]
[--joystick-btn-text=BUTTON]
[--joystick-btn-label=BUTTON]
[--joystick-btn-magic=BUTTON]
[--joystick-btn-undo=BUTTON]
[--joystick-btn-redo=BUTTON]
[--joystick-btn-eraser=BUTTON]
[--joystick-btn-new=BUTTON]
[--joystick-btn-open=BUTTON]
[--joystick-btn-save=BUTTON]
[--joystick-btn-pgsetup=BUTTON]
[--joystick-btn-print=BUTTON]
[--joystick-buttons-ignore=BUTTON1,BUTTON2,...]
[--stampsize=SIZE]
[--keyboard]
[--nosysfonts]
[--alllocalefonts]
[--uifont FONT NAME]
[--savedir DIR]
[--exportdir DIR]
[--datadir DIR]
[--saveover]
[--saveovernew]
[--nosave]
[--noerase]
[--autosave]
[--reversesort]
[--colorfile FILE]

tuxpaint (defaults)

[--windowed]
[--disablescreensaver]
[--800x600]
[--orient=landscape]
[--buttonsize 48]
[--startlast]
[--sound]
[--stereo]
[--quit]
[--print]
[--printdelay=0]
[--noprintcfg]
[--altprintmod]
[--complexshapes]
[--mixedcase]
[--dontgrab]
[--shortcuts]
[--wheelmouse]
[--buttondistinction]
[--fancycursors]
[--showcursor]
[--outlines]
[--stamps]
[--stampcontrols]
[--stamprotation]
[--magiccontrols]
[--magicsizes]
[--groupmagictools]
[--shapecontrols]
[--label]
[--brushspacing]
[--complexity=advanced]
[--templateexport]
[--newcolorsfirst]
[--dontmirrorstamps]
[--stampsize=default]
[--mouse]
[--sysfonts]
[--currentlocalefont]
[--uifont=default]
[--saveoverask]
[--save]
[--erase]
[--noautosave]
[--noreversesort]

tuxpaint

[--locale LOCALE]

tuxpaint

[--lang LANGUAGE | --lang help]

tuxpaint

[--nosysconfig]
[--nolockfile]

DESCRIPTION¶

Tux Paint is a drawing program for young children. It is meant to be easy and fun to use. It provides a simple interface and fixed canvas size, and provides access to previous images using a thumbnail browser (i.e., no access to the underlying filesystem).

Unlike popular drawing programs like "The GIMP," it has a very limited toolset. However, it provides a much simpler interface, and has entertaining, child-oriented additions such as sound effects.

OPTIONS - INFORMATIONAL¶

tuxpaint accepts the following options to emit information about the program. It then exits immediately (without opening a graphical window).

--help

Display short, helpful information about Tux Paint.

--version

Output the version info.

--verbose-version

Output the version info and compile-time build options.

--usage

Display a list of all commandline options.

--copying

Show the license (GNU GPL) under which Tux Paint is released.

--listfonts

Display a list of fonts found by Pango (and so available to Tux Paint via --uifont).

OPTIONS - INTERFACE¶

tuxpaint accepts the following options to alter the interface. They can be used along with, instead of, or to override options set in configuration files. (See below.)

OPTIONS - CONTROLLING TUX PAINT¶

tuxpaint accepts the following options to alter how you control Tux Paint. They can be used along with, instead of, or to override options set in configuration files. (See below.)

OPTIONS - PRINTING¶

tuxpaint accepts the following options to alter how Tux Paint handles printing. They can be used along with, instead of, or to override options set in configuration files. (See below.)

OPTIONS - SAVING¶

tuxpaint accepts the following options to alter how Tux Paint operates when saving or exporting drawings. They can be used along with, instead of, or to override options set in configuration files. (See below.)

OPTIONS - DATA FILES¶

tuxpaint accepts the following options to alter where Tux Paint loads data (stamps, brushes, etc.) They can be used along with, instead of, or to override options set in configuration files. (See below.)

--datadir DIR

Specify where Tux Paint should look for personal data files (brushes, stamps, etc.).

--colorfile FILE

This option allows you to override the default color palette in Tux Paint and replace it with your own. The file should be a plain ASCII text file containing one color description per line. Colors may be in decimal or 6- or 3-digit hexadecimal, and followed by a description. (For example, "#000 Black" and "255 192 64 Orange".)

OPTIONS - LANGUAGE¶

tuxpaint accepts the following options to alter the language used by Tux Paint's interface, and other related settings. They can be used along with, instead of, or to override options set in configuration files. (See below.)

Various parts of Tux Paint have been translated into numerous languages. Tux Paint will try its best to honor your locale setting (i.e., the "LANG" environment variable), if possible. You can also specifically set the language using options on the command-line or in a configuration file.

--locale LOCALE

Specify the language to use, based on locale name (which is typically of the form "language[_territory][.codeset][@modifier], where "language" is an ISO 639 language code, "territory" is an ISO 3166 country code, and "codeset" is a character set or encoding identifier like "ISO-8859-1" or "UTF-8".)

--lang LANGUAGE

Specify the language to use, based on the language's name (as recognized by Tux Paint). Choose one of the language names listed below:

--lang help

Display a lists of all supported languages.

--mirrorstamps --dontmirrorstamps

With "--mirrorstamps" set, stamps which can be mirrored will appear mirrored by default. This can be useful when used by people who prefer things right-to-left over left-to-right.

OPTIONS - MISCELLANEOUS¶

tuxpaint accepts the following options to alter its behavior. They can be used along with, instead of, or to override options set in configuration files. (See below.)

--nosysconfig

With this option, Tux Paint will not attempt to read the system-wide configuration file (typically "/etc/tuxpaint/tuxpaint.conf" or "/usr/local/etc/tuxpaint/tuxpaint.conf").

--nolockfile

By default, Tux Paint uses a lockfile (stored in the user's local Tux Paint directory) which prevents it from being launched more than once in 30 seconds. (Sometimes children get too eager, or user interfaces only require one click, but users think they need to double-click.) This option makes Tux Paint ignore the current lockfile.

ENVIRONMENT¶

While Tux Paint may refer to a number of environment variables indirectly (e.g., via SDL(3)), it directly accesses the following: (See "FILES" below, as well.)

HOME

to determine where picture files go when using the Save and Open commands within Tux Paint, to keep track of the current image, when quitting and restarting Tux Paint, and to get the user's configuration file.

LANG, LC_ALL, LANGUAGE, and LC_MESSAGES

to determine language to use, if setlocale(3) refers to "LC_MESSAGES".

SDL_VIDEO_ALLOW_SCREENSAVER

Set this environment variable to '1' to allow a screensaver to appear while Tux Paint is running. This can also be done via the "--allowscreensaver" option.

SDL_VIDEO_WINDOW_POS

If this is NOT set, Tux Paint will set it to "center", to attempt to place the Tux Paint window in the center of a display. If it IS set (e.g., to "nopref", meaning "no preference"), Tux Paint will not override it.

FILES¶

[/usr/local/]/etc/tuxpaint/tuxpaint.conf

System-wide configuration file. It is read first (unless the "--nosysconfig" option was given on the command-line).

$HOME/.tuxpaintrc

User's configuration file. It can be used to set default options (rather than setting them on the command-line every time), and/or to override any settings in the system-wide configuration file.

$HOME/.tuxpaint/saved/

A directory of previously-saved images (and thumbnails). Only files in this directory will be made available using the Open command within Tux Paint. Overridden via the "--savedir" option.

$HOME/.tuxpaint/current_id.txt

A reference to the image which was being edited when Tux Paint was last quit. (This image is automatically loaded the next time Tux Paint is re-run, unless the "--startblank" option is set.)

$HOME/.tuxpaint/lockfile.dat

A lockfile that prevents Tux Paint from being launched more than once every 30 seconds. Disable checking the lockfile by using the "--nolockfile" option.

$XDG_CONFIG_HOME[XDG_PICTURES_DIR]/TuxPaint/

A directory where images and animations should be exported (via options found in Tux Paint's Open dialog), if the "--exportdir" option is not used to override it. If "$XDG_CONFIG_HOME" is set, a configuration file "user-dirs.dirs" will be scanned within the directory it points to; if not, Tux Paint will attempt to do so within "$HOME/.config/". If a setting named "XDG_PICTURES_DIR" is found, it will be used as the location to export images. If all else fails, then "$HOME/Pictures/" will be used. A "TuxPaint" subdirectory will be created.

$XDG_DATA_HOME/Trash/ or $HOME/.local/share/Trash/

A directory where images are placed when the Erase option is used from the Open dialog.

COPYRIGHT¶

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

OTHER INFO¶

See the documentation that comes with Tux Paint for further instructions on using the program's features.

The canonical place to find Tux Paint information is at https://tuxpaint.org/.

AUTHORS¶

Lead developer and project manager: Bill Kendrick <bill@newbreedsoftware.com>.

With patches, fixes, extensions, porting, translations, documentation, and more from lots of people, including, but probably not limited to (see AUTHORS.txt and CHANGES.txt):

Aki, Ashish Arora, A S Alam, Khalid Al Holan, Daniel Andersson, Hodorog Andrei, Joana Portia Antwi-Danso, Adorilson Bezerra de Araujo, Xandru Armesto, Ben Armstrong, Ravishankar Ayyakkannu,

Dwayne Bailey, Matías Bellone, Martin Benjamin, Besnik Bleta, Denis Bodor, Rahul Borade, Yacine Bouklif, Miguel Anxo Bouzada, René Brandenburger, Herman Bruyninckx, Lucie Burianova, Laurentiu Buzdugan,

Albert Cahalan, Pere Pujal i Carabantes, Hugo Carvalho, Felipe Castro, Ouychai Chaita, Zdenek Chalupský, Wei-Lun Chao, Jacques Chion, Ankit Choudary, Yuri Chornoivan, Abdoul Cisse, Urska Colner, Adam 'akanewbie' Corcoran, Helder Correia, Ricardo Cruz,

Magnus Dahl, Laurent Dhima, Chandrakant Dhutadmal, Yavor Doganov, Joe Dalton, Tim Dickson, Dawa Dolma, Kevin Donnelly, Dovix, Korvigellou An Drouizig (Philippe), Serhij Dubyk,

Ander Elortondo, Alberto Escudero-Pascual,

T. Surya Fajri, Jamil Farzana, Fasokan, Sveinn í Felli, Emanuel Feruzi, Doruk Fisek, Flavia Floris, Fòram na Gàidhlig, Fabian Franz, Derrick Frimpong, Martin Fuhrer, Fula Localization Project,

Alexander Gabillondo, Török Gábor, Gabriel Gazzan, Robert Buj Gelonch, Olesya Gerasimenko, Alexander Geroimenko, Torsten Giebl, Harvey Ginter, Solomon Gizaw, Robert Glowczynski, Chris Goerner, Mikel González, Volker Grabsch, The Greek Linux i18n Team, Edmund GRIMLEY EVANS, Frederico Goncalves Guimaraes,

HackerGene, Joe Hanson, Sam "Criswell" Hart, Guy Hed, Farinaz Hedayat, Prasanta Hembram, Willem Heppe, Tedi Heriyanto, Pjetur G. Hjaltason, Knut Erik Hollund, Henrik Holst, Khaled Hosny, Henry House, Mohomodou Houssouba, Song Huang, Karl Ove Hufthammer,

Roland Illig, Daniel Illingworth, Indigenas Sin Fronteras, Juan Irigoien, Students of Vocational Higher Secondary School Irimpanam, Itai, Dmitriy Ivanov,

Mogens Jaeger, Lis Gøthe í Jákupsstovu, Nedjeljko Jedvaj, Aleksandar Jelenak, Rasmus Erik Voel Jensen, Lauri Jesmin, Wang Jian, Amed Ç. Jiyan, Klaus Ade Johnstad, Petri Jooste, Richard June,

Andrej Kacian, Thomas Kalka, Alevtina Karashokova, Carole Karema, Jorma Karvonen, Yannis Kaskamanidis, Kazuhiko, Gabor Kelemen, Mark Kim, Thomas Klausner, Koby, Marcin 'Shard' Konicki, Ines Kovacevic, Mantas Kriauciunas, Freek de Kruijf, Andrzej M. Krzysztofowicz, Anand Kulkarni, Enes Burhan KURAN, Piotr Kwilinski, Serafeim Kyriaki,

J.F.M. Lange, Matthew Lange, Fabio Lazarin, Niko Lewman, Arkadiusz Lipiec, Ricky Lontoc, Dag H. Loras, Burkhard Luck,

Nuno Magalhães, Vincent Mahlangu, Ankit Malik, Neskie Manuel, Fred Ulisses Maranhao, Yannig MARCHEGAY (Kokoyaya), Jorge Mariano, Martin, Sergio Marques, Pheledi Mathibela, Scott McCreary, Marco Milanesi, Never Min, Kartik Mistry, Viateur MUGENZI, Mugunth, Benson Muite, Noëlla Mupole, Steve Murphy, Samuel Murray (Groenkloof),

Philibert Ndandali, Shumani Mercy Nehulaudzi, Mikkel Kirkgaard Nielsen, Alesis Novik, Nudjaree, Daniel Nylander,

Olli, Sven Ollino, James Olweny, Teresa Orive, Gareth Owen,

Quentin PAGÈS, Sorin Paliga, Yannis Papatzikos, Nikolay Parukhin, Alessandro Pasotti, Flavio Pastor, Patrick, George Patrick, Primoz Peterlin, Le Quang Phan, Henrik Pihl, Auk Piseth, Pablo Pita, Milan Plzik, Eric Poncet, Sergei Popov, John Popplewell,

Ivana Rakic, Adam 'foo-script' Rakowski, Rodrigo Perez Ramirez and Indigenas Sin Fronteras, Sebastian Rasmussen, Robert Readman, Leandro Regueiro, Samir Ribić, Jozef Říha, Simona Riva, Michael de Rooij, Robin Rosenberg, Philipp Rösner, Ilir Rugova, Jaroslav Rynik,

Bert Saal, Ibraahiima SAAR, Saikumar, Pablo Saratxaga, Samuel Sarpong, Kevin Patrick Scannell, Stephanie Schilling, Luc 'Begasus' Schrijvers, Kiriaki SERAFEIM, Pavithran Shakamuri, Savitha Shankar, Terrence Sheflin, Gia Shervashidze, Clytie Siddall, Kliment Simoncev, sipho, Tomas Skäre, Sokratis Sofianopoulos, Khoem Sokhem, Songhay localisation and dictionary project, Geert Stams, Peter Sterba, Raivis Strogonovs, Luis C. Suárez, Sugar Labs i18n team,

Tomasz 'karave' Tarach, Michal Terbert, Will Thompson, Ignacio Tike, Tilo, Tarmo Toikkanen, TOYAMA Shin-ichi, Niall Tracey, Gerasim Troeglazov, tropikhajma, Peter Tuhársky, Florence Tushabe,

Matej Urbančič,

Vankata453, Rita Verbauskaite, Daniel Jose Viana, Charles Vidal,

Darrell Walisser, Frank Weng,

Damian Yerrick,

Muhammad Najmi Ahmad Zabidi, 臧传明, Eugene Zelenko, Martin Zhekov, and Huang Zuzhen.

SEE ALSO¶

tuxpaint-import(1), tuxpaint-config(1), tp-magic-config(1), xpaint(1), gpaint(1), gimp(1), kolourpaint(1), krita(1), gcompris(1)

And documentation within /usr/[local/]share/doc/tuxpaint/0.9.33/.