The Successor of iocave/Customize UI
This extension allows customization outside vscode scoop.
Unlike its predecessor, it does not come with default settings, allowing you complete control over customization.
Explore my personal settings for inspiration: View Settings
To use the Apc Customize UI++ extension:
- Disable similar extensions.
- Install/enable this extension. (Enabled automatically on the first install)
- Add the configurations below to your
user settings.json
file in vscode. - Start customizing!
To enable or disable this extension:
- Open Visual Studio Code.
- Go to the Command Palette by pressing Cmd+Shift+P on Mac or Ctrl+Shift+P on Windows.
- Type "Enable Apc extension" to enable or "Disable Apc extension" to disable the extension.
Run VSCode / VSCodium in Administrator mode before enabling or disabling the extension.
The extension will NOT work if VSCode / VSCodium cannot modify itself for specific reasons.
The possible reasons are:
- Code files are read-only, such as on a read-only file system.
- Code is not started with the necessary permissions to modify itself.
To fix this, you need to claim ownership of VSCode's installation directory.
For macOS, use the following command.
sudo chown -R $(whoami) $(which code)
For Linux, use this command instead.
sudo chown -R $(whoami) /usr/share/code
Note: Mac and Linux package managers might have a customized installation path.
Double-check that your path is correct.
In macOS, the typical paths are:
/Applications/Visual Studio Code.app/Contents/Resources/app/out
for VSCode/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/out
for VSCode Insiders/Applications/VSCodium.app/Contents/Resources/app/out
for VSCodium
In most Linux distributions, the typical path is /usr/share/code
On Arch Linux, the path can be:
/usr/lib/code/
/opt/visual-studio-code
This extension modifies specific files of Visual Studio Code / VSCodium.
Use at your own risk
If something goes wrong, the extension will create a backup of the original file. That's what the disable command is for.
The extension attempts to reapply patches with each VSCode / VSCodium update. If it doesn't happen automatically, try enabling the extension again.
Remember that this extension is still experimental, which means you may encounter some bugs while playing with it. Kindly report any bugs to the Github repository's issues section
Configures the Electron window
For detailed information on available configurations, refer to the Electron BrowserWindow documentation
Warning
Be careful with the "apc.electron" configuration, as incorrect parameters may disrupt VSCode or VSCodium startup.
Note
Here's what we covered. Choose a style you like, or create your own!
"apc.electron": {
"frame": false,
}
// requires "window.titleBarStyle": "native" to take effect
"apc.electron": {
"titleBarStyle": "hidden",
}
"apc.electron": {
"titleBarStyle": "hiddenInset",
"trafficLightPosition": {
"x": 7,
"y": 5
}
}
"apc.electron": {
"titleBarStyle": "hidden",
"titleBarOverlay": {
"color": "#2f3241",
"symbolColor": "#74b1be",
"height": 60
}
}
// Other panels must be transparent to use the `vibrancy` option
// Demo: https://github.com/drcika/apc-extension/blob/production/demo/vibrancy.settings.json
"apc.electron": {
"vibrancy": "ultra-dark"
}
"apc.electron": {
"backgroundColor": "rgba(123, 123, 123, 0.5)",
"frame": false,
"transparent": true,
"titleBarStyle": "hiddenInset",
"vibrancy": "ultra-dark",
"opacity": 0.98, // Range: 0-1 (0 means full transparency). If set, you won't see the element.
"visualEffectState": "active"
}
Note Multiple declarations of
apc.electron
will result in only the last declaration being applied, while the previous declarations are ignored.
Change the default font family for (any part of) vscode
By default, Provided by vscode
"editor.fontFamily": "Roboto Mono",
"editor.inlayHints.fontFamily": "Roboto Mono",
"editor.codeLensFontFamily": "Roboto Mono",
"terminal.integrated.fontFamily": "Roboto Mono",
"scm.inputFontFamily": "Roboto Mono",
"chat.editor.fontFamily": "Roboto Mono",
"debug.console.fontFamily": "Roboto Mono",
"notebook.output.fontFamily": "Roboto Mono",
"markdown.preview.fontFamily": "Roboto Mono",
Replace the Default Font Family for extension-editor
Install the desired font on your computer. Restart required.
"apc.font.family": "Roboto Mono",
"apc.monospace.font.family": "Roboto Mono",
Replace the Default Font Family for Each Part individually
"apc.parts.font.family": {
"sidebar": "Roboto Mono",
"titlebar": "Roboto Mono",
"activityBar": "Roboto Mono",
"panel": "Roboto Mono",
"tabs": "Roboto Mono",
"statusbar": "Roboto Mono",
"settings-body": "Roboto Mono",
"extension-editor": "Roboto Mono", // Required: Expected font installation on machine and Application restart
"monaco-menu": "Roboto Mono"
},
Import CSS and JavaScript files to customize the look and feel of VS Code
Real-time monitoring of CSS files, no need to restart the application
"apc.imports": [
"/Users/some/path/style.css",
"/Users/some/path/script.js",
"/C:/Users/path/style.css", // for windows
// or see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/link
// Local file imports like this are not watched in real time
{
"rel": "stylesheet",
"href": "https://fonts.googleapis.com/css?family=Sofia"
},
// or see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script
{
"async":"async",
"type":"text/javascript",
"src": "https://some/path.js"
}
]
Override the default CSS of VS Code
"apc.stylesheet": {
".monaco-workbench .part.editor>.content .editor-group-container>.title div.tabs-container": "border-radius: 5px; font-family: 'Times New Roman', Times, serif;"
"body": {
// Other panels should be transparent. see "workbench.colorCustomizations"
"background-image": "url(/Users/aleksandarpopovic/imgs/19.png), linear-gradient(to top,rgba(0, 0, 0, 0.6), rgba(0, 0, 0, 0.2))",
"background-size": "cover",
"background-blend-mode": "multiply",
"background-repeat": "no-repeat"
},
"workbench.colorCustomizations": {
"sideBar.background": "#00000000", // transparent
"editor.background": "#00000000"
...etc
}
}
Adjust the height and font size of the header bar
"apc.header": {
"height": number,
"fontSize": number
}
Set the position and size of the activity bar
top
: above sidebarbottom
: below sidebar- Default position if not specified
"apc.activityBar": {
"position": "bottom" | "top",
"size": number // height when positioned at top/bottom, width in the default position
}
Define the height and font size of the sidebar title bar
"apc.sidebar.titlebar": {
"height": number,
"fontSize": number
}
Specify the height and font size of list rows
"apc.listRow": {
"height": number,
"fontSize": number
}
Enable a compact menu bar by relocating the Menu Bar to the Activity Bar
"apc.menubar.compact": true
Set the position and height of the status bar
"apc.statusBar": {
"position": "top" | "bottom" | "editor-top" | "editor-bottom",
"height": number,
"fontSize": number
}
Inject custom CSS into iframes (Notebook, Extension view, etc)
Warning
On vscode startup, if there is a tab open with an iframe, you will need to reopen that tab for the styles to be applied.
"apc.iframe.style": "/Users/path/style.css",
"apc.iframe.style": "C:\\Users\\path\\style.css", // windows
"apc.iframe.style": {
"h1": "color: red; font-size: 2rem;"
}
"apc.iframe.style": {
"h1": {
"color": "red",
"font-size": "2rem;"
}
}
This extension is specifically designed for configuring Electron and Visual Studio Code.
I have not developed anything or provided support for potential bugs. My role is to provide a bridge for configuring Electron/VS Code.
Inspired by