Skip to content

caffienerd/startpage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Professional Terminal Start Page

A sleek, fast, and feature-rich browser start page driven by an interactive terminal. Boost your productivity with semantic AI routing, direct Gemini integration, open directory search, and a growing suite of built-in utility tools — all wrapped in a premium, modern aesthetic.

→ Try it live: caffienerd.github.io/startpage

Inspired by ahmetdem/start-page
Open directory search inspired by ewasion/opendirectory-finder


Demo

demo.mp4

Themes

themes.mp4

Features

  • Interactive Terminal — Command-driven interface with autocomplete (Tab), syntax highlighting per command type, and command history (/).
  • Semantic AI Router — Use ai: to navigate by intent. Intelligently routes to YouTube, Maps, Reddit, or search.
  • Gemini Integration — Direct AI prompting via gem: or gemini:. Responses appear in a clean, non-intrusive modal.
  • Open Directory Search — Power-user Google dorking via dir/<category>/<engine>: keyword. Search public open directory indexes filtered by file type, with full autocomplete and an interactive builder (:dir).
  • 8 Themes — Light, Dark, AMOLED Black, Nord, Newspaper, Coffee, Root (Hacker), and Neon (Cyberpunk).
  • Syntax Highlighting — Color-coded input for commands, themes, search prefixes, directory tokens, URLs, and more — fully customizable via :customize.
  • Live Dashboard — Local time and real-time weather at a glance.
  • Utility Suite:
    • Spell Check — Smart spelling suggestions via spell:. Press D to define the selected word.
    • Pronunciation — Human-readable syllable breakdown + audio playback via pronounce:. Works on any word, including scientific and technical terms.
    • IP Info — Detailed network info (IPv4, IPv6, ISP, ASN, location) via :ipconfig.
    • Speed Test — Integrated network performance testing via :netspeed.
  • Bookmark Management — Fully customizable bookmark categories via visual grid editor or raw JSON.
  • Custom Tags — Override built-in search prefixes or define entirely new ones via :tags.
  • Backup & Restore — Export and import all settings as a single JSON file.

Getting Started

Prerequisites

You need a static file server to serve the page locally. Opening index.html directly works for most features, but serving it properly is recommended for API requests.

Option 1: Python (Quickest)

python -m http.server 6174

Option 2: Caddy

Copy Caddyfile.example to Caddyfile, set your directory path, then:

caddy run --config Caddyfile

Other options

Any static server works — npx serve, nginx, etc.

Visit http://localhost:6174 in your browser.


Configuration

Run :config to open the settings modal.

Setting Description
Identity Customize your terminal username
Weather Set your location (e.g. New York, London, Delhi)
Gemini API Key Get one from Google AI Studio
Gemini Model Default is gemini-2.5-flash-lite
System Prompt Optional personality for your Gemini assistant
AI Mode Toggle between explicit (ai:) and automatic intent routing
AI Route Badge Control when the route preview badge is shown
Default Search Engine Google, DuckDuckGo, or Bing — also used as the fallback for dir: searches

Run :customize to change the active theme and independently adjust the syntax highlight color for each input type. Colors persist across theme changes.


Command Reference

Search Prefixes

Prefix Example Destination
yt: yt: lo-fi beats YouTube Search
r: r: mechanical keyboards Reddit Search
maps: maps: central park Google Maps
ddg: ddg: privacy tools DuckDuckGo
ggl: ggl: something Google (explicit)
bing: bing: something Bing Search
amazon: amazon: mechanical keyboards Amazon Search
imdb: imdb: Breaking Bad IMDb Search
alt: alt: notion AlternativeTo
def: def: ephemeral Dictionary (OneLook)
the: the: happy Thesaurus (OneLook)
syn: syn: fast Synonyms (OneLook)
quote: quote: time Quotes (OneLook)
spell: spell: recieve Built-in Spell Checker
pronounce: pronounce: ephemeral Built-in Pronunciation
cws: cws: ublock origin Chrome/Firefox Extension Store
gem: gem: explain black holes Gemini Direct Prompt
ai: ai: directions to central park Semantic AI Router

Open Directory Prefixes

Search public open directory indexes using Google dorking (intitle:index.of). Syntax:

dir/<category>/<engine>: keyword

Both <category> and <engine> are optional. Omitting the engine uses your configured default.

Prefix Example Description
dir: dir: interstellar Open dir search, no file filter
dir/media: dir/media: interstellar Video files (mkv, mp4, avi…)
dir/books: dir/books: dune Ebook formats (pdf, epub, mobi…)
dir/music: dir/music: pink floyd Audio files (mp3, flac, ogg…)
dir/software: dir/software: photoshop Executables & archives (exe, iso, zip, apk…)
dir/images: dir/images: wallpapers 4k Image files (jpg, png, psd…)
dir/other: dir/other: keyword Raw open dir, no file filter

Engine override — append /ggl, /ddg, or /bing before the colon:

dir/music/ddg: flac albums
dir/books/bing: operating systems pdf
dir//ggl: keyword        ← no category, explicit Google

Category aliases:

Category Aliases
media vid, video
books book, ebook
music audio, mus
software soft, iso, app
images img, pics

Tab autocomplete works after dir/ (suggests categories) and after dir/category/ (suggests engines).

System Commands

Command Description
:help Show all commands
:config Open settings
:customize / :custom Open customization (theme & syntax colors)
:bookmarks / :bm Edit bookmarks
:dir Open interactive directory search builder
:dirconfig Customize file extensions per dir/ category
:ipconfig / :ip Show detailed network info
:netspeed / :speed Run speed test
:aimode Toggle automatic AI routing
:update Check for a newer version on GitHub
:version Show current app version
:export Export all settings to a JSON backup file
:import Import settings from a JSON backup file
:gemini Open Gemini website
:tags Override search URLs & add custom prefix shortcuts
:help_ai_router Guide for ai: routing

Theme Commands

Command Theme
:light Light mode
:dark Dark mode
:black / :amoled Full black / AMOLED
:nord Arctic Nord
:newspaper Classic Newspaper
:coffee Organic Coffee
:root / :hacker Hacker terminal
:neon / :cyberpunk Cyberpunk Neon

Keyboard Shortcuts

Terminal

Shortcut Action
Tab or Accept autocomplete suggestion
Enter Execute command / navigate
Ctrl+Enter Open result in new background tab
Ctrl+Shift+Enter Open result in new focused tab
/ Navigate command history

Ctrl+Enter and Ctrl+Shift+Enter work for bookmarks, search prefixes, direct URLs, plain-text searches, and dir: queries.

Spell Check (spell:)

Key Action
/ Navigate suggestions
Enter Copy selected suggestion to terminal
D Define the selected (or confirmed) word via OneLook
Esc Close

Pronunciation (pronounce:)

Key Action
Space Play / stop audio
D Define the word via OneLook
Esc Close

Utility Tools

Spell Check — spell:word

Checks spelling using the Datamuse phonetic API with frequency scoring to eliminate false positives. Works on single words and multi-word phrases.

  • / to navigate suggestions, Enter to copy the selected correction to the terminal.
  • Click or press D on any suggestion — or on a confirmed-correct word — to open its definition in OneLook.

Pronunciation — pronounce:word

Displays a human-readable syllable breakdown (e.g. nyoo·muh·noh·uhl·truh...) with the original IPA below it for reference. Plays audio using real MP3 recordings where available, falling back to browser speech synthesis for any word that lacks one — including scientific, chemical, and technical terms.

  • Works on single words and multi-word phrases. Each word is fetched independently and played in sequence.
  • Press Space or click Play to hear the pronunciation.
  • Press D to jump to the OneLook definition.

IP Info — :ipconfig

Shows your IPv4 and IPv6 addresses fetched from separate protocol-locked endpoints, plus ISP, ASN, timezone, location, and VPN detection from ipapi.co.

Speed Test — :netspeed

Runs an in-browser download/upload speed test and displays latency.


Customization

Bookmarks

The start page uses a 4-column layout. Customize bookmarks two ways:

  1. Visual Editor (:bookmarks) — drag-and-drop grid editor that maps directly to the 4-column layout.
  2. JSON Mode — toggle "Edit as JSON" inside the bookmarks modal for bulk edits or to share your setup.

Search Overrides & Custom Tags

Run :tags to override built-in search prefix URLs (e.g. point amazon: to amazon.in) or define entirely new prefixes. Custom prefixes get full syntax highlighting and autocomplete automatically.

Open Directory Extensions

Run :dirconfig to customize which file extensions each dir/ category searches for. Click × on a pill to remove an extension, type a new one and press Enter to add it, or use to reset to defaults.

Syntax Colors

Run :customize to set the highlight color for each input type independently. Colors are stored separately from themes — switching themes never resets your color choices.

Backup & Restore

Use ↓ Export and ↑ Import in :config to save all settings (bookmarks, colors, API keys, custom tags, dir extensions) to a single JSON file and restore them anytime.


Privacy

All settings, including your Gemini API Key, are stored locally in your browser's localStorage. No data is sent to any external server except for:

  • Google Gemini — when using gem: or ai: prompts
  • Open-Meteo — for real-time weather
  • Wiktionary / Free Dictionary API — for pronounce: IPA lookup (no key, no tracking)
  • Datamuse — for spell: suggestions (no key, no tracking)
  • ipapi.co / ident.me — for :ipconfig (your IP is sent by nature of the request)

About

Professional Terminal Start Page is a sleek, customizable browser start page built around an interactive terminal. It combines productivity tools like semantic AI routing, Gemini integration, real-time weather, and network utilities with a premium aesthetic and multiple themes. Designed for speed and flexibility.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors