Hi @mikedb. I think that file was the result of someone starting on creating an official dark theme for the IDE, but they never actually followed through to finish the project.
However, the Arduino community has created several themes. Maybe one of those will be to your liking. I'll share the list of all the themes I know of:
- How to change the theme (colors) in Arduino IDE 1.x
- Solarized Theme for Arduino IDE
- Arduino-Themes/hilukasz-Arduino_Theme/THEME_RES/Black & Red at master · AbhishekGhosh/Arduino-Themes · GitHub
- Arduino-Themes/hilukasz-Arduino_Theme/THEME_RES/Black & White at master · AbhishekGhosh/Arduino-Themes · GitHub
- Arduino-Themes/hilukasz-Arduino_Theme/THEME_RES/Original at master · AbhishekGhosh/Arduino-Themes · GitHub
- Arduino-Themes/hilukasz-Arduino_Theme/THEME_RES/Solarized at master · AbhishekGhosh/Arduino-Themes · GitHub
- GitHub - dracula/arduino-ide: 🧛🏻♂️ Dark theme for Arduino IDE
- GitHub - JairajJangle/Arduino-Black-Theme: Total Black theme for Arduino IDE
- GitHub - jeffThompson/DarkArduinoTheme: A dark theme for the Arduino IDE – no longer maintained :(
- GitHub - konrad91/OneDarkArduino: Dark theme for the Arduino IDE, inspired by One Dark Pro for VSCode by binaryify
- GitHub - PanGalacticTech/arduinoDarkTheme: Personalised Dark theme for Arduino IDE
- GitHub - per1234/ino-themes at Arduino-retro
- GitHub - per1234/ino-themes at processing-theme
- GitHub - per1234/ino-themes at themeDark-Jerware
- GitHub - per1234/ino-themes at themeDark-smilem
- GitHub - per1234/ino-themes at Wiring-theme
- GitHub - revolt-randy/Arduino-Gray-Theme: A gray theme for the arduino IDE
- GitHub - taunoe/arduino-dark-theme: Arduino dark theme!
- GitHub - technobly/MonokaiArduinoTheme
- GitHub - TridentTD/TridentArduinoTheme: Sublime-like Theme for ArduinoIDE
Custom Theme
If you decide you want to modify an existing theme, or make your own from scratch, you can find documentation of the theme system and a dummy library and sketch to facilitate testing here:
Installation
You have two options for installing themes to the sketchbook: direct installation or installation as "ZIP" files.
I'll provide instructions for both options below:
Direct installation
This installation option is best if you are going to use a single custom theme.
- Select File > Preferences... (or Arduino > Settings... for macOS users) from the Arduino IDE menus.
The "Preferences" dialog will open. - Take note of the path shown in the "Sketchbook location" field in the "Preferences" dialog.
This is the path to your "sketchbook folder". - Click the "Cancel" button.
- Select File > Quit (or Arduino > Quit Arduino for macOS users) from the Arduino IDE menus.
All Arduino IDE windows will close. - Open the sketchbook folder in your file manager.
If you are using Windows, this would be File Explorer. - Create a subfolder in your sketchbook folder named
theme. - Put the theme directly into the
themefolder you created.
The folder structure must look like this:
<sketchbook folder>
|_ theme
|_ syntax
| |_ etc...
|_ theme.txt
|_ etc...
"ZIP" file installation
This installation option is best if you want to switch between multiple custom themes, or if you are using a pre-made theme that supports this installation method.
The second option is to put the theme in a "ZIP" file, then put that in the theme subfolder of the sketchbook folder.
- Select File > Preferences... (or Arduino > Settings... for macOS users) from the Arduino IDE menus.
The "Preferences" dialog will open. - Take note of the path shown in the "Sketchbook location" field in the "Preferences" dialog.
This is the location of your "sketchbook folder". - Click the "Cancel" button.
- Select File > Quit (or Arduino > Quit Arduino for macOS users) from the Arduino IDE menus.
- Open the sketchbook folder in your file manager.
If you are using Windows, this would be File Explorer. - Create a subfolder in your sketchbook folder named
theme. - Put the theme "ZIP" file directly into the
themefolder you created. - Start Arduino IDE.
- Select File > Preferences... (or Arduino > Settings... for macOS users) from the Arduino IDE menus.
- Select the theme from the File > Preferences > Theme menu.
- Select File > Quit (or Arduino > Quit Arduino for macOS users) from the Arduino IDE menus.
All Arduino IDE windows will close. - Start Arduino IDE.
The theme you selected from the menu will now be active.
The folder and "ZIP" file structure must look like this:
<sketchbook folder>
|_ theme
|_ MyCoolTheme.zip
|_ syntax
| |_ etc...
|_ theme.txt
|_ etc...
There is a sort of tricky thing about this installation option. The theme must be in the root of the "ZIP" file, NOT in a subfolder. Some "ZIP" utilities make that difficult or even impossible (especially the macOS one), but a Windows user won't have any difficulty:
- Select all the files of the theme in Windows File Explorer.
- Right click on the selected files.
- Select Send to > Compressed (zipped) folder from the menu.
The awesome thing about this option is it allows you to have multiple themes installed (each in its own "ZIP" file). You can chose which one you prefer via the "Theme" menu of Arduino IDE's "Preferences" dialog. This menu will include the option to select the "Default theme", which is the one installed with the IDE.
Let's say you had two themes, one you wanted to show up in the Theme menu as "MyCoolTheme" and another you wanted to show up as "MyOtherCoolTheme", the folder structure should look like this:
<sketchbook folder>
|_ theme
|_ MyCoolTheme.zip
| |_ syntax
| | |_ etc...
| |_ theme.txt
| |_ etc...
|_ MyOtherCoolTheme.zip
|_ syntax
| |_ etc...
|_ theme.txt
|_ etc...