What is Startpage?
Startpage is a self-hosted, password-protected browser startpage. It lets you organise your bookmarks into groups, add widgets (weather, Pomodoro, notes, RSS, to-dos), and customise the look — all saved per-user in a database.
Your password is part of the URL fragment (#password) and never leaves your browser.
Bookmarks & Groups
Click the ✏ Edit button (top right) to enter edit mode.
- Add a bookmark: Click the + inside any group. Enter name, URL, and optionally a custom icon URL. The page title auto-fills when you paste a URL.
- Edit a bookmark: Click the ✏ icon on the card. Change name, URL, or icon and click Save.
- Delete a bookmark: Click the 🗑 icon on the card.
- Add a group: Click + Add Group at the bottom.
- Rename a group: In edit mode, click the group title to type a new name.
- Delete a group: Click the 🗑 icon on the group header.
- Collapse/expand: Click any group header to toggle.
Reordering
In edit mode, drag the ⠿ handle on a group header to reorder groups. Drag any bookmark card to move it within or between groups. Changes save automatically.
Search
Type in the search bar and press Enter to search with your selected engine.
- Press / to focus the search bar.
- Click the engine name to switch engines, or press 1–9.
- Manage engines in Settings → Search Engines.
Filter
Press f to focus the filter box. Type to instantly show only matching bookmarks. Collapsed groups auto-expand if they have matches. Press Esc to clear the filter.
Weather Widget
Enable in Settings → Widgets. Enter your city name to search for coordinates, or type latitude/longitude manually. Choose °C or °F. Weather updates every 15 minutes via the free Open-Meteo API — no API key needed.
Pomodoro Timer
Enable in Settings → Widgets. Default cycle: 25 min work / 5 min short break / 15 min long break (every 4 sessions). Click the timer to start/pause, click reset to restart. Browser notifications fire when a session ends (requires permission).
Notes Widget
Enable in Settings → Widgets. A personal scratchpad synced to the database. Auto-saves 800ms after you stop typing. Per-user — not shared.
RSS Feeds
Enable in Settings → Widgets. Add feed URLs — they are fetched server-side (no CORS issues) and cached for 30 minutes. Supports RSS 2.0, RSS 1.0, and Atom. Configure max items and toggle descriptions.
To-do List
Enable in Settings → Widgets. Each task has text, optional due date, and priority (high/normal/low). Tasks sort by: incomplete first, then priority, then due date. Completed tasks move to the bottom. Toggle "Show completed tasks" in settings.
Appearance
Open Settings → Appearance to customise:
- Theme: Click ☀/🌙 in the header to switch dark/light.
- Accent colour: Changes buttons, links, highlights.
- Font: System font or any Google Font name (e.g.
Inter).
- Density: Compact / Normal / Comfortable.
- Background: Solid colour or CSS (e.g.
linear-gradient(…)).
- Group colours: Header and body background.
- Greeting: Optional greeting line (e.g. "Good morning, Alice").
World Clocks
Open Settings → Clocks. Add clocks by timezone (e.g. Europe/Berlin, America/New_York). Use local for your local time. Remove all clocks to hide the clock row.
Export & Import
Open Settings → Export / Import:
- Export config: Downloads your full settings as
config.json.
- Import config: Merges a backup — bookmarks are deduplicated by URL.
- Export bookmarks: Netscape HTML format, importable in any browser.
- Import bookmarks: Import from browser export; folders become groups.
- Refresh favicons: Re-fetch all bookmark icons from the web.
Keyboard Shortcuts
/ | Focus search bar |
f | Focus filter |
e | Toggle edit mode |
, | Toggle settings panel |
h | Toggle this help panel |
1–9 | Switch search engine |
Esc | Close panels / clear filter |
Browser Extension
The extension replaces your new-tab page with Startpage.
- Chrome / Edge / Brave: Go to
chrome://extensions, enable Developer mode, click "Load unpacked", select the extension/ folder.
- Firefox: Open
about:debugging, click "Load Temporary Add-on", select extension/manifest.json.
- Safari: Convert with
xcrun safari-web-extension-converter in Xcode.
After installing, open extension options and enter your full startpage URL including #password.
Authentication
Your password is the URL fragment after # — for example https://site.com/startpage/#mypassword. It is hashed with SHA-256 in your browser and sent as an X-Auth-Token header. The password itself never leaves your browser.
Each user has their own password, bookmarks, and settings — completely isolated.
Favicons
Icons are fetched server-side and cached for 7 days. If an icon is missing:
- Go to Settings → Export / Import → Refresh all favicons.
- Or set a custom icon URL when editing the bookmark.
A coloured letter placeholder is shown when no icon can be found.