Configuration

lightGallery Desktop is highly customizable. All settings can be adjusted in real-time through the application's menu bar. Your preferences are automatically saved and will be applied the next time you open the app.

How Configuration Works

When you change a setting via the menu, the application updates a configuration file named lg-config.json located in your operating system's user data directory. The gallery will instantly reload to reflect the new settings.

Below is a comprehensive list of all available settings, organized by their respective menus.

General Settings (Settings Menu)

These options control the core behavior of the gallery.

  • Enable Drag (enableDrag): Toggles the ability to navigate between slides by clicking and dragging with the mouse. (Default: true)
  • Loop (loop): When enabled, the gallery loops back to the first image after the last one, and vice-versa. (Default: true)
  • Key Press (keyPress): Enables or disables keyboard arrow navigation. (Default: true)
  • Controls (controls): Shows or hides the previous/next arrow buttons on the sides of the image. (Default: true)
  • Mousewheel (mousewheel): Toggles the ability to navigate slides using the mouse scroll wheel. (Default: true)
  • Show After Load (showAfterLoad): If enabled, the content of a slide is displayed only after it has fully loaded. (Default: true)
  • Counter (counter): Shows or hides the image counter (e.g., "3 / 10"). (Default: true)
  • Pager (pager): Toggles a simple dot-based pager at the bottom of the screen. (Default: false)
  • Zoom (zoom): Enables or disables the zoom functionality. (Default: true)
  • Scale (scale): The increment/decrement value for zoom. Options range from 0.3 to 5. (Default: 1)

Transitions & Effects (View Menu)

Customize the visual style of the slideshow.

  • Mode (mode): Sets the transition animation between slides. Over 20 effects are available, including:
    • lg-slide (Default)
    • lg-fade
    • lg-zoom-in / lg-zoom-out
    • lg-slide-circular
    • lg-slide-skew
    • lg-lollipop
    • lg-rotate
    • ...and many more.
  • Easing (cssEasing): Defines the acceleration curve of the transition animations. A wide variety of standard CSS easing functions are available (e.g., ease, ease-in-out, linear). (Default: 'ease')
  • Speed (speed): The duration of the slide transition in milliseconds. Options range from 100 to 1000. (Default: 600)
  • Hide Bars Delay (hideBarsDelay): The delay in milliseconds before the toolbar and controls automatically hide. Options range from 1000 to 10000. (Default: 6000)
  • Slide End Animation (slideEndAnimatoin): Enables a bounce effect when trying to navigate past the first or last slide if loop is disabled. (Default: true)
  • Hide Control on End (hideControlOnEnd): Hides the next/prev buttons on the last/first slide if loop is disabled. (Default: false)

Thumbnails (Thumbnail Menu)

Configure the appearance and behavior of the thumbnail strip.

  • Thumbnail (thumbnail): Toggles the entire thumbnail feature on or off. (Default: true)
  • Animate Thumb (animateThumb): Enables a smooth sliding animation for the active thumbnail. (Default: true)
  • Current Pager Position (currentPagerPosition): Aligns the active thumbnail to the left, middle, or right of the thumbnail container. (Default: 'middle')
  • Toggle Thumb (toogleThumb): Shows or hides the button to manually toggle the thumbnail bar's visibility. (Default: true)
  • Enable Thumb Drag (enableThumbDrag): Toggles the ability to drag the thumbnail strip with a mouse. (Default: true)
  • Thumb Width (thumbWidth): Sets the width of each thumbnail in pixels. Options range from 25 to 300. (Default: 100)
  • Thumb Container Height (thumbContHeight): Sets the height of the thumbnail bar in pixels. Options range from 25 to 300. (Default: 100)
  • Thumb Margin (thumbMargin): Sets the spacing between thumbnails in pixels. Options range from 2 to 100. (Default: 5)

Autoplay (Autoplay Menu)

Manage the automatic slideshow functionality.

  • Autoplay (autoplay): Enables or disables the automatic slideshow. (Default: false)
  • Progress Bar (progressBar): Shows or hides a progress bar at the top of the screen indicating the time until the next slide. (Default: true)
  • Force Autoplay (fourceAutoplay): If enabled, autoplay will resume even after manual user interaction. (Default: false)
  • Autoplay Controls (autoplayControls): Shows or hides the play/pause button in the toolbar. (Default: true)
  • Pause (pause): The time in milliseconds between each auto transition. Options range from 1000 to 10000. (Default: 5000)