Skip to: site menu | section menu | main content

Wizou's website

What a program...
Currently viewing: Wizou's website » Programs » NSIS plugins » nsisSlideshow

nsisSlideshow 1.7


nsisSlideshow is a small NSIS plugin that can display fading banners/slideshow during installation.


  • Can be used inside NSIS window or on any other window (HWND) created by NSIS
  • Manual (synchronized) or Automatic mode (slideshow runs automatically while NSIS script continues)
  • You can add subtitles to your slides
  • Supports Unicode NSIS
  • Run-once or cycle to beginning at the end of slideshow
  • Multi-language support (you can decide which slide to display for each language)
  • Control over each slide display delay & transition delay
  • Pictures format can be JPEG, PNG, GIF, BMP, WMF


Source code included. See license of use below

Check out also all my other free & useful NSIS plugins!!

ReadMe file

nsisSlideshow -- Small NSIS plugin for displaying fading banners/slideshow
Web site:

You can use it to display advertisements or tips during installation.
Display of banners can be manual (synchronized) or automatic (slideshow runs while
NSIS script continues)

* This plugin has been tested under Windows XP & Vista
but it should be compatible with Windows 2000, XP, Vista and more recent
* Check the sample scripts for practical examples.

nsisSlideshow::show /NOUNLOAD [options] <picture filename>				(Manual mode)
nsisSlideshow::show /NOUNLOAD [options] /auto=<control file>			(Automatic mode)

options can be:
/HWND=<handle value>			use the bounds rectangle of the given window to draw the
								(by default, the banner occupies the area of the details listview)
/FIT=HEIGHT|WIDTH|BOTH|STRETCH	reduce/enlarge the picture(s) to fit the given
constraint inside the rectangle
								(default: BOTH)
/HALIGN=LEFT|CENTER|RIGHT		horizontal placement within the rectangle (default:
/VALIGN=TOP|CENTER|BOTTOM		vertical placement within the rectangle (default: CENTER)
/CCOLOR=0xBBGGRR				blue/green/red hexadecimal value for the color of the optional
subtitle (default: white)
								(make sure the color of the bottom part of the picture allows for
readability of the subtitle)

options in manual mode can also be:
/DURATION=<delay in ms>			fade-in duration to display the picture (default: 1000 ms)
"/CAPTION=<string>"				add the given subtitle string in the bottom of the picture
(use quotes if there are spaces)

pictures format can be JPEG, PNG, GIF, BMP, WMF

automatic control file is a text file that defines the pictures to display in the
slideshow, depending on the current language.
Format of definition groups:
[<language value>]			; Locale ID decimal value. See
=<picture filename>,<fadein delay>,<tempo delay>[,<subtitle caption>]
=<picture filename>,<fadein delay>,<tempo delay>[,<subtitle caption>]
=<picture filename>,<fadein delay>,<tempo delay>[,<subtitle caption>]
The pictures should preferably be in the same directory as the control file. (you
will typically extract the slideshow folder to $PLUGINSDIR)
Delay are in ms. Tempo delay is the time to wait before switching to the next
Subtitle caption must be encoded in the adequate language codepage (like NSIS
language strings)

If the group ends with a line containing only a period (.), the slideshow will stop
at the last picture.
Otherwise, the slideshow will cycle back to the first picture.

You can put several language groups in the control file, and change the
picture/captions/etc... according to the language.
If the current language is not found, it will default to group [1033] (english), and
if not found to group [0].


Call this to abort or terminate the display of banner(s) when the installation ends
This will also release memory used by the plugin and unload the DLL

2006-06-21 v1.0: initial EBanner plugin code by Takhir Bedertdinov
2009-01-08 v1.1: large rewrite. no more flickering
2009-02-17 v1.2: automatic crossfade in background
2009-06-16 v1.3: added automatic slideshow mode using a Slides folder
2009-08-19 v1.4: renamed plugin to nsisSlideshow. documentation
2009-09-07 v1.5: porting to Unicode NSIS
2010-04-27 v1.6: fixed 2 bugs in automatic mode
2011-05-07 v1.7: compatibility with IE9

Copyright (c) 2009-2011 Olivier Marcoux

This software is provided 'as-is', without any express or implied warranty. In no
event will the authors be held liable for any damages arising from the use of this

Permission is granted to anyone to use this software for any purpose, including
commercial applications, and to alter it and redistribute it freely, subject to the
following restrictions:

    1. The origin of this software must not be misrepresented; you must not claim
that you wrote the original software. If you use this software in a product, an
acknowledgment in the product documentation would be appreciated but is not

    2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.

    3. This notice may not be removed or altered from any source distribution.

Back to top