---
name: "tkpp"
section: "1p"
platform: "linux"
package: "libpar-packer-perl"
version: "1.012-1"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/tkpp/1p"
---

# tkpp(1p)

frontend to pp written in Perl/Tk

## NAME

tkpp - frontend to pp written in Perl/Tk

## SYNOPSIS

**tkpp**

## DESCRIPTION

Tkpp is a GUI frontend to pp, which can turn perl scripts into stand-alone PAR files, perl scripts or executables.

Below is a short explanation of all available screen elements; it is also displayed from the `"Help"` - `"Help Contents"` menu item.

### Source file

The file you want to pack.

### Output file (--output, --par, --perlscript)

The file you want the source file packed as.  This option recognizes the `".par"`, `".pl"` and executable extensions, and supplies the corresponding build option automatically.

### Use icon (--icon)

The icon file you want your output file to use.  This option will only work when building Microsoft Windows `".exe"` files.  Currently, this option only accepts `".ico"` files.

### Add modules/files (--add)

Add the specified items into the package, along with their dependencies. Multiple items should be separated by a comma (`","`) or semicolon (`";"`).

### Exclude modules (--exclude)

Exclude the given module from the dependency search path and from the package.  Multiple modules should be separated by a comma (`","`) or semicolon (`";"`).

### Scan dependencies (--compile, --execute, --noscan)

Specify the dependency scanning method to use.  See pp for explanations of the options.

### GUI (--gui)

Build an executable that does not have a console window.  This option is only applicable on Microsoft Windows, and is ignored when the output file is a `".par"` file.

### Log (--log)

Log the output of packaging to a file.  The log file, *tkpp.log*, will be written in the user's home directory.

### Verbose (--verbose)

Increase verbosity of output; from 1 to 3, 3 being the most verbose. This option is ignored if logging is not enabled.

### Build

Starts building the package.

### File Menu-\>Preferences

Specify the location to *perl* and *pp*.  They must be set before Tkpp will build anything.  The Tkpp configuration file, *.tkpprc*, is stored in the user's home directory.

## NOTES

I write code for a living not literature, so any misspelled words in any comments or anything, whoops ;)

## SEE ALSO

pp, PAR

## AUTHORS

Tkpp was written by Doug Gruber. In the event this application breaks, you get both pieces ;)

## COPYRIGHT

Copyright 2003, 2004, 2005, 2006 by Doug Gruber \<doug(a)dougthug.com\>, Audrey Tang \<cpan@audreyt.org\>.

Neither this program nor the associated pp program impose any licensing restrictions on files generated by their execution, in accordance with the 8th article of the Artistic License:

```
    "Aggregation of this Package with a commercial distribution is
    always permitted provided that the use of this Package is embedded;
    that is, when no overt attempt is made to make this Package's
    interfaces visible to the end user of the commercial distribution.
    Such use shall not be construed as a distribution of this Package."
```

Therefore, you are absolutely free to place any license on the resulting executable, as long as the packed 3rd-party libraries are also available under the Artistic License.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See \<http://www.perl.com/perl/misc/Artistic.html\>