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.
Opening the search¶
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.
Web search¶
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.
Wiki and workplace search¶
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.