Skip to content

Configuration

Jump to bottom
Deepjyoti Barman edited this page Nov 30, 2020 · 9 revisions

Table of Contents

Opening settings

Settings menu can be opened in more than one ways.

  • You can type --setting in the search bar and hit enter and it will open up the settings menu.
  • You can hit ctrl+, (control plus comma) when startpage is open and it will open the settings menu.
  • You can open it by clicking on the settings icon on the bottom right of the page. (This might not be enabled by default. To enable go to settings by any of the above methods and update the settingsIcon field to true)

The latter was added since the search bar can be hidden by editing the config, so there was need for an alternate way.

Supported values in settings

You can open settings by following one of the ways above.

A JSON editor will open up where you can make the changes.

Name Supported Values Default Description
searchEngine <DuckDuckGo | Google | Bing |Yahoo> DuckDuckGo Search Engine to use for searching from the bar
user string Deepjyoti (That's my name) Name of the user to use on the welcome message
disableMessage <false | true> false Hide the Welcome message
message string Not in config by default Static custom message
disableDate <false | true> false Hide the date
disableSearchBar <false | true> false Hide the search bar
disable24Hour <false | true> true Disable 24 hour clock and show time in 12 hour format
disableWeather <false | true> true Disable the weather beside the date
settingsIcon <false | true > false Show the settings icon on the bottom right
weatherConf Object (Check default for child keys) {"location": "Pune India","unit": "fah"} Configuration for the weather, location and unit etc. In "unit", "fah" is short for Fahrenheit and "cel" for Celcius, however the whole word can also be passed.
squares Object of arrays Check config.json for default values Values and Names of shortcuts for the cards.

Customizing the squares

The squares are pretty customizable as well.

Each square should be present inside the squares Object in the config.json file or should be set when --setting is clicked.

Each square can contain the following values.

Name

Name

The name variable contains the name of the square block, the one that appears on the top of the square/card.

Datatype: String

For Eg: If you want to set the squares name to Media, it should be

"name": "Media"
Url

Url

Should be a link. This will make the title of the square card clickable, i:e the title will have a nested a with the href set to the provided link. If the link is not passed then the title will not be clickable. If the link is passed, the title will be behave like a link.

Datatype: String

For eg: If you have a square with the name Media and you want it to open youtube.com when clicked, you can pass something like this

"url": "https://youtube.com"
Color

Color

The primary color that the heading of the square has and also the one that the links will have when the cursor is over them.

Datatype: String

For Eg: If you want to set the color to Black or #000 or #000000, the string should be one of the following

"color": "Black",

OR

"color": "#000"

OR

"color": "#000000"

NOTE: Currently supports CSS color names and HEX values.

Links

Links

This is an array that will contain objects which will later be parsed to URL. Each object should contain two values.

Datatype: Array

  • name: Name of the URL
  • url: The URL.

For eg: If you want something like Netflix, the object should be

{"name": "Netflix", "url": "https://netflix.com"}
Clone this wiki locally