TUXPAINT(1) Tux Paint TUXPAINT(1)NAMEtuxpaint-- "Tux Paint", a drawing program for young children.
SYNOPSYStuxpaint [--help --version --verbose-version --usage --copying]
tuxpaint [--fullscreen]
[--allowscreensaver]
[--WIDTHxHEIGHT]
[--native]
[--orient=portrait]
[--startblank]
[--nosound]
[--noquit]
[--noprint]
[--printdelay=SECONDS]
[--printcfg]
[--altprintalways | --altprintnever]
[--papersize PAPERSIZE | --papersize help]
[--simpleshapes]
[--uppercase]
[--grab]
[--noshortcuts]
[--nowheelmouse]
[--nobuttondistinction]
[--nofancycursors]
[--hidecursor]
[--nooutlines]
[--nostamps]
[--nostampcontrols]
[--nomagiccontrols]
[--nolabel]
[--mirrorstamps]
[--mouse-accessibility]
[--onscreen-keyboard]
[--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]
[--savedir DIR]
[--datadir DIR]
[--saveover]
[--saveovernew]
[--nosave]
[--autosave]
[--colorfile FILE]
tuxpaint (defaults)
[--windowed]
[--disablescreensaver]
[--800x600]
[--orient=landscape]
[--startlast]
[--sound]
[--quit]
[--print]
[--printdelay=0]
[--noprintcfg]
[--altprintmod]
[--complexshapes]
[--mixedcase]
[--dontgrab]
[--shortcuts]
[--wheelmouse]
[--buttondistinction]
[--fancycursors]
[--showcursor]
[--outlines]
[--stamps]
[--stampcontrols]
[--magiccontrols]
[--label]
[--dontmirrorstamps]
[--stampsize=default]
[--mouse]
[--sysfonts]
[--currentlocalefont]
[--saveoverask]
[--save]
[--noautosave]
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 enter‐
taining, child-oriented additions such as sound effects.
OPTIONS - INFORMATIONAL
--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.
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 con‐
figuration files. (See below.)
--fullscreen --windowed
Run Tux Paint in full-screen mode, or in a window (default).
--allowscreensaver --disablescreensaver
Normally, tuxpaint disables your screensaver. Use
--allowscreensaver to prevent this from happening.
--native
When in fullscreen mode, use the system's default screen reso‐
lution.
--WIDTHxHEIGHT
Run Tux Paint in a particularly-sized window, or at a particu‐
lar fullscreen resolution (if --native is not used). Default
is 800x600. Minimum width is 640. Minimum height is 480.
Portrait and landscape orientations are both supported. (Also
see --orient, below.)
--orient=landscape --orient=portrait
If --orient=portraitis set, asks Tux Paint to swap the WIDTH
and HEIGHT values it uses for windowed or fullscreen mode,
without having to actually change the WIDTH and HEIGHT values
in the configuration file or on the command-line. (This is use‐
ful on devices where the screen can be rotated, e.g. tablet
PCs.)
--nosound --sound
Disable or enable (default) sound.
--noquit --quit
Disable or enable (default) the on-screen Quit button and
Escape key sequence for quitting Tux Paint. Instead, use the
window close button in the titlebar, the Alt+F4 key sequence,
or the Shift+Control+Escape key sequence.
--noprint --print
Disable or enable (default) the Print command within Tux Paint.
--printdelay=SECONDS --printdelay=0
Only allow printing (via the Print command) once every SECONDS
seconds. Default is 0 (no limitation).
--printcfg --noprintcfg
(Windows and Mac OS X only.) Enable or disable loading and
saving of printer settings. By default, Tux Paint will print
to the default printer with default settings. Pressing [ALT]
while pushing the Print button will cause a printer dialog to
appear (as long as you're not in fullscreen mode; see also
--altprintalways and --altprintnever, below.) Unless
--noprintcfg is used, your previous settings will be loaded
when Tux Paint starts up, and setting changes will be saved for
next time.
--altprintmod --altprintnever --altprintalways
These options control whether an system printer dialog appears
when the user clicks the Print button. By default (--altprint‐
mod), pressing [ALT] while clicking Print will bring up a dia‐
log (unless you're in fullscreen mode). With --altprintalways,
the dialog will always appear, even if [ALT] is not being held.
With --altprintnever, the dialog will never appear, even if
[ALT] is being held.
--papersize PAPERSIZE
(Only when PostScript printing is used - not Windows, Mac OS X
or BeOS.) Ask Tux Paint to generate PostScript of a particular
paper size. Valid sizes are those supported by libpaper. See
papersize(5).
--simpleshapes --complexshapes
Disable or enable (default) the rotation step when using the
Shape tool within Tux Paint. When disabled, shapes cannot be
rotated; however, the interface is easier (click, drag,
release), which can be useful for younger or disabled children.
--uppercase --mixedcase
In uppercase mode, all text prompts and the Text drawing tool
will display only uppercase letters. This is useful for chil‐
dren who are not yet comfortable with the lowercase character‐
set. Default mode is mixed case.
--grab --nograb
Grab the mouse and keyboard input (if possible), so that the
mouse is confined to the Tux Paint window. Default is to not
grab.
--noshortcuts --shortcuts
If noshortcuts mode, keyboard shortcuts (e.g., Ctrl+S for Save)
will be disabled. Default mode is shortcuts enabled.
--nowheelmouse --wheelmouse
By default, the wheel (jog dial) on a mouse will be used to
scroll the selector on the right of the screen. This can be
disabled, and the wheel completely ignored, with the --nowheel‐
mouse option. This is useful for children who aren't yet com‐
fortable with the mouse. Default is to support the wheel.
--nobuttondistinction --buttondistinction
By default, only mouse button #1 (typically the leftmost mouse
button on mice with more than one button) can be used for
interacting with Tux Paint. With the --nobuttondistinction
option, mouse buttons #2 (middle) and #3 (right) can be used,
as well. This is useful for children who aren't yet comfort‐
able with the mouse. Default is to only recognize button #1.
--nofancycursors --fancycursors
Disable or enable (default) the 'fancy' mouse pointer shapes in
Tux Paint. While the shapes are larger, and context sensitive,
some environments have trouble displaying the mouse pointer,
and/or leave 'trails' on the screen.
--hidecursor --showcursor
Completely hide, or enable (default) the mouse pointer in Tux
Paint. This can be useful on touchscreen devices, such as
tablet PCs.
--nooutlines --outlines
In nooutlines mode, much simpler outlines and 'rubber-band'
lines are displayed when using the Lines, Shapes, Stamps and
Eraser tools. (This can help when Tux Paint is run on slower
computers, or displayed on a remote X display.)
--nostamps --stamps
With nostamps set, Rubber Stamp images are not loaded, so the
Stamps tool will not be available. This option can be used to
reduce the time Tux Paint takes to load, and reduce the amount
of RAM it requires.
--nostampcontrols --stampcontrols
Disable or enable (default) buttons to control stamps. Con‐
trols include mirror, flip, shrink and grow. (Note: Not all
stamps will be controllable in all ways.)
--nomagiccontrols --magiccontrols
Disable or enable (default) buttons to control Magic tools.
Controls include controlling whether a Magic tool is used like
a paint brush, or if it affects the entire image at once.
(Note: Not all Magic tools will be controllable.)
--nolabel --label
Disable or enable (default) the Label tool, which lets you cre‐
ate text which can be altered or moved later.
--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.
--mouse-accessibility
In this mode, instead of clicking, dragging and releasing
(e.g., to draw), you click, move, and click again to end the
motion.
--onscreen-keyboard
Presents a clickable on-screen keyboard when using the Text and
Label tools.
--stampsize=size --stampsize=default
Sets the default size of all stamps, relative to their possible
sizes (determined by Tux Paint, based on the dimensions of both
the stamps themselves, and the drawing canvas). Valid values
are from 0 (smallest) to 10 (largest). Use default to let Tux
Paint choose (this is the default setting).
--keyboard --mouse
The keyboard option lets the mouse pointer in Tux Paint be con‐
trolled with the keyboard. The arrow keys move the pointer.
Spacebar acts as the mouse button.
--nosysfonts --sysfonts
Tux Paint normally attempts to search for additional TrueType
Fonts installed in common places on your system. If this
causes trouble, or you'd prefer to only make fonts installed in
Tux Paint's directory available, use the nosysfonts option to
disable this feature.
--alllocalefonts --currentlocalefont
Tux Paint avoids loading any fonts in its 'locale' font subdi‐
rectory, except any that match the current locale Tux Paint is
running under. Use the alllocalefonts option to load all such
fonts, for use in the "Text" tool. (This is the old behavior,
prior to version 0.9.21.)
--savedir DIR
Specify where Tux Paint should save files.
--datadir DIR
Specify where Tux Paint should look for personal data files
(brushes, stamps, etc.).
--saveover --saveovernew --saveoverask
If, when saving a picture, an older version of the file will be
overwritten, Tux Paint will, by default, ask for confirmation:
either save over the old file, or create a new file. This
prompt can be disabled with --saveover (which always saves over
older versions of pictures) or --saveovernew (which always
saves a new file). The default is to prompt (--saveoverask).
--nosave --save
The nosave option disables Tux Paint's ability to save files.
This can be used in situations where the program is only being
used for fun, or in a test environment.
--autosave --noautosave
The autosave option prevents Tux Paint from asking whether you
want to save the current picture when quitting, and assumes you
do.
--startblank --startlast
When you start Tux Paint, it loads the last image that was
being worked on. The --startblank option disables this, so it
always starts with a blank canvas. The default behavior is
--startlast.
--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
Various parts of Tux Paint have been translated into numerous lan‐
guages. 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][@modi‐
fier], 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.)
For example, de_DE@euro for German, or pt_BR for Brazilian Por‐
tuguese.
--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:
- english | american-english
- acholi | acoli
- afrikaans
- akan | twi-fante
- albanian
- amharic
- arabic
- aragones
- armenian | hayeren
- assamese
- asturian
- azerbaijani
- australian-english
- bambara
- basque | euskara
- belarusian | bielaruskaja
- bokmal
- bosnian
- brazilian-portuguese | portugues-brazilian | brazilian
- breton | brezhoneg
- british | british-english
- bulgarian
- canadian-english
- catalan | catala
- chinese | simplified-chinese
- croatian | hrvatski
- czech | cesky
- danish | dansk
- dutch | nederlands
- esperanto
- estonian
- faroese
- finnish | suomi
- french | francais
- fula | fulah | pulaar-fulfulde
- gaelic | irish-gaelic | gaidhlig
- galician | galego
- georgian
- german | deutsch
- greek
- gronings | zudelk-veenkelonioals
- gujarati
- hebrew
- hindi
- hungarian | magyar
- icelandic | islenska
- indonesian | bahasa-indonesia
- inuktitut
- italian | italiano
- japanese
- kannada
- kiga | chiga
- kinyarwanda
- khmer
- klingon | tlhIngan
- konkani-devaganari
- konkani-roman
- korean
- kurdish
- latvian
- lithuanian | lietuviu
- luganda
- luxembourgish | letzebuergesch
- macedonian
- maithili
- malay
- malayalam
- manipuri-bengali
- manipuri-meitei-mayek
- marathi
- mexican-spanish | espanol-mejicano | mexican
- mongolian
- ndebele
- nepali
- northern-sotho | sesotho-sa-leboa
- norwegian | nynorsk | norsk
- occitan
- odia | oriya
- ojibway | ojibwe
- persian
- polish | polski
- portuguese | portugues
- punjabi | panjabi
- romanian
- russian | russkiy
- sanskrit
- santali-devaganari
- santali-ol-chiki
- scottish | scottish-gaelic | ghaidhlig
- serbian
- serbian-latin
- shuswap | secwepemctin
- slovak
- slovenian | slovensko
- songhay
- southafrican-english
- spanish | espanol
- sundanese
- swahili
- swedish | svenska
- tagalog
- tamil
- telugu
- thai
- tibetan
- traditional-chinese
- turkish
- twi
- ukrainian
- valencian
- venda
- venetian | veneto
- vietnamese
- walloon | walon
- welsh | cymraeg
- wolof
- xhosa
- zapotec | miahuatlan-zapotec
- zulu
--lang help
Display a lists of all supported languages.
OPTIONS - MISCELLANEOUS
--nosysconfig
With this option, Tux Paint will not attempt to read the sys‐
tem-wide configuration file (typically /etc/tuxpaint/tux‐
paint.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 indi‐
rectly (e.g., via SDL(3)), it only directly accesses the following:
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 to determine language to use, if setlocale(3) refers to
'LC_MESSAGES'.
FILES
/etc/tuxpaint/tuxpaint.conf
System-wide configuration file. It is read first (unless the
--nosysconfig option was given on the command-line).
(Created during installation.)
$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 con‐
figuration file.
(Not created or edited automatically; must be created manually.
You can do this by hand, or use 'Tux Paint Config..')
$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. (See tuxpaint-import(1).)
(Created when Save command is used.)
$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.)
(Created when Tux Paint is Quit.)
$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´ command-line argument.
(There's no reason to delete the lockfile, as it contains a
timestamp inside which causes it to expire after 30 seconds.)
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
The canonical place to find Tux Paint information is at http://www.tux‐
paint.org/.
AUTHORS
Bill Kendrick. <bill@newbreedsoftware.com>
With patches, fixes, extensions, translation, documentation and more
from lots of people, including, but not limited to:
Aki, Ashish Arora, Khalid Al Holan, Daniel Andersson, Hodorog Andrei,
Joana Portia Antwi-Danso, Adorilson Bezerra de Araujo, Xandru Armesto,
Ben Armstrong, Ravishankar Ayyakkannu, Dwayne Bailey, Martin Benjamin,
Denis Bodor, Ren� Brandenburger, Herman Bruyninckx, Lucie Burianova,
Laurentiu Buzdugan, Albert Cahalan, Pere Pujal Carabantes, Ouychai
Chaita, Zden�k Chalupsk�, Wei-Lun Chao, Jacques Chion, Ankit Choudary,
Abdoul Cisse, Urska Colner, Adam 'akanewbie' Corcoran, Helder Correia,
Ricardo Cruz, Laurent Dhima, Chandrakant Dhutadmal, Yavor Doganov, Joe
Dalton, Dawa Dolma, Kevin Donnelly, Ander Elortondo, Alberto Escudero-
Pascual, Jamil Farzana, Doruk Fisek, Dovix, Korvigellou An Drouizig
(Philippe), Fabian Franz, Derrick Frimpong, Martin Fuhrer, Fula Local‐
ization Project, Gabriel Gazzan, Alexander Geroimenko, Torsten Giebl,
Solomon Gizaw, Robert Glowczynski, Chris Goerner, Mikel Gonz�lez,
Volker Grabsch, The Greek Linux i18n Team, Edmund GRIMLEY EVANS, Fred‐
erico Goncalves Guimaraes, Joe Hanson, Sam "Criswell" Hart, Guy Hed,
Farinaz Hedayat, Tedi Heriyanto, Pjetur G. Hjaltason, Knut Erik Hol‐
lund, Khaled Hosny, Henry House, Mohomodou Houssouba, Song Huang, Karl
Ove Hufthammer, Roland Illig, Indigenas Sin Fronteras, Juan Irigoien,
Students of Vocational Higher Secondary School Irimpanam, Ivana Rakic,
Dmitriy Ivanov, Mogens Jaeger, Lis G�the � J�kupsstovu, Nedjeljko Jed‐
vaj, Aleksandar Jelenak, Rasmus Erik Voel Jensen, Wang Jian, Amed �.
Jiyan, Petri Jooste, Richard June, Andrej Kacian, Thomas Kalka, Jorma
Karvonen, Kazuhiko, Gabor Kelemen, Mark Kim, Thomas Klausner, Koby,
Marcin 'Shard' Konicki, Ines Kovacevic, Mantas Kriauciunas, Freek de
Kruijf, Andrzej M. Krzysztofowicz, Piotr Kwilinski, Serafeim Kyriaki,
Matthew Lange, Fabio Lazarin, Niko Lewman, Arkadiusz Lipiec, Ricky Lon‐
toc, Dag H. Loras, Burkhard Luck, Vincent Mahlangu, Ankit Malik, Neskie
Manuel, Fred Ulisses Maranhao, Yannig MARCHEGAY (Kokoyaya), Jorge Mari‐
ano, Martin, Sergio Marques, Pheledi Mathibela, Scott McCreary, Marco
Milanesi, Kartik Mistry, Mugunth, Steve Murphy, Samuel Murray (Groen‐
kloof), Shumani Mercy Nehulaudzi, Mikkel Kirkgaard Nielsen, Alesis
Novik, Daniel Nylander, Olli, James Olweny, Teresa Orive, Gareth Owen,
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, Sergei Popov, John
Popplewell, Rodrigo Perez Ramirez and Indigenas Sin Fronteras, Adam
'foo-script' Rakowski, Rodrigo Perez Ramirez, Robert Readman, Leandro
Regueiro, Simona Riva, Robin Rosenberg, Ilir Rugova, Jaroslav Rynik,
Bert Saal, Ibraahiima SAAR, Saikumar, Samuel Sarpong, Kevin Patrick
Scannell, Stephanie Schilling, Kiriaki SERAFEIM, Pavithran Shakamuri,
Gia Shervashidze, Clytie Siddall, Kliment Simoncev, Sokratis Sofi‐
anopoulos, Khoem Sokhem, Geert Stams, Peter Sterba, Raivis Strogonovs,
Tomasz 'karave' Tarach, Michal Terbert, Ignacia Tike, Tilo, Tarmo
Toikkanen, TOYAMA Shin-ichi, Niall Tracey, tropikhajma, Florence
Tushabe, Matej Urban, 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 ALSOtuxpaint-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.22 5 August 2014 TUXPAINT(1)
