1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
5 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>URPO Utility for Remote Printing</title></head><body>
6 <table style="text-align: left; width: 640px; margin-left: auto; margin-right: auto;" border="0" cellpadding="2" cellspacing="2">
10 <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">
11 <big><span style="font-family: Helvetica,Arial,sans-serif;">URPO
12 Remote Printing Utility for Maemo</span></big> <br>
16 <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>
17 | <a href="https://garage.maemo.org/frs/?group_id=1697">Download</a>
18 | <a href="screenshot.html">Screenshots</a> | <a href="help.html">Help</a>
19 | <a href="apidoc/html/index.html">Api Documentation</a> | <a href="https://garage.maemo.org/projects/urpo/">Project page</a></span><br>
23 <td style="vertical-align: top;"><br>
24 <span style="font-family: Helvetica,Arial,sans-serif;"></span>
30 <a href="#features">Features</a>
31 <a href="#requiremets">Requirements</a>
32 <a href="#keygen">Generating
33 SSH-keys</a> <a href="#Settings">Settings</a>
34 <a href="#Printing">Printing</a>
35 <a href="#Debug">Debug</a><br>
41 Unix Remote Printing Operation<br>
44 A Program for printing files via a server<br>
47 � Arto Hyv�ttinen 2010<br>
53 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>
56 <h3><a name="features"></a>Features<br>
60 With URPO you can print files to a printer attached to a
61 linux/unix-computer. URPO uses the<a href="http://www.cups.org/"> CUPS</a>-system
63 the computer for printing. It is designed for use on a Maemo 5
70 You can print files in all formats supported by CUPS:<br>
74 <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>
78 <h3><a name="requiremets"></a>Requirements<br>
82 You need an <a href="http://www.openssh.org/"><span style="font-weight: bold;">openssh</span>-</a>program on your maemo
86 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.
87 CUPS (Common Unix Printing System) is a printing server, installed by
88 default in several linux distributions. The ssh server is needed to
89 safely connect to the computer. The port 22 needs to be opened from the
90 computer's firewall. There is no need to open a port for cups.<br>
93 <h3><a name="keygen"></a>Generating SSH-keys</h3>
96 A SSH key pair is needed to identify the user. The key pair is created
97 in the maemo device:<br>
100 <code>ssh-keygen -t rsa</code><br>
103 The password is left empty. Remember where you have saved the keys! You
104 cannot save them in the MyDocs folder, since the private key must not
105 be accessible to others than the user.<br>
111 The access rights of the file need to be set:<br>
114 <code>chmod 600 ~/.ssh/id_urpo</code><br>
120 The public key is added to the server (computer) in the home
121 folder's .ssh folder's file authorized_keys . You can use
122 ssh for transferring it:<br>
125 <code>cat ~/.ssh/id_urpo.pub | ssh user@computer 'cat >>
126 ~./ssh/authorized_keys'</code><br>
132 The location of the private key is set in the settings of URPO.<br>
135 <h3><a name="Settings"></a> Settings<br>
139 When used for the first time URPO asks for settings. You can access
140 these settings later by choosing "Settings" from the menu. <span style="font-weight: bold;"></span><br>
143 <span style="font-weight: bold;">Host name or ip address:</span> The
144 computer's (server's) ip address, or its name if the device can
148 <span style="font-weight: bold;">Username: </span>The user account on
152 <span style="font-weight: bold;">Identity file</span>: The private
156 <h3><a name="Printing"></a>Printing</h3>
159 Choose the file to be printed (<span style="font-weight: bold;">Browse</span>).<br>
162 Choose the printer.<br>
165 If desired, limit what pages are to be printed, e.g 1,2 or 3-6 or 1,5-7
169 You can choose 1, 2 or 4 pages to be printed per sheet.<br>
172 You can print 1-99 copies.<br>
175 Printing is started with the <span style="font-weight: bold;">Print</span>-button.<br>
181 <h3><a name="Debug"></a>Debug-window</h3>
184 When<span style="font-weight: bold;"> "Debug</span>" is chosen from the
185 menu, a debug window opens. Information useful in solving problems,
186 such as the commands given to server trough ssh and their output, is
187 printed on that window. <br>
191 <td style="vertical-align: top;"><br>
195 <td style="vertical-align: top; width: 484px; background-color: rgb(204, 204, 255);">�
196 Arto Hyv�ttinen 2010. Urpo is free software under <a href="http://www.gnu.org/licenses/gpl.html" target="_blank">GNU
197 General Public License 3</a>.<br>