---
name: "apspreview"
section: "1"
platform: "linux"
package: "apsfilter"
version: "7.2.6-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/apspreview"
---

# apspreview(1)

preview PostScript file(s) as generated by apsfilter

## NAME

**apspreview** – preview PostScript file(s) as generated by apsfilter

## SYNOPSIS

**apspreview** \[**-P***queue*\] \[**-Z***options*\] \[*input...*\]

**apspreview** \[**-h**\]

## DESCRIPTION

With **apspreview** you can create a PostScript representation of the file(s) you are about to print in order to check it before actually printing.

Your file(s) will be converted to PostScript according to the queue specific configuration, and afterwards you will be able to print all or some pages from your PostScript viewer application (gv, kghostview or ghostview).

## OPTIONS

- **-h**

  show help screen

- **-P***queue*

  select a printer queue (different from the default one)

- **-Z***options*

  use **apsfilter** command line options (comma-separated list)

- **input...**

  input file(s) \[default: stdin\]

## NOTES

If you use the **-P** option, please remember to pass the same printer queue on to the [lpr(1)](/lpr/1.md) command.

Be careful if your printer queue configuration includes a setting to create multiple pages per sheet **(PS\_NUP=2,** **PS\_NUP=4** **or** **PS\_NUP=8)**. In order to make sure that [apsfilter(1)](/apsfilter/1.md) does not repeat n-up printing, use the **1pps** command line option when actually printing the file.

**apspreview** only works correctly with entries in */etc/printcap* that have been created by **/usr/share/apsfilter/SETUP**. All configuration settings will be copied from the relevant *apsfilterrc* files.

## FILES

- */etc/printcap*

  printer capability data base

- */usr/share/apsfilter/bin/apsfilter*

  apsfilter script

- */usr/bin/aps2file*

  tool to save apsfilter output to a file

## SEE ALSO

[apsfilter(1)](/apsfilter/1.md), [aps2file(1)](/aps2file/1.md), [apsfilter-bug(1)](/apsfilter-bug/1.md), [apsfilterrc(5)](/apsfilterrc/5.md), [printcap(5)](/printcap/5.md)

## BUGS

See apsfilter software center - http://www.apsfilter.org/ - for new versions, bugfixes and known bugs.

Please use the new tool [apsfilter-bug(1)](/apsfilter-bug/1.md) to release bug- or problem reports. It automatically presents you a **form** in an editor window which asks you some standard questions. If you save and quit the editor session, then this report is sent automatically via  **e-mail** to the proper apsfilter mailinglist.

If apsfilter fails to print something or prints it in a way you wouldn't expect and you want to report an apsfilter error then please save the debugging output of one print session using the new [aps2file(1)](/aps2file/1.md) utility by typing **aps2file** **-D** **-Z** **options** **file** **\>** **/dev/null** **2\>** **file.debug** and including the debugging output in the file **file.debug** into the edit session of the **apsfilter-bug** utility, so that it is included into the mail to the apsfilter mailinglist.

Please note that you need to run /bin/sh (Bourne Shell), bash or a compatible shell, so that the above mentioned output redirection works. Under C-shell (/bin/csh) or tcsh it would't work. If you don't know, then simply make sure you use the Bournce shell by typing **/bin/sh** or **bash**, then you should have no problems with redirection of **stdout** and **stderr** (\> /dev/null 2\> file.debug).

## DOCUMENTATION

See official apsfilter homepage

- *http://www.apsfilter.org/handbook.html*

  Apsfilter Handbook including the Frequently Asked Questions (FAQ)

## USER FORUM

Please send questions to the official apsfilter help channel **apsfilter-help@apsfilter.org**. The above section **BUGS** and the file **HOWTO-BUGREPORTS** tells you how to report bugs. If you want to know how to troubleshoot your apsfilter installation, please read the manpage [aps2file(1)](/aps2file/1.md) and [apsfilter-bug(1)](/apsfilter-bug/1.md) as well as the **Apsfilter** **Handbook** carefully.

## HISTORY

The **apspreview** manpage has been written by Michael Loßin \<phallobst@web.de\> and first appeared in apsfilter V 7.1.0.