nathanbuchar / electron-settings

📝 A simple persistent user settings framework for Electron.

Electron Settings

A simple and robust settings management library for Electron.

Born from Atom's original internal configuration manager and the settings manager of choice for Electron's own API Demos app, Electron Settings allows you to persist user settings and other data between app loads simply and easily.

Install

npm install electron-settings

Demo

import settings from 'electron-settings';

await settings.set('color', {
  name: 'cerulean',
  code: {
    rgb: [0, 179, 230],
    hex: '#003BE6'
  }
});

await settings.get('color.name');
// => "cerulean"

await settings.get('color.code.rgb[1]');
// => 179

⚠ For Electron v10+, if you want to use electron-settings within a browser window, be sure to set the enableRemoteModule web preference to true. Otherwise you might get the error Cannot read property 'app' of undefined. See #133 for more info.

new BrowserWindow({
  webPreferences: {
    enableRemoteModule: true // <-- Add me
  }
});

API Docs

API docs and can be found at electron-settings.js.org.

---

Having trouble? Get help on Gitter.