Skip to content

Search and quick capture

The search field at the top does more than send you to a search engine. It finds your own bookmarks, notes and to-dos, answers questions about your server, calculates, and saves new to-dos and notes without opening a widget. This page lists what it understands.

Click the search field, or press Ctrl+K or / anywhere on the dashboard. While you type, matching entries from your bookmarks, service tiles, notes and to-dos appear below the field. Enter opens the selected entry. If nothing matches, Enter searches the web.

The search learns which results you pick and ranks them higher next time. This history stays in your browser. You can switch it off or clear it under Settings → Search.

The same history also remembers the time of day of each pick: weekday or weekend, in six four-hour slots. When you open the search and the field is still empty, up to five entries you usually open at this time appear under Suggested for now, below any running timers. The arrow keys and Enter work as with normal results. With the history switched off or still empty, nothing is suggested and the field shows its usual hints.

Questions without an answer

Under Settings → Search you can also switch on Remember queries without an answer. It is off by default. While it is on, a query is remembered only if it ended in the web search and nothing else matched: no bookmark, note, command, answer or tool. The list keeps the text and how often you asked, for the last 200 queries, grouped by their first word, so you can see which source would help most. It stays in your browser and is never sent to the server. Bangs (!w …) and anything that looks like a password, a token, an e-mail or web address or a phone or account number are never remembered. Clear the list empties it, and switching the setting off deletes it.

Without this setting, texts you send to the web search are not stored anywhere by Waylight.

Help: what the search can do

Type ?, hilfe or help to see everything the search understands right now, grouped into everyday things, your home server, time and dates, tools, quick add, commands and the web. Each line has one or two examples; choose one and it goes into the search field. The list only shows what is enabled for you: without the weather module there is no weather entry, and guests do not see anything that changes data.

Add a word to narrow the list: ? wetter or help disk. The hints that rotate in the empty search field come from the same list.

DuckDuckGo is the default engine, so all of its !bangs work: !w Berlin searches Wikipedia, !gh waylight GitHub. Under Settings → Search you can pick a different engine, add your own shortcuts with a keyword and a URL containing {query}, and have results open in a new tab. The search is also registered as an OpenSearch provider, so most browsers offer to add it as a search engine.

Typing ! lists the most used bangs, and further letters narrow the list (!g shows !g, !gh, !gi and so on). Your own shortcuts from Settings → Search appear first, marked as your own. Pick one and the bang is completed in the field, ready for the search terms. The built-in list ships with Waylight, so nothing is sent to DuckDuckGo while you type. It only appears when your engine understands bangs (DuckDuckGo and Brave Search); your own shortcuts always appear.

Own keywords

For things you open often, give them a word of your own: nas for the NAS tile, bank for your bank's login page, müll for the waste calendar. Type the keyword alone and it is the first row; Enter opens it. Anything more than the keyword (nas status) is a normal search again.

Add keywords under Settings → Search → Own keywords, or straight from a result: open its menu and choose Add keyword…. A keyword points to a service tile, a bookmark, a widget, a web address or a search that runs as if you had typed it. Keywords are 1 to 24 letters, digits, - or _, and case does not matter.

Keywords belong to your account and are stored on the server, so they work on every device you sign in on. They are part of the data export and of the YAML file. A keyword cannot be one of the quick capture prefixes (t, n, b unless you changed them), and a prefix cannot be changed to one of your keywords; the settings say which one is in the way.

Opening addresses

If what you type is clearly an address, the first row says Open … and Enter goes there instead of searching for it. That covers github.com, 192.168.178.1, nas.local:5001, fritz.box, localhost:3000 and anything starting with http:// or https://. Names ending in .local, .lan, .home.arpa, .fritz.box or .internal, and IP addresses, open with http://; everything else with https://. Text such as 5.5, v1.2.3 or node.js tutorial stays a search. Shift+Enter searches the web even for an address, and the "open in a new tab" setting applies here too.

Calculator and units

Simple arithmetic and unit conversions are answered while you type, without a request to the server. Numbers follow the format of your language, and Enter copies the result.

Input Result
2+3*4 14
19 % of 240 45.6
240 + 19 % 285.6
5 km in mi about 3.11 mi
30 °C in F 86 °F
2 GiB in MB about 2147.48 MB

Time and dates

Questions about the time and the calendar are answered in the browser too, in German or English, and Enter copies the answer. Times and dates follow the format of your language.

Input Answer
uhrzeit, wie spät, time The current time
datum, heute, date Today's date with the weekday
kw, week The ISO calendar week
zeit in tokio, time in new york The time there and how far it is from yours
tage bis weihnachten, days until 2027-03-01 The number of days and the weekday of that day
in 90 tagen, vor 2 wochen, 90 days ago The resulting date

For "time in …", the search knows large cities and many countries by their German and English names; other places go to the normal search. Named days are Christmas Eve, Christmas, New Year's Eve, New Year's Day and Easter. A date without a year, such as 1.3., means the next such day. With slashes, German reads day first (1/3 is 1 March) and English month first (3/1).

Tools

A few small tools answer in the search field as well. Like the calculator they run in the browser and send nothing to the server; each one is loaded the first time you type something for it. Enter copies the main value, and for passwords and UUIDs New makes another one.

Input Answer
password, passwort 24, pw 32 ohne sonderzeichen, pin 6 A random password: 20 characters unless you give a length (4–128), with letters, digits and symbols. "without symbols" or "ohne Sonderzeichen" leaves the symbols out, pin gives digits only.
uuid, uuid v7 A new UUID; v7 starts with the current time, so such IDs sort by creation.
#1e90ff, rgb(30,144,255), hsl 210 100 56 The colour with a swatch, in hex, RGB, HSL and OKLCH.
1700000000, unix now, 2026-11-16 12:00 to unix A Unix timestamp as date (local time and UTC), or a date as timestamp. Dates are read in local time unless they end in UTC.
192.168.178.0/24, 10.0.0.5 255.255.255.0, 2001:db8::/48 Network, mask, broadcast, first and last host and the number of hosts; for IPv6 the first and last address of the prefix.

Passwords come from the browser's cryptographic random generator, also when Waylight is opened over plain HTTP. They are not stored anywhere: the search history only learns which result you pick, never the values you copy.

Answers about your home

The quick search answers short questions in English or German, and it forgives typos. You can ask in full ("how full is the disk?", "wetter morgen") or use a prefix with a slash for a direct answer:

Prefix Answer
/cpu, /ram, /load, /disk, /uptime Current values of the host
/docker <name> Status of a container, an update hint, and a restart button if Docker actions allow it
/service <name> Whether a service tile is online and how fast it answers
/weather <place> or /wetter <place> Weather for a place
/calendar, /termine Your next appointments
/waste, /muell The next waste collection
/departures <stop>, /bus Next departures
/parcel, /paket Parcels on their way
/backup State of your monitored backup jobs
/smart Disk health
/speed Latest internet speed test
/timeline Recent events
/feiertag, /holiday The next public and school holidays
/geburtstag, /birthday Upcoming birthdays
/einkauf, /shopping The open items of your shopping list
/strom, /power The electricity price now and the cheapest hour ahead
/football, /fussball Last and next match of your team, or the league table
/sprit, /fuel Fuel prices nearby

Questions work as well: "wann fährt der nächste bus", "brauche ich einen schirm", "wer hat heute geburtstag", "was muss ich einkaufen", "wann ist strom am günstigsten", "is everything up".

An answer only appears for modules that are enabled and set up. When a module cannot answer right now, for example because the departure service is down, the answer says so instead of leaving only the web search. A restart from the search asks for confirmation first, exactly like the button in the Docker widget.

Timers and alarms

Type timer with a duration to start a timer, and wecker or alarm with a time for an alarm:

Type Starts
timer 10 min a ten-minute timer
timer 1h30 pizza a 90-minute timer called "pizza"
timer 90 a 90-minute timer (a bare number means minutes)
wecker 17:30 an alarm at 17:30
alarm 6:45 aufstehen an alarm at 6:45 called "aufstehen"

The row shows when the timer runs out, and Enter starts it. An alarm time that has already passed today is set for tomorrow, and the row says so. When a timer runs out, Waylight shows a notice at the bottom of the page and plays a short sound. The first time you start a timer, the browser asks whether Waylight may show notifications; if you allow it, you also get a notification while you are in another tab.

Running timers are listed when you open the search with an empty field or type timer. Pick one and press Enter to cancel it. Timers are kept in this browser, so they survive a reload.

A timer only fires while a Waylight tab or the installed app is open. Closed tabs cannot ring; a timer that ran out in the meantime shows its notice the next time you open Waylight. Kiosk displays have no timers.

Commands

The search field also controls Waylight itself. Type what you want to do, in English or German, and pick the command under Commands:

Type Does
dark mode, dunkel switches to the dark theme
light mode, hell switches to the light theme
theme, design opens Settings → Appearance with the theme gallery
add widget weather opens the widget picker, already searching for "weather"
edit, bearbeiten starts editing the start page
settings members, einstellungen wetter opens that settings section
tab work switches to the tab named "work"
shortcuts lists the keyboard shortcuts
start tour starts the guided tour again
log out, abmelden signs you out

Start with > to see only commands: > alone lists all of them, >theme narrows the list. Without >, commands appear from three typed characters on, next to the other results.

Only commands you are allowed to run are offered. Guests see the settings of their own account, members see no admin sections, and kiosk displays get no commands at all. While your organisation sets the theme, the theme commands are not offered. Commands you use often move up the list, the same way results do.

With the wiki search set up, pages from BookStack, Outline and Wiki.js appear among the results. With the team features, Confluence, SharePoint, OneDrive, Notion, Slack and Microsoft Teams join them, always with the permissions of the person searching (workplace search). Prefixes narrow the search: w for the wikis, s for Slack, t for Teams.

Quick capture

A short prefix turns the search field into an inbox:

Type Saves
t call the bank a to-do
t dentist tomorrow a to-do due tomorrow
n idea for the garden a note
b https://example.org a bookmark

The long forms todo:, note: and bm: work as well. You can change the short prefixes under Settings → Search.

Saving from other pages

You do not have to open Waylight to save something:

  • Bookmarklet. Settings → Search offers a bookmarklet. Drag it to your browser's bookmarks bar; clicking it on any page opens a small dialog that saves the page as a bookmark, to-do or note.
  • Share menu. When Waylight is installed as an app on Android, it appears in the share menu. Sharing a link or text opens the same dialog.
  • Browser extension. The extension adds Save page to Waylight to the toolbar and the context menu.

Nothing is saved until you confirm the dialog.