1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
6 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>URPO Utility for Remote Printing</title></head><body>
7 <table style="text-align: left; width: 640px; margin-left: auto; margin-right: auto;" border="0" cellpadding="2" cellspacing="2">
11 <td style="vertical-align: middle; width: 484px; background-color: rgb(204, 204, 255); text-align: center;"><span style="font-family: Helvetica,Arial,sans-serif;"></span><img style="width: 48px; height: 48px;" alt="" src="urpo.png" align="middle">
12 <big><span style="font-family: Helvetica,Arial,sans-serif;">URPO
13 Remote Printing Utility for Maemo</span></big> <br>
17 <td style="vertical-align: top; width: 484px; background-color: rgb(153, 153, 255);"><span style="font-family: Helvetica,Arial,sans-serif;"><a href="index.html">Home</a>
18 | <a href="download.html">Download</a>
19 | <a href="screenshot.html">Screenshots</a> | <a href="help.html">Help</a>
20 | <a href="apidoc/html/index.html">Api Documentation</a> | <a href="https://garage.maemo.org/projects/urpo/">Project page</a></span><br>
24 <td style="vertical-align: top;"><br>
25 <span style="font-family: Helvetica,Arial,sans-serif;"></span>
31 <a href="#features">Features</a>
32 <a href="#requiremets">Requirements</a>
33 <a href="#keygen">Generating
34 SSH-keys</a> <a href="#Settings">Settings</a>
35 <a href="#Printing">Printing</a>
36 <a href="#Debug">Debug</a><br>
42 Unix Remote Printing Operation<br>
45 A Program for printing files via a server<br>
48 � Arto Hyv�ttinen 2010<br>
54 URPO is free to use according to GPL 3. No guarantees. See <a href="http://www.gnu.org/licenses/gpl.html">the lisence</a>.<br>
57 <h3><a name="features"></a>Features<br>
61 With URPO you can print files to a printer attached to a
62 linux/unix-computer. URPO uses the<a href="http://www.cups.org/"> CUPS</a>-system
64 the computer for printing. It is designed for use on a Maemo 5
71 You can print files in all formats supported by CUPS:<br>
75 <li>Text files</li><li>PDF</li><li>PostScript</li><li>HP-GL/2</li><li>Image files: BMP, GIF, JPG, PhotoCD, PIX, PNG, PNM, TIFF</li>
79 <h3><a name="requiremets"></a>Requirements<br>
83 You need an <a href="http://www.openssh.org/"><span style="font-weight: bold;">openssh</span>-</a>program on your maemo
87 On the computer to which the printer is attached to, you need the <span style="font-weight: bold;">cups</span> and <span style="font-weight: bold;">ssh</span>-servers.
88 CUPS (Common Unix Printing System) is a printing server, installed by
89 default in several linux distributions. The ssh server is needed to
90 safely connect to the computer. The port 22 needs to be opened from the
91 computer's firewall. There is no need to open a port for cups.<br>
94 <h3><a name="keygen"></a>Generating SSH-keys</h3>
97 A SSH key pair is needed to identify the user. The key pair is created
98 in the maemo device:<br>
101 <code>ssh-keygen -t rsa</code><br>
104 The password is left empty. Remember where you have saved the keys! You
105 cannot save them in the MyDocs folder, since the private key must not
106 be accessible to others than the user.<br>
112 The access rights of the file need to be set:<br>
115 <code>chmod 600 ~/.ssh/id_urpo</code><br>
121 The public key is added to the server (computer) in the home
122 folder's .ssh folder's file authorized_keys . You can use
123 ssh for transferring it:<br>
126 <code>cat ~/.ssh/id_urpo.pub | ssh user@computer 'cat >>
127 ~./ssh/authorized_keys'</code><br>
133 The location of the private key is set in the settings of URPO.<br>
136 <h3><a name="Settings"></a> Settings<br>
140 When used for the first time URPO asks for settings. You can access
141 these settings later by choosing "Settings" from the menu. <span style="font-weight: bold;"></span><br>
144 <span style="font-weight: bold;">Host name or ip address:</span> The
145 computer's (server's) ip address, or its name if the device can
149 <span style="font-weight: bold;">Username: </span>The user account on
153 <span style="font-weight: bold;">Identity file</span>: The private
157 <h3><a name="Printing"></a>Printing</h3>
160 Choose the file to be printed (<span style="font-weight: bold;">Browse</span>).<br>
163 Choose the printer.<br>
166 If desired, limit what pages are to be printed, e.g 1,2 or 3-6 or 1,5-7
170 You can choose 1, 2 or 4 pages to be printed per sheet.<br>
173 You can print 1-99 copies.<br>
176 Printing is started with the <span style="font-weight: bold;">Print</span>-button.<br>
182 <h3><a name="Debug"></a>Debug-window</h3>
185 When<span style="font-weight: bold;"> "Debug</span>" is chosen from the
186 menu, a debug window opens. Information useful in solving problems,
187 such as the commands given to server trough ssh and their output, is
188 printed on that window. <br>
192 <td style="vertical-align: top;"><br>
196 <td style="vertical-align: top; width: 484px; background-color: rgb(204, 204, 255);">�
197 Arto Hyv�ttinen 2010. Urpo is free software under <a href="http://www.gnu.org/licenses/gpl.html" target="_blank">GNU
198 General Public License 3</a>.<br>