Difference between revisions of "EepGet"

From I2P Wiki
Jump to navigation Jump to search
(Created page with "<languages /> Category:I2p <translate> = EepGet - a downloader for I2P = <!--T:1--> <!--T:2--> EepGet is a free tool for command line and non interactive download of fil...")
 
(This is a rewrite of the page in more natural English, with an effort to preserve the meaning. Some of the text in the Options section comes from the eepget manpage.)
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:
   
 
<!--T:2-->
  
<!--T:2-->
−
EepGet is a free tool for command line and non interactive download of files from the I2P network.
 +
EepGet is a free command-line tool for non-interactively downloading files from the I2P network.
   
 
<!--T:3-->
  
<!--T:3-->
−
Non-interactive means in this connection, EepGet can work undependent on the other presence of the user in the background. Thereby should be guaranteed that an once pushed data call requires no other user's intervention. Particularly with big files that is an advantage not to be underestimated: EepGet works, while the user rests.
 +
Non-interactive in this context means that the user does not need to watch and provide additional input. The user should be confident that once EepGet is started, it will successfully download the file. Particularly with big files this is an advantage not to be underestimated: EepGet works, while the user rests.
   
 
<!--T:4-->
  
<!--T:4-->
−
[[EepGet]] is developed actively together with I2P to function durably also with slow and unstable network connections. If a download misses because of an uncompleted connection, the connection as long as tries to accept [[EepGet]] again, since the download is closed (by pre-setting 5 times). If the questioned server the so named one
 +
[[EepGet]] is developed actively together with I2P to work reliably, even on slow and unstable network connections. If a download fails midway due to a broken connection, [[EepGet]] tries to resume the download as many times as the user specifies, or 5 times by default.
   
 
<!--T:5-->
  
<!--T:5-->
−
EepGet is a Java class which is called about the Shell-Script <tt>eepget</tt> by the user. If EepGet is called without parameter, it spends an orderly help about the possible options to be used.
 +
EepGet is a Java class which can be called from the command line with the <tt>eepget</tt> command. If EepGet is called without arguments, it outputs usage information.
   
 
== Screen shot == <!--T:6-->
  
== Screen shot == <!--T:6-->
Line 27: Line 27:
   
 
<!--T:9-->
  
<!--T:9-->
−
* All the following parameters are optionnal, it is possible to only give a URL.
 +
* All parameters are optional except for the URL.
 
*; -p <nowiki>proxyHost:proxyPort</nowiki>
  
*; -p <nowiki>proxyHost:proxyPort</nowiki>
−
*: The network address and the port to which EepGet should be bound. As a network address either the Hostname or the numeric IP address is to be indicated. This option is useful if the I2P-Router run on another computer than EepGet runs. Example: <tt> eepget-p localhost:4444 </tt>. Default: <tt> 127.0.0.1:4444 </tt>.
 +
*: The network address and the port to which EepGet should be bound. The <tt> proxyHost </tt> should be either a hostname or a numeric IP address. This option is useful if you're running EepGet on a different computer than the I2P-Router. Example: <tt> eepget -p localhost:4444 </tt>. Default: <tt> 127.0.0.1:4444 </tt>.
 
*; -n retries
  
*; -n retries
−
*: Number of the attempts, how often EepGet should accept missed connections again. Default:<tt>5</tt>.
 +
*: The number of times EepGet should retry if the download fails. Default: <tt>5</tt>.
 
*; -e etag
  
*; -e etag
−
*: ETag (stands for? entity sit?, possibly Entitätmarke) is one in the HTTP 1.1 introduced Header fields. It serves for the regulation of changes in the requested resource and is applied mainly to the Caching, also of the avoidance of redundant data communications.
 +
*: ETag (stands for? entity sit?, possibly Entitätmarke) is one in the HTTP 1.1 introduced Header fields. It serves for the regulation of changes in the requested resource and is applied mainly to the caching, also of the avoidance of redundant data communications.
 
*; -o outputFile
  
*; -o outputFile
−
*: The document is saved under the given name. (The standard issue under Linux is not supported.)
 +
*: The document is saved under the given name. If this option is not given, the output filename will be determined by the URL.
−
*; -m markSize lineLen
 +
*; -m markSize
−
*: If the status announcement affects during the download. <tt> markSize</tt> from <tt> 0 </tt> the status announcement switches off. The option <tt> lineLen</tt> affects the duration of a measurement, visibly in the number of the given double sharps <tt>#</tt>. Default: <tt>1024</tt> und <tt>40</tt>.
 +
*: Controls the progress display. <tt> markSize </tt> is the number of bytes one <tt> # </tt> character represents. Default: <tt> 1024 </tt>
  +
*; -l lineLen
  +
*: Controls the progress display. <tt> lineLen </tt> is the length of one progress line in characters. Default: <tt> 40 </tt>
 
*; -t timeout
  
*; -t timeout
−
*: The duration to EepGet considers a connecting attempt as missed. <tt> time-out </tt> from <tt> 0 </tt> EepGet asks to wait infinitely for the connection. Default: 60 Seconds.
 +
*: How long until EepGet considers a connection attempt as missed. Setting <tt> timeout </tt> to <tt> 0 </tt> causes EepGet to wait indefinitely for the connection. Default: 60 Seconds.
 
*; -h headerName=headerValue
  
*; -h headerName=headerValue
 
*: <br />
  
*: <br />
 
*; -u username -x password
  
*; -u username -x password
−
*: Provided if an user's name and a password are required.
 +
*: Provide a [[username]] and a [[password]] if required.
 
*; url
  
*; url
 
*: The complete URL to the file.
  
*: The complete URL to the file.
Line 50: Line 52:
   
 
<!--T:14-->
  
<!--T:14-->
−
* [[EepGet]] can load files from the Internet or from Tor network if a appropriate Proxy is ready. However, dependent on the applied Proxy, the connecting data are not made anonymous. Example of use of such web proxys which accesses directly the Internet:<br> <code>./eepget -p localhost:8118 http://commons.wikimedia.org/wiki/File:Bouncywikilogo.gif</code>
 +
* By specifying a different proxy, [[EepGet]] can also be used to download files from the Internet or from the Tor network. However, be aware that depending on the proxy, this connection may not be made anonymously. Example use of [[EepGet]] with a web proxy which accesses the Internet directly:<br> <code>./eepget -p localhost:8118 http://commons.wikimedia.org/wiki/File:Bouncywikilogo.gif</code>
   
 
<!--T:15-->
  
<!--T:15-->

Latest revision as of 03:56, 7 April 2021

<languages /> <translate>

EepGet - a downloader for I2P

EepGet is a free command-line tool for non-interactively downloading files from the I2P network.

Non-interactive in this context means that the user does not need to watch and provide additional input. The user should be confident that once EepGet is started, it will successfully download the file. Particularly with big files this is an advantage not to be underestimated: EepGet works, while the user rests.

EepGet is developed actively together with I2P to work reliably, even on slow and unstable network connections. If a download fails midway due to a broken connection, EepGet tries to resume the download as many times as the user specifies, or 5 times by default.

EepGet is a Java class which can be called from the command line with the eepget command. If EepGet is called without arguments, it outputs usage information.

Screen shot

Example of use with 10 retries and the result:

./eepget -n 10 http://www.i2p2.i2p/_static/pdf/i2p_philosophy.pdf EepGet in the terminal after a successful download

Options

  • All parameters are optional except for the URL.
    -p proxyHost:proxyPort
    The network address and the port to which EepGet should be bound. The proxyHost should be either a hostname or a numeric IP address. This option is useful if you're running EepGet on a different computer than the I2P-Router. Example: eepget -p localhost:4444 . Default: 127.0.0.1:4444 .
    -n retries
    The number of times EepGet should retry if the download fails. Default: 5.
    -e etag
    ETag (stands for? entity sit?, possibly Entitätmarke) is one in the HTTP 1.1 introduced Header fields. It serves for the regulation of changes in the requested resource and is applied mainly to the caching, also of the avoidance of redundant data communications.
    -o outputFile
    The document is saved under the given name. If this option is not given, the output filename will be determined by the URL.
    -m markSize
    Controls the progress display. markSize is the number of bytes one # character represents. Default: 1024
    -l lineLen
    Controls the progress display. lineLen is the length of one progress line in characters. Default: 40
    -t timeout
    How long until EepGet considers a connection attempt as missed. Setting timeout to 0 causes EepGet to wait indefinitely for the connection. Default: 60 Seconds.
    -h headerName=headerValue

    -u username -x password
    Provide a username and a password if required.
    url
    The complete URL to the file.

Other use

  • By specifying a different proxy, EepGet can also be used to download files from the Internet or from the Tor network. However, be aware that depending on the proxy, this connection may not be made anonymously. Example use of EepGet with a web proxy which accesses the Internet directly:
    ./eepget -p localhost:8118 http://commons.wikimedia.org/wiki/File:Bouncywikilogo.gif
  • The I2P programs Syndie and azneti2phelper (Vuze) have already integrated EepGet and use it for the fulfillment of certain tasks.

References

</translate>

Retrieved from "http://wiki.i2p-projekt.i2p/wiki/index.php?title=EepGet&oldid=372"