Sitiom↵: Created page with "{{PageAuthor|Sitiom↵}} == Links == Download: [https://github.com/negrutiu/nsis-nscurl/releases/latest Latest Release] [https://github.com/negrutiu/nsis-nscurl GitHub Repo..."

2021-07-28T07:04:27Z

Created page with "{{PageAuthor|Sitiom↵}} == Links == Download: [https://github.com/negrutiu/nsis-nscurl/releases/latest Latest Release] [https://github.com/negrutiu/nsis-nscurl GitHub Repo..."

New page

{{PageAuthor|Sitiom↵}}

== Links ==

Download:
[https://github.com/negrutiu/nsis-nscurl/releases/latest Latest Release]

[https://github.com/negrutiu/nsis-nscurl GitHub Repo]

== Description ==

NScurl is an NSIS (Nullsoft Scriptable Install System) plugin with advanced HTTP/HTTPS capabilities.

It’s implemented on top of [https://curl.haxx.se/libcurl/ libcurl] with [https://www.openssl.org/ OpenSSL] as SSL backend.

This plugin is included in my unofficial [https://github.com/negrutiu/nsis NSIS builds].

== Features ==

* '''Modern''': supports modern SSL protocols and cyphers including HTTPS/2, TLS1.3, etc.
* '''Compatible''': works well on Windows NT4, Windows 10 and everything in between
* '''Multi-threaded''': download/upload multiple files in parallel
* '''Asynchronous''': start multiple background transfers, check on them later
* '''Insistent''': multiple attempts to connect and resume interrupted transfers
* '''NSIS aware''': download files at any installation stage (from <code>.onInit</code>, from <code>Sections</code>, from custom pages, silent installers, etc)
* '''Verbose''': plenty of useful information is available for querying (transfer size, speed, HTTP status, HTTP headers, etc)
* Supports HTTP and TLS authentication
* Supports all relevant HTTP methods (GET, POST, HEAD, etc)
* Supports DNS-over-HTTPS name resolution
* Supports custom HTTP headers and data
* Supports proxy servers (both authenticated and open)
* Supports files larger than 4GB
* Can download remote content to RAM instead of a file
* Works well in '''64-bit''' [https://github.com/negrutiu/nsis NSIS builds]
* A lot more… Check out the included [https://github.com/negrutiu/nsis-nscurl/blob/master/NScurl.Readme.htm documentation]

== Basic usage ==

* Check out the [https://github.com/negrutiu/nsis-nscurl/wiki/Getting-Started/ Getting Started] wiki page
* Quick transfer:

<highlight-nsis>
NScurl::http GET "http://live.sysinternals.com/Files/SysinternalsSuite.zip" "$TEMP\SysinternalsSuite.zip" /CANCEL /RESUME /END
Pop $0 ; Status text ("OK" for success)
</highlight-nsis>

* Quick transfer (custom GET parameters + custom request headers):

<highlight-nsis>
NScurl::http GET "https://httpbin.org/get?param1=value1&param2=value2" "$TEMP\httpbin_get.json" /HEADER "Header1: Value1"
/HEADER "Header2: Value2" /END
Pop $0
</highlight-nsis>

* POST a .json file

<highlight-nsis>
NScurl::http POST "https://httpbin.org/post" MEMORY /HEADER "Content-Type: application/json" /DATA '{ "number_of_the_beast" : 666 }' /END
Pop $0
</highlight-nsis>

* POST a .json file (as MIME multi-part form)

<highlight-nsis>
NScurl::http POST "https://httpbin.org/post" Memory /POST "User" "My user name" /POST "Password" "My password" /POST FILENAME=maiden.json
TYPE=application/json "Details" '{ "number_of_the_beast" : 666 }' /END
Pop $0
</highlight-nsis>

* More complex examples in the [https://github.com/negrutiu/nsis-nscurl/blob/master/NScurl.Readme.htm documentation]

== Licenses ==

{| class="wikitable"
! Project
! License
|-
| This project itself
| [[Image:License-BSD3-blue.png|80px|link=https://github.com/negrutiu/nsis-nscurl/blob/master/LICENSE.md]]
|-
| libcurl
| [https://curl.haxx.se/docs/copyright.html MIT/X inspired]
|-
| OpenSSL
| [https://www.openssl.org/source/license.html Dual License]
|-
| nghttp2
| [https://github.com/nghttp2/nghttp2/blob/master/COPYING MIT]
|-
| zlib
| [https://www.zlib.net/zlib_license.html zlib]
|}

[[Category:Plugins]]

NScurl plug-in - Revision history

Sitiom↵: Created page with "{{PageAuthor|Sitiom↵}} == Links == Download: [https://github.com/negrutiu/nsis-nscurl/releases/latest Latest Release] [https://github.com/negrutiu/nsis-nscurl GitHub Repo..."