G H O S T L I N K
Your all-in-one cyberpunk personal portal. Welcome to the hub ;P
Client-side only ยท Fully portable ยท Unrestricted access ยท No tracking
---
GhostLink is a modular, portable personal-portal framework built entirely with HTML, CSS, and JavaScript. It bundles entertainment, productivity, customization, and privacy tools into a single cohesive styled interface.
---
## ๐ฎ Gaming Hub
700+ free games and HTML5 ports powered by the [gn-math](https://github.com/gn-math) community game library. (I do plan on adding my own games and riping all of gn-maths๐ฅน)
- **Favorites** โ heart any game to save it; toggle a filter to show only your picks
- **Download** โ save any game as a standalone `.html` file to run offline
- **Ad Cleaned** โ ad injections and sidebar spam are stripped before rendering
---
## ๐ค AI Terminal
A fast, local-first AI interface running on the [Groq API](https://groq.com).
- **Works out of the box** โ ships with cloud-managed rotating API keys, no setup needed
- **Custom key support** โ supply your own Groq key in Settings for guaranteed priority
- **Multimodal** โ attach up to 5 images at once; auto-switches to the `llama-4-scout` vision model when images are detected
- **Model selection** โ choose from `llama-3.3-70b`, `groq/compound`, `groq/compound-mini`, and more
- **Session management** โ full chat history saved to `localStorage`, browseable via the sidebar history panel
- **Markdown rendering** โ responses render with full formatting support
- **Privacy first** โ keys and history never leave your browser
---
## ๐ Web Proxy
A full multi-tab proxy browser built right into the dashboard, powered by [Scramjet](https://github.com/MercuryWorkshop/scramjet) + BareMux + Epoxy transport.
- **Multi-tab browsing** โ tabs, address bar, back/forward/reload, and a loading bar
- **Built-in ad blocker** โ service worker blocks requests to 29+ ad/tracker domains at the network level before they load
- **Wisp server management** โ ships with 4 servers, auto-picks the fastest, add your own `wss://` any time
- **DevTools** โ inject Eruda into any proxied page with one click
---
## Dashboard & Everything Else
GhostLink is also a full-featured personal dashboard with deep customization built in.
- **Dynamic HUD** โ live clock, battery status, FPS counter, ping monitor, and typewriter splash text on the home screen
- **Theme engine** โ change accent color, background, text colors, blur, brightness, and fonts (including any Google Font by URL) on the fly
- **Tab cloaking** โ preset disguises (Google, Classroom, Desmos, etc.) or fully custom title + favicon, with an about:blank cloaker
- **Custom apps** โ install your own HTML tools or URL shortcuts, pick an icon, and pin them to the sidebar
- **App marketplace** โ pull community apps from the remote GitHub repo with one-click install
- **Keyboard shortcuts** โ rebind the home, games, and panic keys; add custom `Alt + Key` bindings for any section
- **Drag-and-drop sidebar** โ reorder nav items however you want
- **Settings import/export** โ export your entire config (apps, shortcuts, theme, nav order) to `.json` and import it on any device
- **Live presence** โ online user counter and total visit tracker powered by Supabase Realtime
- **README & version viewer** โ click โ to read the live README or browse the last 30 commits with full changelogs; auto-update checker pops a modal when something new drops
- **Repo tools** โ browse and download any file from the GhostLink GitHub repo, view YHS assets with a lightbox, or load an experimental 3D site visualizer
---
## Self-Hosting
**The loader & js:**
Download the ```index.html```,```sw.js``` and ```bareworker.js``` from the self hosting folder in the [github repo](https://cdn.jsdelivr.net/gh/virtuan4-max/ghostlinkhub@main/) or create ones yourself with the code from the jsdlvr links.
- [index.html](https://cdn.jsdelivr.net/gh/virtuan4-max/ghostlinkhub@master/self%20hosting/index.html)
- [sw.js](https://cdn.jsdelivr.net/gh/virtuan4-max/ghostlinkhub@master/self%20hosting/sw.js)
- [bareworker.js](https://cdn.jsdelivr.net/gh/virtuan4-max/ghostlinkhub@master/self%20hosting/bareworker.js)
*note: you can host only the index.html if you need to, but the proxy wont work becuse it NEEDS the service worker and bareworker to function.๐
๐
*
---
## How It was Built
GhostLink is *(almost)* zero-dependency on the client side. The all files are vanilla HTML, CSS, and JavaScript as a multi-paged single-page application.
The game library fetches gn-math statistics, assets, and cover images using the jsdelivr cdn. Games are rendered directly into iframes.
The AI terminal makes direct `fetch` calls to the Groq API from the client. Cloud keys are fetched from a remote vault at startup, shuffled, and rotated per-message. Image attachments are detected and trigger an automatic model swap.
The proxy runs through a registered service worker (`sw.js`) that intercepts fetch events, routes traffic through Scramjet, and kills ad requests before they resolve. BareMux manages the WebSocket transport layer and Epoxy handles the Wisp protocol underneath.
---
## External Dependencies
| Library | Version | Purpose |
|---|---|---|
| [Scramjet](https://github.com/MercuryWorkshop/scramjet) | CDN | Proxy request rewriting |
| [BareMux](https://github.com/MercuryWorkshop/bare-mux) | `2.1.7` | WebSocket transport layer |
| [Groq API](https://groq.com) | โ | AI inference |
| [Supabase JS](https://supabase.com) | `2.39.7` | visit counter |
| [Font Awesome](https://fontawesome.com) | `6.5.1` | Icons |
| [Eruda](https://github.com/liriliri/eruda) | CDN | In-browser DevTools (proxy) |
| [jsDelivr](https://www.jsdelivr.com) | CDN | CDN for loader and assets |
---
## Credits
**SOLE Developer:** [xRevan](https://github.com/virtuan4-max) @xrevannn on discord :P
**Games** Built using customized [gn-math](https://github.com/gn-math) scripts and community-sourced game ports.
**Proxy** [Scramjet](https://github.com/MercuryWorkshop/scramjet) + BareMux + Epoxy Transport by [MercuryWorkshop](https://github.com/MercuryWorkshop) and the base og version was developed by @scentedcheeseburge on discord (Wโค๏ธโ๐ฉนโค๏ธโ๐ฉน)
**AI Engine:** Powered by [Groq API](https://groq.com).
**Some AI** (Un poco de Gemini y mucho de Claude ๐ฅน)
---
*JSDelivr link for ya nerds ๐ https://cdn.jsdelivr.net/gh/virtuan4-max/ghostlinkhub/*