Skip to content

Commit b3b9494

Browse files
committed
Document 3rd party theme installation in "Advanced Usage"
Arduino IDE comes with a selection of officially maintained and supported built-in themes: - Light - Dark - High Contrast Although these three should be sufficient for most users, some users may have other requirements or preferences for the Arduino IDE UI theming. Fortunately, because it is built on the Eclipse Theia IDE framework, Arduino IDE supports VS Code theme extensions. This makes a large variety of 3rd party themes available to the user, and even the ability to create custom themes. Instructions for installing VS Code theme extensions are here added to the "Advanced Usage" document hosted in the repository.
1 parent 80afd38 commit b3b9494

File tree

1 file changed

+54
-0
lines changed

1 file changed

+54
-0
lines changed

Diff for: docs/advanced-usage.md

+54
Original file line numberDiff line numberDiff line change
@@ -12,3 +12,57 @@ These advanced settings can be accessed by the following procedure:
1212
1. Select the "**Preferences: Open Settings (UI)**" command from the menu.
1313

1414
This will open a "**Preferences**" view in the IDE. Once you are finished adjusting settings, it can be closed by clicking the **X** icon on the "**Preferences**" tab.
15+
16+
## 3rd party themes
17+
18+
Arduino IDE is built on the [**Eclipse Theia** IDE framework](https://theia-ide.org/), which allows it to use [**VS Code**](https://code.visualstudio.com/) themes.
19+
20+
---
21+
22+
❗ Arduino does not maintain or provide support for individual 3rd party themes. If you experience problems with a theme, report it to the theme's maintainer.
23+
24+
---
25+
26+
### Obtaining themes
27+
28+
A large selection of free VS Code themes are available from the **Visual Studio Marketplace** website:
29+
30+
1. Find a theme you want to install: <br />
31+
https://marketplace.visualstudio.com/search?target=VSCode&category=Themes
32+
1. Click on the theme to open its extension page.
33+
1. Click the "**Download Extension**" link on the right side of the extension page.
34+
1. Wait for the download to finish.
35+
36+
### Installation
37+
38+
1. If Arduino IDE is running, select **File > Quit** from the Arduino IDE menus to exit all windows.
39+
1. Create a folder named `plugins` under Arduino IDE's configuration folder:
40+
- **Windows:**
41+
```text
42+
C:\Users\<username>\.arduinoIDE\
43+
```
44+
(where `<username>` is your Windows username)
45+
- **Linux:**
46+
```text
47+
~/.arduinoIDE/
48+
```
49+
❗ The `.arduinoIDE` folder is hidden by default in the file manager and terminal.
50+
- **macOS:**
51+
```text
52+
~/.arduinoIDE/
53+
```
54+
❗ The `.arduinoIDE` folder is hidden by default. You can make it visible by pressing the <kbd>**Command**</kbd>+<kbd>**Shift**</kbd>+<kbd>**.**</kbd> keyboard shortcut.
55+
1. Copy the downloaded theme file to the `plugins` folder you created.
56+
1. Start Arduino IDE.
57+
1. Select **File > Preferences** from the Arduino IDE menus. <br />
58+
The "**Preferences**" dialog will open.
59+
1. Select the name of the new theme from the "**Theme**" menu in the "**Preferences**" dialog.
60+
1. Click the "**OK**" button.
61+
62+
### Uninstall
63+
64+
If you later decide you would like to remove a 3rd party theme you installed, it can be done by following these instructions:
65+
66+
1. If Arduino IDE is running, select **File > Quit** from the Arduino IDE menus to exit all windows.
67+
1. Delete the theme's `.vsix` file from [the location you installed it to](#installation). <br />
68+
⚠ Please be careful when deleting things from your computer. When in doubt, back up!

0 commit comments

Comments
 (0)