Skip to content

caffienerd/startpage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 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 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 (Up/Down).
  • Semantic AI Router: Use the ai: prefix to navigate based on intent. Intelligently routes you to YouTube, Maps, Reddit, or search.
  • Gemini Integration: Direct AI prompting via gem: or gemini:. View responses 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).
  • Rich Aesthetics: Premium design with support for Light, Dark, AMOLED (Black), Nord, Newspaper, Coffee, Root (Hacker), and Neon (Cyberpunk) themes.
  • Syntax Highlighting: Color-coded input for commands, themes, search prefixes, open directory tokens, URLs, and more — fully customizable via :customize.
  • Live Dashboard: Instant access to local time and real-time weather updates.
  • Utility Suite:
    • IP Info: Detailed network information via :ipconfig.
    • Speed Test: Integrated network performance testing via :netspeed.
    • Spell Check: Smart spelling suggestions via spell:.
  • Bookmark Management: Fully customizable bookmark categories via visual grid editor or raw JSON.
  • Default Search Engine: Choose between Google, DuckDuckGo, or Bing for plain-text searches.

Getting Started

Prerequisites

You need a way to serve the static files locally. While you can open index.html directly, some features (like API requests) work better when served.

Option 1: Python (Quickest)

python -m http.server 6174

Option 2: Caddy

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

caddy run --config Caddyfile

Other options

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

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


Configuration

Run :config in the terminal to open the settings modal.

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

Run :customize to open the customization modal.

  1. Theme: Switch between all 8 themes with a single click.
  2. Syntax Colors: Independently customize the highlight color for each input type (commands, themes, search prefixes, URLs, version, unknown). Colors persist across all themes.

Command Reference

Search Prefixes

Prefix Usage Destination
yt: yt: youtube search YouTube Search
r: r: something to find in reddit Reddit Search
maps: maps: location Google Maps
ddg: ddg: search with DuckDuckGo DuckDuckGo
ggl: ggl: search with Google Google (explicit)
bing: bing: search with bing Bing Search
amazon: amazon: mechanical keyboards Amazon Search
imdb: imdb: Breaking Bad IMDb Search
alt: alt: alternative of something AlternativeTo
def: def: definition of something Dictionary (OneLook)
the: the: a phrase to get the thesaurus of Thesaurus (OneLook)
syn: syn: synonyms of something Synonyms (OneLook)
quote: quote: quotes containing keywords Quotes (OneLook)
spell: spell: word / phrase to check Built-in Spell Checker
cws: cws: extension Chrome/Firefox Extension Store
gem: gem: talk to gemini Gemini Direct Prompt
ai: ai: directions to central park Semantic AI Router

Open Directory Prefixes

Search for public open directory indexes using Google dorking (intitle:index.of). The syntax is:

dir/<category>/<engine>: keyword

Both <category> and <engine> are optional. If no engine is specified, your configured default search engine is used.

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 (shorter to type):

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 (colors & theme)
:bookmarks / :bm Edit bookmarks
:dir Open interactive directory search builder
:dirconfig Customize file extensions per dir/ category
:ipconfig / :ip Show network info
:netspeed / :speed Run speed test
:aimode Toggle automatic AI routing
:version Show app version
: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

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.


Customization

Bookmarks

The start page features a 4-column layout. You can customize bookmarks in two ways:

  1. Visual Editor (Recommended): Run :bookmarks to use the grid-based editor. It maps directly to the 4-column layout, letting you organize links by column and row.
  2. JSON Mode: Toggle "Edit as JSON" in the bookmarks modal for bulk edits or sharing your setup.

Search Overrides & Custom Tags

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

From :tags you can also open ⊞ Dir Extensions to customize the file extensions used by each dir/ category.

Open Directory Extensions

Run :dirconfig (or open it via the ⊞ Dir Extensions button in :tags) to customize which file extensions each dir/ category searches for. Each category shows pill-style tags — click × to remove an extension, type a new one and press Enter to add it. Use to reset any category back to its defaults. Changes are saved per-category and persist across sessions.

Syntax Colors

Run :customize to independently set the highlight color for each input type. Colors are stored separately from themes — changing themes won't reset your colors.

Backup & Restore

Use the ↓ Export and ↑ Import buttons in :config to save all settings (bookmarks, colors, API keys, custom tags, dir extensions) to a 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 external servers except for necessary API calls to Google Gemini and Open-Meteo (weather).

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