A clean, minimal, and customizable browser startpage for a better new tab experience.
Features · Preview · Installation · Customization · License
Startpage is a lightweight, customizable browser homepage designed for quick navigation, clean visuals, and a distraction-free workflow.
It includes multiple built-in themes, dark and light mode support, an image widget, customizable links, and simple local setup.
| Feature | Description |
|---|---|
| Multiple themes | Switch between different built-in visual styles. |
| Dark and light mode | Designed to work well in both dark and light setups. |
| Image widget | Add a custom image widget to personalize your page. |
| Quick links | Keep frequently used websites in one clean dashboard. |
| Local setup | Runs locally through a simple index.html file. |
| Lightweight | Built to stay fast, simple, and distraction-free. |
| Customizable | Edit links, colors, themes, backgrounds, layout, and widgets. |
| Cross-platform | Works on Linux, macOS, and experimental Windows setups. |
Startpage includes multiple built-in themes and an image widget so you can customize the look of your browser homepage.
Linux
Make sure git is installed first.
For Debian/Ubuntu-based systems:
sudo apt install gitFor Arch-based systems:
sudo pacman -S gitClone and install Startpage:
cd ~/Documents
git clone https://github.com/realSPectr0/start.page.git
cd start.page
chmod +x setup.sh
./setup.shOpen the startpage:
xdg-open index.htmlIf xdg-open is missing, install xdg-utils.
For Debian/Ubuntu-based systems:
sudo apt install xdg-utilsFor Arch-based systems:
sudo pacman -S xdg-utilsmacOS
Make sure Git is installed.
If Git is not installed, run:
xcode-select --installClone and install Startpage:
cd ~/Documents
git clone https://github.com/realSPectr0/start.page.git
cd start.page
chmod +x setup-mac.sh
./setup-mac.shOpen the startpage manually:
open index.htmlmacOS uses open instead of Linux’s xdg-open. If the setup script gives an xdg-open error, open index.html manually or replace xdg-open with open inside the script.
Windows
Windows support is currently experimental and may not work perfectly yet.
The recommended method is to use Git Bash or WSL.
Install Git for Windows, open Git Bash, then run:
cd ~/Documents
git clone https://github.com/realSPectr0/start.page.git
cd start.page
chmod +x setup.sh
./setup.shIf the setup script does not work on Windows, open the startpage manually.
Go into:
Documents/start.page/startpage
Then open:
index.html
in your browser.
If you use Windows Subsystem for Linux, follow the Linux instructions inside your WSL terminal.
After installation, open:
index.html
You can use Startpage as:
- A browser homepage
- A custom new tab page
- A local navigation dashboard
- A personalized browser landing page
To make it your homepage, open your browser settings and set the homepage to the local index.html file.
You can customize Startpage by editing the project files inside:
start.page/startpage
Common things to change:
| Item | Description |
|---|---|
| Links | Edit the websites shown on the startpage. |
| Icons | Change or replace shortcut icons. |
| Themes | Modify existing themes or add new ones. |
| Colors | Adjust the color palette to match your setup. |
| Backgrounds | Change background colors or images. |
| Image widget | Replace or customize the image widget. |
| Layout | Adjust spacing, placement, and page structure. |
| Mode styling | Edit dark and light mode styles. |
After editing, refresh the browser page to see your changes.
To update the project later, go into the repo folder and pull the newest version:
cd ~/Documents/start.page
git pullThen rerun the setup script if needed.
Linux:
cd startpage
./setup.shmacOS:
cd startpage
./setup-mac.shGit is not installed.
On Linux, install it with your package manager.
On macOS, run:
xcode-select --installOn Windows, install Git for Windows or use WSL.
Give the setup script permission to run:
chmod +x setup.sh
./setup.shFor macOS:
chmod +x setup-mac.sh
./setup-mac.shInstall xdg-utils on Linux:
sudo apt install xdg-utilsFor Arch-based systems:
sudo pacman -S xdg-utilsOn macOS, use:
open index.htmlWindows support is experimental. If the script does not run, open index.html manually in your browser.
- Improve Windows support
- Add easier customization options
- Add more widgets
- Add more themes
- Add browser setup instructions
- Improve mobile layout
- Add more shortcuts and quick-access tools
Contributions, ideas, and suggestions are welcome.
You can contribute by:
- Reporting bugs
- Suggesting features
- Improving documentation
- Submitting pull requests
Created by realSPectr0
Inspo from zusqii
This project is licensed under the MIT License.
You are free to use, modify, and distribute this project as long as the original license and copyright notice are included.