starred/terminal
1
0
Fork 0
mirror of https://github.com/microsoft/terminal.git synced 2026-02-03 21:25:34 +00:00
Code Issues 19.0k Packages Projects Releases 20 Wiki Activity

When backgroundImage is a symlink, experimental.useBackgroundImageForWindow causes the window to be transparent #17706

New Issue
Closed
opened 2026-01-31 05:50:56 +00:00 by claunia · 3 comments
claunia commented 2026-01-31 05:50:56 +00:00
Owner
Copy Link

Originally created by @zadjii-msft on GitHub (Jun 14, 2022).

Originally posted in https://github.com/microsoft/terminal/issues/13002#issuecomment-1146745489

  • When the background is set on profiles.defaults, it does not apply (the entire window is transparent and all backgrounds are dropped)

I just updated to 1.14.1452.0 today (Windows 11 Build 10.0.22621.1) and I'm still facing this issue. Could this be reopened? Or should I create a new issue?

image

My settings.json file: 
{
  "$help": "https://aka.ms/terminal-documentation",
  "$schema": "https://aka.ms/terminal-profiles-schema",
  "actions": [
    {
      "command": "toggleFocusMode",
      "keys": "shift+f11"
    },
    {
      "command": "toggleShaderEffects",
      "keys": "shift+f10"
    }
  ],
  "defaultProfile": "{574e775e-4f2a-5b96-ac1e-a2962a402336}",
  "initialCols": 90,
  "useAcrylicInTabRow": true,
  "theme": "light",
  "tabSwitcherMode": "mru",
  "experimental.useBackgroundImageForWindow": true,
  "profiles": {
    "defaults": {
      // "acrylicOpacity": 0.8,
      // "useAcrylic": true,
      // "experimental.pixelShaderPath": "%UserProfile%\\Pictures\\crt.hlsl",
      "antialiasingMode": "cleartype",
      "bellStyle": "none",
      "intenseTextStyle": "bold",
      "colorScheme": "some-light",
      "backgroundImage": "%UserProfile%\\Documents\\Wallpapers\\light.jpg",
      "backgroundImageOpacity": 0.2,
      "fontFace": "Consolas NF",
      "padding": "16, 16, 0, 16",
      "cursorShape": "filledBox"
    },
    "list": [
      {
        "colorScheme": "Bluloco Light",
        "font": {
          "face": "Delugia",
          "features": { "salt": 1 }
        },
        "tabColor": "#f9f9f9",
        "guid": "{574e775e-4f2a-5b96-ac1e-a2962a402336}"
      },
      {
        "guid": "{0caa0dad-35be-5f56-a8ff-afceeeaa6101}",
        "startingDirectory": ".",
        "name": "Command"
      },
      {
        "colorScheme": "Tango Light",
        "commandline": "fish",
        "guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}",
        "fontFace": "ClincherCode NF",
        "fontSize": 11,
        "icon": "%UserProfile%\\Pictures\\Icons\\fish.ico",
        "name": "Fish"
      },
      {
        "commandline": "nvim",
        "fontFace": "RecMonoSemicasual NF",
        "fontSize": 11,
        "colorScheme": "Tango Light",
        "padding": "16, 16, 16, 16",
        "scrollbarState": "hidden",
        "guid": "{9f80d682-c62b-40a3-a8f3-40996da15ef2}",
        "icon": "%UserProfile%\\Pictures\\Icons\\neovim.ico",
        "name": "Neovim"
      },
      {
        "commandline": "vifm .",
        "fontFace": "VictorMono NF",
        "fontSize": 11,
        "fontWeight": "semi-bold",
        "colorScheme": "Tango Light",
        "padding": "16, 16, 16, 16",
        "scrollbarState": "hidden",
        "guid": "{9f44d682-c62b-40a3-a8f3-40996da15ef2}",
        "icon": "%UserProfile%\\Pictures\\Icons\\vifm.ico",
        "name": "Vifm"
      },
      {
        "commandline": "gsudo btm",
        "fontFace": "OperatorMono NF",
        "fontSize": 11,
        "fontWeight": "semi-bold",
        "padding": "16, 16, 16, 16",
        "scrollbarState": "hidden",
        "guid": "{9f80d682-c78b-40a3-a8f3-40996da15ef2}",
        "icon": "%UserProfile%\\Pictures\\Icons\\top.ico",
        "name": "Bottom"
      },
      {
        "commandline": "spt",
        "fontFace": "FantasqueSansMono NF",
        "fontSize": 13,
        "colorScheme": "Bluloco Light",
        "tabColor": "#f9f9f9",
        "padding": "16, 16, 16, 16",
        "scrollbarState": "hidden",
        "guid": "{9f80d682-c62b-12a3-a8f3-40996da15ef2}",
        "icon": "%UserProfile%\\Pictures\\Icons\\spotify.ico",
        "name": "Spotify TUI"
      }
    ]
  },
  "schemes": [
    {
      "name": "Bluloco Dark",
      "background": "#0D1117",
      "black": "#4A505D",
      "blue": "#285BFF",
      "brightBlack": "#61697A",
      "brightBlue": "#199FFD",
      "brightCyan": "#50ACAE",
      "brightGreen": "#37BD58",
      "brightPurple": "#FC58F6",
      "brightRed": "#FC4A6D",
      "brightWhite": "#FFFFFF",
      "brightYellow": "#F6BE48",
      "cursorColor": "#FFFFFF",
      "cyan": "#366F9A",
      "foreground": "#ABB2BF",
      "green": "#23974A",
      "purple": "#8C62FD",
      "red": "#F81141",
      "selectionBackground": "#FFFFFF",
      "white": "#A1B8DF",
      "yellow": "#FD7E57"
    },
    {
      "name": "Bluloco Light",
      "background": "#f9f9f9",
      "black": "#373a41",
      "blue": "#275fe4",
      "brightBlack": "#676a77",
      "brightBlue": "#0099e1",
      "brightCyan": "#6d93bb",
      "brightGreen": "#3cbc66",
      "brightPurple": "#ce33c0",
      "brightRed": "#ff6480",
      "brightWhite": "#d3d3d3",
      "brightYellow": "#c5a332",
      "cursorColor": "#f32759",
      "cyan": "#27618d",
      "foreground": "#373a41",
      "green": "#23974a",
      "purple": "#823ff1",
      "red": "#d52753",
      "selectionBackground": "#111111",
      "white": "#babbc2",
      "yellow": "#df631c"
    },
    {
      "name": "some-light",
      "background": "#FFFFFF",
      "black": "#FFFFFF",
      "blue": "#3971ED",
      "brightBlack": "#B4B7B4",
      "brightBlue": "#969896",
      "brightCyan": "#E013D0",
      "brightGreen": "#E0E0E0",
      "brightPurple": "#282A2E",
      "brightRed": "#F96A38",
      "brightWhite": "#1D1F21",
      "brightYellow": "#C5C332",
      "cursorColor": "#000000",
      "cyan": "#149BDA",
      "foreground": "#373B41",
      "green": "#198844",
      "purple": "#A36AC7",
      "red": "#CC342B",
      "selectionBackground": "#000000",
      "white": "#373B41",
      "yellow": "#FBA922"
    }
  ]
}

The "%UserProfile%\\Documents" is actually a symlink. So far all of these produce the same result

    "%UserProfile%\\Documents\\Wallpapers\\light.jpg"
"C:\\Users\\<user>\\Documents\\Wallpapers\\light.jpg"
               "E:\\Documents\\Wallpapers\\light.jpg"   // actual path

I'm thinking the hey part is:

The "%UserProfile%\\Documents" is actually a symlink

Originally created by @zadjii-msft on GitHub (Jun 14, 2022). Originally posted in https://github.com/microsoft/terminal/issues/13002#issuecomment-1146745489 > > * [x] When the background is set on `profiles.defaults`, it does not apply (the entire window is transparent and all backgrounds are dropped) > > I just updated to 1.14.1452.0 today (Windows 11 Build 10.0.22621.1) and I'm still facing this issue. Could this be reopened? Or should I create a new issue? > > ![image](https://user-images.githubusercontent.com/46838874/172036715-c6c4a531-9351-4efb-84d7-e02bbdf56b2b.png) > > <details> > <summary> > My settings.json file: > </summary> > > ```jsonc > { > "$help": "https://aka.ms/terminal-documentation", > "$schema": "https://aka.ms/terminal-profiles-schema", > "actions": [ > { > "command": "toggleFocusMode", > "keys": "shift+f11" > }, > { > "command": "toggleShaderEffects", > "keys": "shift+f10" > } > ], > "defaultProfile": "{574e775e-4f2a-5b96-ac1e-a2962a402336}", > "initialCols": 90, > "useAcrylicInTabRow": true, > "theme": "light", > "tabSwitcherMode": "mru", > "experimental.useBackgroundImageForWindow": true, > "profiles": { > "defaults": { > // "acrylicOpacity": 0.8, > // "useAcrylic": true, > // "experimental.pixelShaderPath": "%UserProfile%\\Pictures\\crt.hlsl", > "antialiasingMode": "cleartype", > "bellStyle": "none", > "intenseTextStyle": "bold", > "colorScheme": "some-light", > "backgroundImage": "%UserProfile%\\Documents\\Wallpapers\\light.jpg", > "backgroundImageOpacity": 0.2, > "fontFace": "Consolas NF", > "padding": "16, 16, 0, 16", > "cursorShape": "filledBox" > }, > "list": [ > { > "colorScheme": "Bluloco Light", > "font": { > "face": "Delugia", > "features": { "salt": 1 } > }, > "tabColor": "#f9f9f9", > "guid": "{574e775e-4f2a-5b96-ac1e-a2962a402336}" > }, > { > "guid": "{0caa0dad-35be-5f56-a8ff-afceeeaa6101}", > "startingDirectory": ".", > "name": "Command" > }, > { > "colorScheme": "Tango Light", > "commandline": "fish", > "guid": "{17da3cac-b318-431e-8a3e-7fcdefe6d114}", > "fontFace": "ClincherCode NF", > "fontSize": 11, > "icon": "%UserProfile%\\Pictures\\Icons\\fish.ico", > "name": "Fish" > }, > { > "commandline": "nvim", > "fontFace": "RecMonoSemicasual NF", > "fontSize": 11, > "colorScheme": "Tango Light", > "padding": "16, 16, 16, 16", > "scrollbarState": "hidden", > "guid": "{9f80d682-c62b-40a3-a8f3-40996da15ef2}", > "icon": "%UserProfile%\\Pictures\\Icons\\neovim.ico", > "name": "Neovim" > }, > { > "commandline": "vifm .", > "fontFace": "VictorMono NF", > "fontSize": 11, > "fontWeight": "semi-bold", > "colorScheme": "Tango Light", > "padding": "16, 16, 16, 16", > "scrollbarState": "hidden", > "guid": "{9f44d682-c62b-40a3-a8f3-40996da15ef2}", > "icon": "%UserProfile%\\Pictures\\Icons\\vifm.ico", > "name": "Vifm" > }, > { > "commandline": "gsudo btm", > "fontFace": "OperatorMono NF", > "fontSize": 11, > "fontWeight": "semi-bold", > "padding": "16, 16, 16, 16", > "scrollbarState": "hidden", > "guid": "{9f80d682-c78b-40a3-a8f3-40996da15ef2}", > "icon": "%UserProfile%\\Pictures\\Icons\\top.ico", > "name": "Bottom" > }, > { > "commandline": "spt", > "fontFace": "FantasqueSansMono NF", > "fontSize": 13, > "colorScheme": "Bluloco Light", > "tabColor": "#f9f9f9", > "padding": "16, 16, 16, 16", > "scrollbarState": "hidden", > "guid": "{9f80d682-c62b-12a3-a8f3-40996da15ef2}", > "icon": "%UserProfile%\\Pictures\\Icons\\spotify.ico", > "name": "Spotify TUI" > } > ] > }, > "schemes": [ > { > "name": "Bluloco Dark", > "background": "#0D1117", > "black": "#4A505D", > "blue": "#285BFF", > "brightBlack": "#61697A", > "brightBlue": "#199FFD", > "brightCyan": "#50ACAE", > "brightGreen": "#37BD58", > "brightPurple": "#FC58F6", > "brightRed": "#FC4A6D", > "brightWhite": "#FFFFFF", > "brightYellow": "#F6BE48", > "cursorColor": "#FFFFFF", > "cyan": "#366F9A", > "foreground": "#ABB2BF", > "green": "#23974A", > "purple": "#8C62FD", > "red": "#F81141", > "selectionBackground": "#FFFFFF", > "white": "#A1B8DF", > "yellow": "#FD7E57" > }, > { > "name": "Bluloco Light", > "background": "#f9f9f9", > "black": "#373a41", > "blue": "#275fe4", > "brightBlack": "#676a77", > "brightBlue": "#0099e1", > "brightCyan": "#6d93bb", > "brightGreen": "#3cbc66", > "brightPurple": "#ce33c0", > "brightRed": "#ff6480", > "brightWhite": "#d3d3d3", > "brightYellow": "#c5a332", > "cursorColor": "#f32759", > "cyan": "#27618d", > "foreground": "#373a41", > "green": "#23974a", > "purple": "#823ff1", > "red": "#d52753", > "selectionBackground": "#111111", > "white": "#babbc2", > "yellow": "#df631c" > }, > { > "name": "some-light", > "background": "#FFFFFF", > "black": "#FFFFFF", > "blue": "#3971ED", > "brightBlack": "#B4B7B4", > "brightBlue": "#969896", > "brightCyan": "#E013D0", > "brightGreen": "#E0E0E0", > "brightPurple": "#282A2E", > "brightRed": "#F96A38", > "brightWhite": "#1D1F21", > "brightYellow": "#C5C332", > "cursorColor": "#000000", > "cyan": "#149BDA", > "foreground": "#373B41", > "green": "#198844", > "purple": "#A36AC7", > "red": "#CC342B", > "selectionBackground": "#000000", > "white": "#373B41", > "yellow": "#FBA922" > } > ] > } > ``` > > </details> > > The `"%UserProfile%\\Documents"` is actually a symlink. So far all of these produce the same result > ``` > "%UserProfile%\\Documents\\Wallpapers\\light.jpg" > "C:\\Users\\<user>\\Documents\\Wallpapers\\light.jpg" > "E:\\Documents\\Wallpapers\\light.jpg" // actual path > ``` > I'm thinking the hey part is: > **The `"%UserProfile%\\Documents"` is actually a symlink**
claunia commented 2026-01-31 05:50:59 +00:00
Author
Owner
Copy Link

@lhecker commented on GitHub (Aug 3, 2022):

I can't reproduce this issue in the latest main. What I did:

  • New-Item -ItemType SymbolicLink -Target R:\tmp tmp
    inside my Downloads directory
  • "experimental.useBackgroundImageForWindow": true
  • "backgroundImage": "%UserProfile%\\Downloads\\tmp\\foobar.jpg"

The background image loads as expected.

@lhecker commented on GitHub (Aug 3, 2022): I can't reproduce this issue in the latest `main`. What I did: * `New-Item -ItemType SymbolicLink -Target R:\tmp tmp` inside my Downloads directory * `"experimental.useBackgroundImageForWindow": true` * `"backgroundImage": "%UserProfile%\\Downloads\\tmp\\foobar.jpg"` The background image loads as expected.
claunia commented 2026-01-31 05:50:59 +00:00
Author
Owner
Copy Link

@zadjii-msft commented on GitHub (Aug 3, 2022):

Good enough for me, thanks for the confirmation!

@zadjii-msft commented on GitHub (Aug 3, 2022): Good enough for me, thanks for the confirmation!
claunia commented 2026-01-31 05:50:59 +00:00
Author
Owner
Copy Link

@mirai-toto commented on GitHub (Oct 11, 2022):

Same issue, it turns my terminal transparent.

@mirai-toto commented on GitHub (Oct 11, 2022): Same issue, it turns my terminal transparent.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
⛺ Reserved
A11yCO
A11yMAS
A11ySev1
A11ySev2
A11ySev3
A11yTTValidated
A11yUsable
A11yVoiceAccess
A11yWCAG
Area-Accessibility
Area-AtlasEngine
Area-AzureShell
Area-Build
Area-Build
Area-Chat
Area-CmdPal
Area-CodeHealth
Area-Commandline
Area-CookedRead
Area-DefApp
Area-Extensibility
Area-Fonts
Area-GroupPolicy
Area-i18n
Area-Input
Area-Interaction
Area-Interop
Area-Localization
Area-Output
Area-Performance
Area-Portable
Area-Quality
Area-Remoting
Area-Rendering
Area-Schema
Area-Server
Area-Settings
Area-SettingsUI
Area-ShellExtension
Area-ShellExtension
Area-ShellExtension
Area-Suggestions
Area-Suggestions
Area-TerminalConnection
Area-TerminalControl
Area-Theming
Area-UserInterface
Area-VT
Area-Windowing
Area-WPFControl
AutoMerge
Blocking-Ingestion
Culprit-Centennial
Culprit-WinUI
Disability-All
Disability-Blind
Disability-LowVision
Disability-Mobility
External-Blocked-WinUI3
Fixed
Gathering-Data
good first issue
HCL-E+D
HCL-WindowsTerminal
Help Wanted
Impact-Compatibility
Impact-Compliance
Impact-Correctness
Impact-Visual
In-PR
InclusionBacklog
InclusionBacklog-Windows TerminalWin32
InclusionCommitted-202206
Issue-Bug
Issue-Docs
Issue-Feature
Issue-Feature
Issue-Question
Issue-Samples
Issue-Scenario
Issue-Task
Needs-Attention
Needs-Author-Feedback
Needs-Bisect
Needs-Discussion
Needs-Repro
Needs-Tag-Fix
Needs-Tag-Fix
Needs-Triage
No-Recent-Activity
Priority-0
Priority-1
Priority-2
Priority-3
Product-Cmd.exe
Product-Colortool
Product-Colortool
Product-Colortool
Product-Conhost
Product-Conpty
Product-Meta
Product-Powershell
Product-Terminal
Product-WSL
pull-request
Mirrored from GitHub Pull Request
 Resolution-Answered
Resolution-By-Design
Resolution-Duplicate
Resolution-External
Resolution-Fix-Available
Resolution-Fix-Committed
Resolution-No-Repro
Resolution-Won't-Fix
Severity-Blocking
Severity-Crash
Severity-DataLoss
spam
this-will-be-a-breaking-change
Tracking-External
WindowsTerminal_Win32
Work-Item
zAskModeBug
zInbox-Bug
No Label Area-Settings Area-UserInterface Help Wanted Issue-Bug Needs-Tag-Fix Priority-3 Product-Terminal Resolution-No-Repro
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
claunia
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/terminal#17706
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?