iocave / customize-ui

UI Customization plugin for vscode
MIT License
527 stars 36 forks source link

Customize UI README

This experimental extension allows customizing VSCode user interface beyond what's normally possible, such as

Preview

Note: As of VSCode 1.74, this extension does not work, and will cause VSCode to crash. You can remain on 1.73.1 or prior to continue to use this extension. If you wish to move to a newer version of VSCode, you'll want to uninstall this extension before updating.

Supported configuration options

customizeUI.activityBar

When set to top, activity bar will be positioned over the sidebar.

When set to bottom, activity bar will be positioned below the sidebar.

When set to wide, activity bar will match the width of traffic lights (for macOS inline menu bar).

customizeUI.moveStatusbar

When enabled move the statusbar below the panel (Terminal, Output, Problems). Useful to gain some space for the sidebar.

WARNING: don't works well if panel is set to left or right,
this setting was added to be able to disable the default behavior.

customizeUI.activityBarHideSettings

When enabled hides the Settings (and Accounts) icon in horizontal (bottom) activity bar. Useful when the activity bar gets too crowded.

customizeUI.titleBar

macOS only. Setting this hides the titlebar, and the tab bar becomes draggable.

Note that this setting requires that "window.titleBarStyle": "native" is also set.

customizeUI.fontSizeMap

Mapping from hardcoded VSCode font size to custom font size. For example the following will change 13px and 12px UI fonts to 11px, which fixes huge sidebar font on OS X.

    "customizeUI.fontSizeMap": {
        "13px": "11px",
        "12px": "11px",
        "window-title": "12px", // Window title font when using custom titlebar
        "tab-title": "12px",    // Used for editor tab titles
        "monospace": "10.5px",  // Used for monospace fonts in user interface
        "menu": "13px",         // Used for menu items (windows only)
    }

customizeUI.listRowHeight

Changes row height in various list and trees in user inteface. 22 by default

    "customizeUI.listRowHeight": 20, // shrink rows to match XCode

customizeUI.font.regular and customizeUI.font.monospace

Allows changing font face for regular and monospace user interface fonts

    "customizeUI.font.regular": "Helvetica Nueve",
    "customizeUI.font.monospace": "Fira Code",

customizeUI.stylesheet

Allow adding custom stylesheet rules. It is in form of a map where selectors are keys.

    "customizeUI.stylesheet": {
        ".search-view .search-widgets-container": "padding-top: 0px !important",
        ".suggest-input-container": "padding: 3px 4px 3px !important;"
    }

How does it work

Customize UI relies on the Monkey Patch Extension to inject custom javascript in VSCode. After installation you should be prompted to enable Monkey Patch. You can always trigger this manually by invoking the "Enable Monkey Patch" command.

Credits

Inline titlebar inspired by Jürg Lehni's Titlebar-less VSCode extension.

Coffee

If you like this this extension, consider buying me a coffee. Thank you!