clippur - Clipboard URL Utility

      Name                    Last modified       Size  Description

[TXT] changes.txt 09-Mar-2003 03:05 1k Change history [   ] clippur.exe 09-Mar-2003 03:29 52k Latest executable [   ] clippur.ini 09-Mar-2003 01:32 1k Sample .INI file [   ] clippur110.zip 17-Aug-2002 23:06 13k [   ] clippur120.zip 17-Aug-2002 23:06 13k [   ] clippur132.zip 04-Oct-2002 22:34 13k [   ] clippur133.zip 17-Oct-2002 22:48 14k [   ] clippur134.zip 24-Nov-2002 21:32 14k [   ] clippur214.zip 07-Dec-2002 21:57 15k [   ] clippur217.zip 23-Jan-2003 22:26 15k [   ] clippur221.zip 28-Feb-2003 19:06 16k [   ] clippur222.zip 02-Mar-2003 10:24 20k [   ] clippur223.zip 07-Mar-2003 00:22 20k [   ] clippur225.zip 08-Mar-2003 23:01 21k [   ] clippur226.zip 09-Mar-2003 03:30 21k Latest version [TXT] readme.txt 09-Mar-2003 03:14 8k [TXT] thanks.txt 09-Mar-2003 03:13 1k [TXT] todo.txt 08-Mar-2003 00:39 1k

clippur
 - Clipboard URL Utility

Copyright (C) 2002-2003, Carl Brännström, cb@aliquid.net

This is free software. Use it, share it, don't modify or make money
from it.



Table of contents
-----------------

* Introduction
* Alternative use
* Starting the application
* Testing the application
* Managing favourites
* Exiting the application
* Trouble-shooting
* Feedback, bug reports
* Other people's software



Introduction
------------

When you start clippur it will place itself in the upper-left corner
of the screen, 2-by-2 pixels small.

Left-clicking on clippur will launch all URLs on your clipboard in
your default web browser (Internet Explorer, Mozilla, Netscape etc.)

If you, like me, are using Simon Tatham's PuTTY, you will find
clippur a handy companion. Just double-click on an URL in the PuTTY
window and shoot clippur from the hip.

Right-clicking on clippur shows a popup menu that allows you to;
* open URLs (same as left-clicking)
* download the documents referenced to by the URLs using GNU Wget
* "shurlify" (make shorter) the first URL using www.shorl.com
* edit the content of your clipboard
* open one of a selection of favourites in your web browser
* modify and apply settings
* exit the application

Wget can also be executed by holding CTRL while left-clicking on
clippur.

The Favourites submenu can be activated by one of these three
alternative methods;
* middle-clicking (if you have a three-button mouse)
* pressing and holding left mouse button and then right-clicking
* right-clicking twice


Alternative use
---------------

clippur can also be used as a Favourites utility (see -f in the
section "Starting the application" below).

In this mode, left-clicking on clippur shows the Favourites menu
instead of opening URLs. Right-clicking still shows the popup menu.

You can still open URLs on your clipboard by selecting "Open" in the
popup menu, or you can use one of these two alternative methods;
* middle-clicking (if you have a three-button mouse)
* pressing and holding left mouse button and then right-clicking



Starting the application
------------------------

Place the executable file, optionally with the .INI file, in a folder
on your harddisk, and create a shortcut to it in the Start/Programs/
Autostart folder. You may delete the .TXT files.

clippur.exe accepts one or more of the following switches:

-q  Quiet mode (no flashing intro)
-c  Color (0xBBGGRR), default is 0x0000FF (red)
-p  Position (0..3 for UL, UR, LL, LR), default is 0 (upper-left)
-z  Retain topmost Z order
-f  Left-clicking shows the Favourites submenu instead of opening URLs
-t  Timeout when waiting for URL to be opened (milliseconds), default
    is 2000
-d  Hard delay between opening of multiple URLs (milliseconds),
    default is 100
-s  "Short URL" service onto which clipboard URL is appended,
    default is http://shorl.com/create.php?url=
-w  Name of wget program (full path if not in system path), must be
    specified last, default is wget.exe

Example: clippur.exe -q -c 0x44FF66 -p 2 -z -d 1500 -w c:\bin\wget.exe

Internet Explorer users may (will) have to specify a delay of at
least 1500ms (-d 1500) for multiple URLs to work.

If you use Wget, please make sure the shortcut's start folder is set
appropriately. This is where downloads will end up.



Testing the application
-----------------------

Select this entire paragraph using mouse or keyboard, copy it to the
clipboard by pressing CTRL-C and then left-click on clippur. Two web
browsers will be launched, one with the Internet Movie Database at
http://www.imdb.com one with Google at www.google.com and if you have
a default mail application you will get the opportunity to write me a
few lines at mailto:cb@aliquid.net?subject=clippur (you don't have to
send it, of course).

If only one web browser was opened and you are using Internet
Explorer, please refer to the section "Starting the application"
above.



Managing favourites
-------------------

The Favourites submenu is loaded when clippur starts from a file
with the same name and in the same folder as the .EXE file but with
.INI extension (i.e. clippur.ini unless you renamed the executable).

The .INI file should have a section called [Favourites] where each
shortcut is on the form "name=url" (or "name=program|arguments", see
below). Lines consisting of a single dash ("-") make menu separators.
See also the sample clippur.ini.

If your default web browser is not Internet Explorer but a site you
frequent require IE, you can create a favourite on the form
"name=iexplorer.exe|url" (provided IEXPLORER.EXE is in your system
path, otherwise you will have to supply a full path). Any program
and/or arguments can be specified.

Note: If you make changes to the .INI file without going through the
Settings menu item you will have to restart clippur for them to take
effect.

There is a default Favourites menu item "aliquid.net=
http://aliquid.net/?clippur" which brings you to my place. Please,
make yourself comfy.

Tip: Less is more. Most "favourites" probably belong inside your web
browser or on your desktop. I added Notepad and Calculator for
inspiration only.



Exiting the application
-----------------------

You exit the application by selecting "Exit" from the popup menu
(shown when you right-click on clippur).

clippur has zero footprint, it does not touch your registry or any
files on your computer other that the clippur.ini file. Uninstalling
the application is easy, just delete it.



Trouble-shooting
----------------

Problem:  URLs are always launched using the same Internet Explorer
          window.
Solution: Make sure Tools/Internet Options/Advanced/Reuse windows ...
          is not checked.

Problem:  URLs are sometimes launched using the same Internet Explorer
          window.
Solution: Try increasing the delay between opening multiple URLs (see
          -d argument in section "Starting the application").

Problem:  URLs are always launched using the same Mozilla window.
Solution: If you are using Mozilla 1.1 or later, try adding the
          following line to your prefs.js file (%USERHOME%\Application
          Data\Mozilla\Profiles\default\...\prefs.js):
          user_pref("advanced.system.supportDDEExec", false);

Problem:  URLs are launched in the wrong browser.
Solution: clippur uses whatever browser you have configured as being
          default. Please refer to you preferred browser's
          documentation on how to make it your default.

Problem:  Some sites require Internet Explorer but my default browser
          is Netscape/Mozilla/whatever.
Solution: Please refer to section "Managing favourites" above.

Problem:  I have placed clippur in the lower-left corner of the screen
          (-p 2) but the taskbar hides it.
Solution: Use the -z switch (see section "Starting the application").



Feedback, bug reports
---------------------

Feedback is welcome, bug reports will be read and wishes for new
features might be granted. See the top of this file for email address.



Other people's software
-----------------------

PuTTY
-----
Please visit the web site at
   http://www.chiark.greenend.org.uk/~sgtatham/putty/

GNU Wget
--------
Please visit the ftp site at
   ftp://sunsite.dk/projects/wget/windows

and download the following to files (or later versions of them):
* ftp://sunsite.dk/projects/wget/windows/wget-1.8.2b.zip
* ftp://sunsite.dk/projects/wget/windows/ssllibs.zip

Unzip the files into a directory where clippur can find them (see
section "Starting the application" above). Specifically, you will need
the following files:
* libeay32.dll
* ssleay32.dll
* wget.exe