jeans/arduino-ide
jeans/arduino-ide
1
0
Fork 0
mirror of https://github.com/arduino/arduino-ide.git synced 2025-04-19 12:57:17 +00:00
Code Issues Packages Projects Releases Wiki Activity
arduino-ide/docs/advanced-usage.md
per1234 b3b94948a3 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.
2023-04-20 11:11:24 -07:00

3.1 KiB
Raw Permalink Blame History

Advanced usage

Advanced settings

The Arduino IDE's primary settings are accessible via the File > Preferences menu item. These provide all the configuration capability required by the average user to develop sketches.

Arduino IDE has some additional settings which may be of interest to advanced users who want to do things such as fine tune the behavior of the application or increase log output while investigating a problem.

These advanced settings can be accessed by the following procedure:

  1. Press the Ctrl+Shift+P keyboard shortcut (Command+Shift+P for macOS users) to open the "Command Palette".
  2. Select the "Preferences: Open Settings (UI)" command from the menu.

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.

3rd party themes

Arduino IDE is built on the Eclipse Theia IDE framework, which allows it to use VS Code themes.

❗ 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.

Obtaining themes

A large selection of free VS Code themes are available from the Visual Studio Marketplace website:

  1. Find a theme you want to install:
    https://marketplace.visualstudio.com/search?target=VSCode&category=Themes
  2. Click on the theme to open its extension page.
  3. Click the "Download Extension" link on the right side of the extension page.
  4. Wait for the download to finish.

Installation

  1. If Arduino IDE is running, select File > Quit from the Arduino IDE menus to exit all windows.
  2. Create a folder named plugins under Arduino IDE's configuration folder:
    • Windows: 
      C:\Users\<username>\.arduinoIDE\
      (where <username> is your Windows username)
    • Linux: 
      ~/.arduinoIDE/
      ❗ The .arduinoIDE folder is hidden by default in the file manager and terminal.
    • macOS: 
      ~/.arduinoIDE/
      ❗ The .arduinoIDE folder is hidden by default. You can make it visible by pressing the Command+Shift+. keyboard shortcut.
  3. Copy the downloaded theme file to the plugins folder you created.
  4. Start Arduino IDE.
  5. Select File > Preferences from the Arduino IDE menus.
    The "Preferences" dialog will open.
  6. Select the name of the new theme from the "Theme" menu in the "Preferences" dialog.
  7. Click the "OK" button.

Uninstall

If you later decide you would like to remove a 3rd party theme you installed, it can be done by following these instructions:

  1. If Arduino IDE is running, select File > Quit from the Arduino IDE menus to exit all windows.
  2. Delete the theme's .vsix file from the location you installed it to.
    ⚠ Please be careful when deleting things from your computer. When in doubt, back up!