DisplayFusion Command Line Tool (displayfusioncommand.exe)

Using DisplayFusionCommand.exe (version 3.3+) you can control DisplayFusion from an external program or command prompt. DisplayFusionCommand.exe is located in the DisplayFusion installation folder (C:\Program Files\DisplayFusion) by default. Syntax and examples are below.

-CloseAll

Closes all DisplayFusion instances with no prompts.

-WallpaperLoadProfile "profile name"

Loads the Wallpaper Profile named in the quotes. (v3.4.0+)

-WallpaperNextImage

Loads the next random Wallpaper image, if random images are enabled for any of the monitors. (v3.4.0+)

-WallpaperSlideshowPause

Pauses wallpaper changes, if random images are enabled for any of the monitors. (v10.1.2+)

-WallpaperSlideshowResume

Resumes wallpaper changes when paused, if random images are enabled for any of the monitors. (v10.1.2+)

-WallpaperSlideshowToggle

Toggles wallpaper changes, if random images are enabled for any of the monitors. (v10.1.2+)

-WallpaperApply

Re-applies the current Wallpaper Profile. (v8.0+)

-WallpaperFeatureEnable

Enables the DisplayFusion Desktop Wallpaper feature. (v10.1.2+)

-WallpaperFeatureDisable

Disables the DisplayFusion Desktop Wallpaper feature. The wallpaper will be changed to a solid black background. (v10.1.2+)

-WallpaperFeatureToggle

Enables/disables the DisplayFusion Desktop Wallpaper feature. When disabling, the wallpaper will be changed to a solid black background. (v10.1.2+)

-WallpaperAnimationsToggle

Pauses/resumes animated wallpaper sources (My Videos, Website). (v8.0+)

-applicationhooksload

Forces DisplayFusion to load the global application hooks. (v3.4.0+)

-applicationhooksunload

Forces DisplayFusion to unload the global application hooks. (v3.4.0+)

-windowwallpaper

Opens the DisplayFusion Wallpaper window. (v3.4.0+)

-windowsettings

Opens the DisplayFusion Settings window. (v3.4.0+)

-windowmonitorconfig

Opens the DisplayFusion Monitor Configuration window. (v3.4.0+)

-windowscreensaversettings

Opens the DisplayFusion Screen Saver Settings window. (v3.4.0+)

-monitorloadprofile "profile name"

Loads the Monitor Profile named in the quotes. (v3.4.1+)

-functionrun "hotkey name"

Runs the specified DisplayFusion HotKey. (v4.0+)

-desktopiconsave "profile name"

Saves the current Desktop Icon Layout as a profile. Specifying the name of an existing profile will prompt to overwrite. (v4.0+)

-desktopiconload "profile name"

Loads the specified Desktop Icon Layout Profile. (v4.0+)

-windowpositionprofilesave "profile name"

Saves the currently opened windows as a Window Position Profile Profile. Specifying the name of an existing profile will prompt to overwrite. (v9.2+)

-windowpositionprofileload "profile name"

Loads the specified Window Position Profile Profile. (v9.2+)

-settingsbackup "file path"

Saves the current DisplayFusion Settings to a .reg file. If you don't specify a file name, the backup will be created in the default location of %USERPROFILE%\Documents\DisplayFusion Backups. (v5.1+)

Examples:

DisplayFusionCommand.exe -closeall

- Closes all DisplayFusion instances.

DisplayFusionCommand.exe -wallpaperloadprofile "Horse Pictures"

- Loads a pre-configured Wallpaper profile named "Horse Pictures"

DisplayFusionCommand.exe -wallpaperloadprofile "Horse Pictures" -wallpapernextimage

- Loads a Wallpaper profile, then loads the next random image

DisplayFusionCommand.exe -functionrun "Start Screen Saver"

- Runs the built-in DisplayFusion Function that starts the Screen Saver

DisplayFusionCommand.exe -settingsbackup "C:\Backups\DisplayFusionBackup.reg"

- Saves the current DisplayFusion Settings to C:\Backups\DisplayFusionBackup.reg

Aug 13, 2014 (modified Aug 12, 2022) • #1

Delmain

4 discussion posts

For the commands here that ask you for confirmation, is there a "Force Confirm" flag we can send, like

DisplayFusionCommand.exe -windowpositionprofilesave "ABCD" -y

or something of that nature? I'd like to use this in a batch command but all it does is pop-up the confirmation dialog and I have to manually click "Yes".

Mar 3, 2019 • #2

There are some settings in the Advanced Settings window for disabling some of the confirmation prompts. We're planning to add more for the other types (Window Position Profiles Save/Load) as well.

Mar 5, 2019 • #3

Linfeng Li948660

15 discussion posts

Quote:

There are some settings in the Advanced Settings window for disabling some of the confirmation prompts. We're planning to add more for the other types (Window Position Profiles Save/Load) as well.

Any update for CLI options to save/load Window Position Profiles? Also, for Version 9.6.1 and 9.6.2 (Beta 1), the simple -closeall flag does not seem to wrok: the tray-icon is still there after executing the following in Command Prompt:

"C:\Program Files (x86)\DisplayFusion\DisplayFusion.exe" -closeall

Upon inspecting through Task Manager, a DisplayFusion process seems to have been triggered by Command Prompt, but the tray-icon remains alive after the the CommandPrompt-DisplayFusion process dies out. Using Command Prompt to open DisplayFusion works (ended up with populating the tray-icon), but the -closeall flag won't close as well.

Mar 15, 2020 • #4

You should already be able to use the CLI to save/load window position profiles, was there something else you're looking for there? Thanks!

Mar 19, 2020 • #5

Linfeng Li948660

15 discussion posts

Quote:

You should already be able to use the CLI to save/load window position profiles, was there something else you're looking for there? Thanks!

My bad. Yes, I see the Windows Position Profiles are avialable through CLI.

Yet, on my machines, these CLI flags are not working as intended however I tried: through Command Prompt, through Run-Window (Win+R), or through AHK scripts launched with Admin rights. Please let me know if I should open a support ticket for further debugging.

Mar 19, 2020 • #6

The -closeall command usually takes a bit because it tells DisplayFusion to gracefully shutdown. On my machine it takes about 10-15 seconds.

Re: the Window Position Profile paremeters, could you send me the commands you're trying so I can test them out here?

Mar 20, 2020 • #7

Delmain

4 discussion posts

E: Nevermind

Mar 20, 2020 (modified Mar 20, 2020) • #8

EarthlingZero

4 discussion posts

Quote:

There are some settings in the Advanced Settings window for disabling some of the confirmation prompts. We're planning to add more for the other types (Window Position Profiles Save/Load) as well.

-desktopiconsave "profile name"
Saves the current Desktop Icon Layout as a profile. Specifying the name of an existing profile will prompt to overwrite. (v4.0+)

Please add option to overwrite profile with current desktop icon layout without a prompt popping up as you did for windows position profiles. Thanks!

May 19, 2020 (modified May 19, 2020) • #9

In the DisplayFusion Settings > Advanced Settings window, enable this setting:

Desktop Icons: Don't Show Overwrite Confirmation when Saving

Hope that helps!

May 20, 2020 • #10

EarthlingZero

4 discussion posts

It does. Thank you!

May 21, 2020 • #11

Linfeng Li948660

15 discussion posts

Quote:

In the DisplayFusion Settings > Advanced Settings window, enable this setting:

Desktop Icons: Don't Show Overwrite Confirmation when Saving

Hope that helps!

Glad to find a similar Overwrite option also for "Window Position Profiles". In Advanced Settings window, searching for Overwrite reveals it. The name is "Disable Overwrite Confirmation Prompt" under the Window Position Profiles section. Thanks a lot! :laugh:

Jun 28, 2020 • #12

-wallpaperloadprofile

does not work as intended.
When I change the wallpaper profile with the GUI, the lock screen wallpaper changes too. (This is the behavior I want)
With command line, it changes the lock screen wallpaper to the previous profile's wallpaper.
Example:

DisplayFusionCommand.exe -wallpaperloadprofile "Profile 1"

Desktop wallpaper is "Profile 1" but lock screen wallpaper is not.
---

DisplayFusionCommand.exe -wallpaperloadprofile "Profile 2"

Desktop wallpaper is "Profile 2" but lock screen wallpaper is "Profile 1".
---

DisplayFusionCommand.exe -wallpaperloadprofile "Profile 1"

Desktop wallpaper is "Profile 1" but lock screen wallpaper is "Profile 2".
---

-applywindowslockscreen

does not work at all.

Dec 26, 2021 (modified Dec 26, 2021) • #13

@Doğan: If you change the wallpaper profile using the DisplayFusion tray menu, does the lock screen update correctly?

Jan 13, 2022 • #14

I am sorry, I edited this comment and posted a new reply, the email you may have gotten had an incorrect reply, so I want to correct it with my second reply. Please delete this one if you can.

Jan 14, 2022 (modified Jan 14, 2022) • #15

Quote:

@Doğan: If you change the wallpaper profile using the DisplayFusion tray menu, does the lock screen update correctly?

No unfortunately, it behaves exactly like the command line utility.

In detail:
When I right click the tray menu, "Desktop Wallpaper Settings > Wallpaper Profiles" and select a new profile, it works just like the command like utility. It does not change the lock screen wallpaper. It works like the behavior I mentioned in my previous post.

E.g.
I select "Profile 2" from the tray menu.
Desktop wallpaper becomes the wallpaper of "Profile 2".
Lock screen wallpaper becomes the wallpaper of "Profile 1" (previous profile).

I can try to record a video if it will help you debug the problem.

Jan 14, 2022 (modified Jan 14, 2022) • #16

Ok that's good for now, thanks! I will pass this back to our developers again and we'll keep you posted when we have more news.

Jan 14, 2022 • #17

whoiskevinrich

5 discussion posts

Is there a command to list wallpaperprofiles? Looking to script a CLI that can offer a menu.

Jan 15, 2022 • #18

@Doğan: We were able to confirm that issue here and have added it to our list to fix up

@whoiskevinrich: There isn't, but it is possible to do with DisplayFusion scripted functions. See this one for example: Select a Random Wallpaper Profile with Filter

Jan 19, 2022 • #19

@Doğan This issue should be fixed up in the latest beta, available here: https://www.displayfusion.com/Download/Beta. Please let me know if you still run into any trouble after updating.

Thanks!

Mar 30, 2022 • #20

Quote:

@Doğan This issue should be fixed up in the latest beta, available here: https://www.displayfusion.com/Download/Beta. Please let me know if you still run into any trouble after updating.

Hello, I downloaded the latest version (version 10 Beta 14), it still does not update Lock Screen wallpaper.

Command I use:

Code
Copy
Select All

"C:\Program Files (x86)\DisplayFusion\DisplayFusionCommand.exe" -wallpaperloadprofile "Local Dark"

Code
Copy
Select All

Edition         Windows 10 Pro
Version         21H2
Installed on    2022.01.31
OS build        19044.1526
Experience      Windows Feature Experience Pack 120.2212.4170.0

• Attachment [protected]: v10 beta 14.png [21,271 bytes]

Mar 30, 2022 (modified Mar 30, 2022) • #21

Ok, strange! This was definitely working when we were testing internal builds, but I can confirm that it's still broken in the public build. I've re-opened the ticket for our devs to have another look at.

Thanks!

Apr 1, 2022 • #22

I downloaded the latest version (version 10 Beta 15).
The command line program changes the lock screen wallpaper now.
Thank you for your help Keith and Owen! 🙏

Apr 10, 2022 • #23

Glad to hear, thanks for the follow-up!

Apr 11, 2022 • #24

Was this helpful?

(5)

(-)