Spotify Tweaks

• Formerly known as CEF/Spotify Titlebar Enabler
• Force native frames and title bars for CEF apps, such as Spotify
• Only works on apps using native CEF top-level windows
  • Steam uses SDL for its top-level windows (except DevTools), so this mod doesn't work with Steam
• Electron apps are NOT supported! Just patch asar to override frame: false to true in BrowserWindow creation
• Try my Titlebar for Everyone mod for other apps

Features for Spotify

• Enable native frames and title bars on the main window
• Enable native frames and title bars on other windows, including Miniplayer, DevTools, etc.
• Hide the menu button or Spotify's custom window controls
• Make Spotify's custom window controls transparent
• Ignore the minimum window size set by Spotify
• Change the playback speed
• Enable transparent rendering to make the transparent parts of the web content transparent
• Disable forced dark mode to prevent Spotify from forcing dark mode on the CEF UI & web contents
• Force enable Chrome extension support
• Block automatic updates
• Use the settings tab on the mod details page to configure the features

Notes

• Supported CEF versions: 90.4 to 143
  • This mod won't work with versions before 90.4
  • Newer versions may work, but are not tested. Some features, such as the JS API, are disabled on untested versions by default to prevent possible crashes, and transparent rendering may not work properly as well
  • A variant of this mod, which uses copy-pasted CEF structs instead of hardcoded offsets, is available here
  • Copy the required structs/definitions from your wanted CEF version (available here) and paste them into the above variant to calculate the offsets
  • Testing with cefclient: cefclient.exe --use-views --hide-frame --hide-controls
• Supported Spotify versions: 1.1.60 to 1.2.80 (newer versions may work)
• Spotify notes:
  • Old releases are available here
  • 1.1.60-1.1.67: Use SpotifyNoControl to remove the window controls
  • 1.1.68-1.1.70: Window control hiding doesn't work
  • 1.1.71: First version to support the Ignore minimum window size option
  • 1.2.7: First version to use Library X UI by default
  • 1.2.13: Last version to have the old UI
  • 1.2.26: First version to support Chrome runtime (disabled by default)
  • 1.2.45: Last version to support disabling the global navbar
  • 1.2.47: Chrome runtime is always enabled since this version
  • Try the noControls Spicetify extension to remove the space left by the custom window controls
  • Or try my WMPotify theme for Windows Media Player 11-like look
  • Enable Chrome runtime to get a proper window icon. Use --enable-chrome-runtime flag or put app.enable-chrome-runtime=true in %appdata%\Spotify\prefs
• Notes for transparent Spotify windows
  • When the Enable native frames and title bars on the main window option is disabled, this mod is not compatible with the Translucent Windows Windhawk mod older than version 1.5
  • Please update the mod to 1.5+, or use MicaForEveryone instead, when the native frames are disabled
• Notes for Spicetify extension/theme developers
  • This mod exposes a JavaScript API that can be used to interact with the main window and this mod
  • The API is available with window._getSpotifyModule('ctewh') (1.2.4-1.2.55) or window.cancelEsperantoCall('ctewh') (1.2.33-latest)
  • Use (window.cancelEsperantoCall || window._getSpotifyModule)('ctewh').query() to get various information about the window and the mod
  • Various functions are available in the object returned by _getSpotifyModule('ctewh') or cancelEsperantoCall('ctewh')
  • See here for a simple example of how to use the functions
  • This API is only available on Spotify 1.2.4 and above, and only if the mod is enabled before Spotify starts
  • The API is disabled by default on untested CEF versions

JavaScript API Documentation

• All functions are synchronous and do not have a return value, with the exception of query().
• May throw exceptions when called with invalid arguments or when an internal error occurs.
• Some functions may not exist in specific conditions (e.g., Spotify version, architecture, mod version, etc.). Check for the existence of the function before calling it to avoid exceptions.
• The following are functions and properties available in the object returned by _getSpotifyModule('ctewh') or cancelEsperantoCall('ctewh'):
• query(): Queries various information about the main window and the mod settings. Returns an object with the following properties:
  • isMaximized: Whether the main window is maximized
  • isTopMost: Whether the main window is always on top
  • isLayered: Whether the main window is layered
  • isTransparent: Whether the main window is in transparent mode (by setTransparent())
  • isThemingEnabled: Whether visual styles are enabled
  • isDwmEnabled: Whether DWM is enabled. Also returns false when a basic themer has been applied
  • hwAccelerated: Whether hardware acceleration is enabled
  • minWidth: The minimum width of the main window. Returns -1 if no minimum width is set with setMinSize()
  • minHeight: The minimum height of the main window. Returns -1 if no minimum height is set with setMinSize()
  • titleLocked: Whether the title bar text is locked (by lockTitle())
  • dpi: The DPI of the main window. 96 for 100%, 120 for 125%, etc.
  • playbackSpeed: The current playback speed as a decimal number (by setPlaybackSpeed())
  • speedModSupported: Whether playback speed modification is supported
  • immediateSpeedChange: Whether playback speed changes are applied immediately
  • Various mod settings as boolean properties (described below)
• extendFrame(int: left, int: right, int: top, int: bottom)
  • Extends the window frame into the client area by the given number of pixels on each side. Use -1, -1, -1, -1 to extend to the entire window.
• minimize()
  • Minimizes the main window.
• maximizeRestore()
  • Maximizes or restores the main window depending on its current state.
• close()
  • Closes the main window. Respects the 'minimize to tray' setting, unlike window.close().
• focus()
  • Brings the main window to the foreground and gives it focus.
• setLayered(bool: layered, int?: opacity, string?: colorKey)
  • Sets whether the main window is layered (WS_EX_LAYERED).
  • opacity is an optional integer parameter (0-255) that sets the opacity of the window when layered is true.
  • colorKey is an optional string parameter that sets the color key for transparency when layered is true. Must be a six-digit hexadecimal RGB value (e.g., "FF00FF" for magenta).
• setTransparent(bool: transparent)
  • Only available in mod version 1.6 and above; missing in older versions
  • Enables or disables transparent mode. Only works when the transparent rendering option is enabled, and native frames are disabled.
• setBackdrop(string: type)
  • Sets the backdrop type of the main window. Only works on Windows 11 when native frames are enabled.
  • type can be one of the following values:
    • "none": No backdrop (Only supported on mod version 1.6 and above; will throw an exception on older versions)
    • "mica": Mica backdrop
    • "acrylic": Acrylic backdrop
    • "tabbed": Tabbed backdrop
• resizeTo(int: width, int: height)
  • Resizes the main window to the given width and height in pixels.
• setMinSize(int: minWidth, int: minHeight)
  • Sets the minimum size of the main window to the given width and height in pixels.
• setTopMost(bool: topMost)
  • Sets whether the main window is always on top.
• setTitle(string: title)
  • Sets the title bar text of the main window. Ignores the title lock state.
• lockTitle(bool: lock)
  • Prevents the Spotify client from changing the title bar text when lock is true.
• openSpotifyMenu()
  • Opens the Spotify menu. Equivalent to pressing the Alt key. Does nothing if the menu button is hidden in the mod settings.
• setPlaybackSpeed(float: speed)
  • Sets the playback speed to the given decimal number. 1.0 represents normal speed.
  • Only available on an x64 version of the Spotify client between 1.2.36 and 1.2.66.
• initialOptions: An object containing the initial mod settings when Spotify was started.
• version: The mod version as a string.
• Mod settings (boolean properties):
  • showframe: Enable native frames and title bars on the main window
  • showframeonothers: Enable native frames and title bars on other windows
  • showmenu: Show the menu button
  • showcontrols: Show Spotify's custom window controls
  • transparentcontrols: Make Spotify's custom window controls transparent
  • ignoreminsize: Ignore minimum window size
  • transparentrendering: Enable transparent rendering
  • noforceddarkmode: Disable forced dark mode
  • forceextensions: Force enable Chrome extensions
  • blockupdates: Block automatic updates
  • allowuntested: (Advanced) Use unsafe methods on untested CEF versions