A download manager for Puppy Linux.
Welcome! This page explains how pWget works and how to make good use of its possibilities.
The overall aim is to enable anyone (not just nerds) to enjoy the power of wget... without the sweat and dirty hands ;)
This help page assumes you are using pWget 0.9.(or +)
If you've been using earlier versions and were happy with the way it all worked, nothing needs to change.
pWget 0.9 adds several new possibilities, but you don't have to use them. For occasionally downloading a file, there's no need to 'learn' the new functions, if it doesn't appeal to you.
Let's dive into it.
This is the start window:
It's still the same simple interface, but I had to add some stuff:
- the current wget arguments ("wget -c -P" in the image)
- a button to edit those arguments
- the current download mode ("term" in the image)
- a help button linking to this page
To change the download mode and other preferences, click the Preferences button:
For convenience, the wget arguments and the button to open the wget editor are repeated here in Preferences.
Keep terminal open after a download : this was introduced in pwget 0.7, a good idea suggested by forum member L18L. It allows to read what wget has been doing and check for possible error messages... However, I've always liked the "old" behaviour: the terminal closing as soon as the download is ready, followed by the opening of the file manager, showing the freshly downloaded file in its folder. So now this checkbox gives you the choice between those two ways.
In fact, if most of your downloading is from reliable servers (like ibiblio and mirrors) and you're using the "-c" argument, just about all that could go wrong is you forgetting to enter the URL...
Terminal: white font on black backgound : a matter of taste -or eye-sight- ...it seems about half of terminal users prefer a dark background, the other half a light one ;)
Reopen the start window after a download : this keeps pWget in "standby" mode, so you do not have to go into the menu again or find the desktop icon for the next download(s).
The three radio-buttons are self-explaining. pWget now lets you choose between using the terminal, progress bar or "multi"-download.
Stop the download: when using the terminal, pressing Ctrl+c kills the wget process. You can then remove the partial download from the destination folder.
Silent mode :
Stop the download: in silent mode the Stop button will kill wget and remove the partial download from the destination folder.
Multi also offers the choice (checkbox) between using the terminal or progress bars. If terminal, it also "obeys" the terminal checkboxes in Preferences.
Multi, using terminal, has its own wget arguments (wget -c --input-file=/xxx/xxx/Download_list.txt -P), while Multi in silent mode is up to eight simultaneous wget processes. The result is that Multi-in-terminal stately downloads one file at the time, while Multi-in-silent-mode is a friendly fight for bandwidth between the wget processes.
You may wonder: why only eight files? Well, more felt like gluttony to me :) Seriously, if you need more, don't use Multi, read a little about the "-i (--input-file)" argument and make your Download_list as long as you want.
The above Multi-download window opens at the right hand border of the screen, to leave as much space as possible for other windows (e.g. browser) to drag&drop URLs from. It is also close to the clipboard to copy/paste from it. This window positioning is still experimental, only tested on my hardware...
Multi in terminal :
Stop the download: when using the terminal, pressing Ctrl+c kills the wget process. You can then remove the partial downloads from the destination folder.
Multi in silent mode :
Stop the download: in Multi-silent mode the Stop button will kill wget. You can then remove the partial downloads from the destination folder.
Export/backup : At first sight, it may look like overkill to have this in a small program like pWget. I tried to forget this idea, but it kept coming back.
Now I'm convinced of its usefulness:
Many Puppy Linux users migrate regularly from one Puppy to another, or use several Puppy versions. It would quickly become a nuisance always having to remember and set up your preferences, notes and your wget argument-combinations. (see below for more on notes in wget editor)
This function copies everything in /usr/local/pwget/PREF and builds a pet out of it:
Wherever you migrate to, clicking this pet will give you 'your' pWget, ready to go. (pWget must of course already be installed)
Another advantage is when things would go wrong: installing this backup will almost certainly restore pWget to normal functioning. (the pet also contains the configuration files)
wget editor :
The left column is the official wget help file, integrated. It's just a reference list, so there's nothing to click or select...
Here it is in Dutch. Having the wget translation file installed not only lets the terminal speak your language, but also translates this help file.
See this forum thread if you would like more information about how to get wget translated to your language.
The right side is where the action is:
This tool-tip is important. Because of the way pWget is scripted, '-P ' has to be the last argument. It is equal to "--directory-prefix=" and needs a path to a DIR directly following it, which the code provides. (in default pWget: "/mnt/home"). So you are free to add other arguments before '-P ', but NOT after.
For serious wget users, this is what makes pWget attractive: having all your notes and argument-combinations available, ready to be pasted in the "Edit wget arguments" entry field above 'Notes'. As far as I know, no other wget frontend has brought this ease, versatility and power this close to your fingertips. </info-commercial> ;) ;) ;)
This button opens the online official wget man page (documentation) in the default web browser.
I believe this page is only available in English.
But it's an excellent manual!
While building the wget editor, it was tempting to make it even wider, to avoid having to scroll horizontally in the wget help list. But then I realized I'm using a 22-23 inch screen... Perhaps the wget editor already is a huge monster on a 10 inch screen... I have no way to check, complaints will tell ;)
Oh yes, the info button in the start window opens the ... info window:
I added a button linking to the pWget forum thread.
Note also that, starting from version 0.9 "choosing your preferred terminal" is no longer possible.
Trying to make the different terminals out there behave exactly the same way, quickly became a nightmare, so I settled on one: rxvt.
Lastly, you may have noticed that with v.0.9 the name changed from Pwget to pWget.
This nicely accentuates wget, the great engine, for which pWget just tries to be a user friendly dashboard.
But the first reason for the change was that I discovered there was already a wget frontend called Pwget (Perl wget) and I didn't want to see them in court... ;)
Hope you'll enjoy using pWget!
Bert, Feb 2015
When Lobster started this little project, back in 2008, he wrote something like:
"Pwget is a frontend for the wget utility, or rather it would be, if I could code..."
I am often reminded of this line while working on pWget, banging my head against the (rather low) ceiling of my knowledge all the time...
I would like to thank the following people either for their code examples and tutorials, or for directly helping me (apologies if I forgot someone):
zigbert, sunburnt, SFR, RHS, MochiMoppel, mikeb, L18L, don570, dejan555.