Docs

Configuration Reference

Moose Browser can be customized through a JSON configuration file. To edit your settings, open the Settings menu and select “Open settings.json”. This guide covers all available options.

Complete Example

{
  "layout": {
    "default": "grid",
    "tiles": 4,
    "custom": {
      "three-up": {
        "tiles": [
          [
            { "width": 60, "height": 100 },
            { "width": 40, "height": 50 }
          ],
          [
            { "width": 40, "height": 50 }
          ]
        ]
      }
    }
  },
  "profiles": [
    { "id": 1, "label": "Personal", "color": "#43A047" },
    { "id": 2, "label": "Work", "color": "#1E88E5" }
  ],
  "search": {
    "url": "https://www.google.com/search?q=%s"
  },
  "history": {
    "maxEntries": 1000
  },
  "theme": "auto"
}

---

Layout

Controls how browser tiles are arranged.

Property	Type	Default	Description
default	string	"grid"	Default layout: "grid", "split-horizontal", "split-vertical", or a key from custom
tiles	number	4	Default number of tiles in grid layout
custom	object	{}	Custom layout definitions

Custom Layouts

You can define custom tile arrangements. Each custom layout has a name and a tiles matrix where each inner array represents a row. Tiles use width and height as percentages:

{
  "layout": {
    "custom": {
      "three-up": {
        "tiles": [
          [
            { "width": 60, "height": 100 },
            { "width": 40, "height": 50 }
          ],
          [
            { "width": 40, "height": 50 }
          ]
        ]
      }
    }
  }
}

In this example, "three-up" defines two rows. The first row contains two tiles: one at 60% width/100% height and another at 40% width/50% height. The second row has one tile at 40% width/50% height, which stacks below the second tile of the first row.

---

Profiles

Define browsing profiles for separating contexts (e.g., work vs personal).

{
  "profiles": [
    { "id": 1, "label": "Personal", "color": "#43A047" },
    { "id": 2, "label": "Work", "color": "#1E88E5" }
  ]
}

Property	Type	Description
id	number	Unique identifier for the profile
label	string	Display name shown in the UI
color	string	Hex color code for visual distinction

Each profile maintains separate cookies, local storage, and browsing history.

---

Search

Configure the default search engine.

Property	Type	Default	Description
url	string	Google	Search URL template. Use %s as placeholder for the query

Examples

Google (default):

{ "search": { "url": "https://www.google.com/search?q=%s" } }

DuckDuckGo:

{ "search": { "url": "https://duckduckgo.com/?q=%s" } }

Bing:

{ "search": { "url": "https://www.bing.com/search?q=%s" } }

---

History

Configure browsing history behavior.

Property	Type	Default	Description
maxEntries	number	1000	Maximum number of history entries to retain

---

Theme

Customize the visual appearance of Moose.

Value	Description
"auto"	Follows system preference
"light"	Always use light theme
"dark"	Always use dark theme

---

Tips

• Always use valid JSON syntax (double quotes for strings, no trailing commas)
• Back up your settings file before making significant changes
• Restart Moose after editing the configuration for changes to take effect
• Invalid JSON will cause Moose to fall back to default settings

---

Back to Documentation