Builtin NSISdl plug-in: Difference between revisions

From NSIS Wiki
Jump to navigationJump to search
No edit summary
 
(HTTPS limitations and warnings moved to proper section)
 
(11 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{DEFAULTSORT:NSISdl plug-in}}
[[Category:Plugins]]
[[Category:Plugins]]
== Introduction ==
== Introduction ==
This builtin plugin allows you to download files via HTTP.
This built-in plugin allows you to download files via HTTP ('''but not HTTPS''').


== Supported ==
== Supported ==
You can tell if your copy of NSIS supports NSISdl because when it compiles something it lists the builtin plugins at the top.
To find out whether your NSIS installation supports NSISdl, just compile a script. If NSISdl is listed in the compiler log, it is supported.  


   Processing config:  
   Processing config:  
Line 16: Line 17:
   :
   :


== Usage ==
== Standard usage instructions ==
There are 2 methods. The first downloads the file.
There are two methods. The first downloads the file:


   NSISdl::download http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0
   NSISdl::download http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0


And the second downloads it without warnings.
And the second downloads it without warnings:


   NSISdl::download_quiet http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0
   NSISdl::download_quiet http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0


where $0 is the name of the local file.
where <code>$0</code> is the name of the local file.


== Notes ==
For further usage instructions see [http://nsis.sourceforge.net/Docs/NSISdl/ReadMe.txt Docs\NSISdl\ReadMe.txt], [[NSISdl deletes file(s) when offline]], [[NSISdl macro system]].
I have added this page because I could not find any documentation about NSISdl and was mis-lead by a lot of other older references to NSISdl scripts. I have guessed the parameters from google searches, but the page should be fleshed out by someone who actually knows what they are talking about ;)
 
== Limitations and warnings ==
 
* Has a verified risk of causing a false positive for "generic downloader trojan" in Kasperky antivirus software.
* Even if you specify a HTTPS link, this plugin will download via HTTP. If your link is redirected from HTTP to HTTPS via a server-sent HTTP header, you will encounter a timeout error. You might want to use the [[Inetc plug-in]] instead.
 
== Header file with various translations ==
 
Deguix has made a NSISdl header file which features various translations.
 
So far it has been translated into eight languages:
 
* English
* Portuguese
* Lithuanian
* German
* Chinese Traditional
* Simplified Chinese
* Croatian
* French
 
For further information and current version visit this thread:
[http://forums.winamp.com/showthread.php?postid=1279800 Forum-Thread]

Latest revision as of 14:27, 9 February 2018

Introduction

This built-in plugin allows you to download files via HTTP (but not HTTPS).

Supported

To find out whether your NSIS installation supports NSISdl, just compile a script. If NSISdl is listed in the compiler log, it is supported.

 Processing config: 
 Processing plugin dlls: "C:\Program Files\NSIS\Plugins\*.dll"
  - AdvSplash::show
  - Banner::destroy
  - Banner::getWindow
  :
  - NSISdl::download
  - NSISdl::download_quiet
  :

Standard usage instructions

There are two methods. The first downloads the file:

 NSISdl::download http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0

And the second downloads it without warnings:

 NSISdl::download_quiet http://download.nullsoft.com/winamp/client/winamp291_lite.exe $0

where $0 is the name of the local file.

For further usage instructions see Docs\NSISdl\ReadMe.txt, NSISdl deletes file(s) when offline, NSISdl macro system.

Limitations and warnings

  • Has a verified risk of causing a false positive for "generic downloader trojan" in Kasperky antivirus software.
  • Even if you specify a HTTPS link, this plugin will download via HTTP. If your link is redirected from HTTP to HTTPS via a server-sent HTTP header, you will encounter a timeout error. You might want to use the Inetc plug-in instead.

Header file with various translations

Deguix has made a NSISdl header file which features various translations.

So far it has been translated into eight languages:

  • English
  • Portuguese
  • Lithuanian
  • German
  • Chinese Traditional
  • Simplified Chinese
  • Croatian
  • French

For further information and current version visit this thread: Forum-Thread