DIY

ssh portfolio.vedsite.com

paste into your terminal and type yes to confirm the connection. trust me, i don't want your data

overview

This is my website, but accessible over SSH. When you connect to port 22, you get vedsite.com in the terminal: the same four sections, the same photos and projects, and the same live music and film data. Each section below is one page of it, recorded from a real session. You can press 1 through 4 on your keyboard to jump between them, or just sit by and watch the squares bounce around (don't sit idle too long, I have a timeout set for 10 minutes).

home

I tried to be consistent with the DVD-player-esque animation style of my homepage, with the squares bouncing off the edge. Each square maps to a different section of my portfolio and morphs into a different character every time it hits a wall.

bouncing square navigation: Four squares made up of four different icons (# @ * +) drift across the terminal, with each square color-coded to a specific page. Red = about, purple = projects, gold = experience, teal = misc. The numbers and colors match the ones on my website homepage respectively.
square morphing: When a square collides with the edge of the terminal window, its character icon cycles to the next in the set. Purely cosmetic, but helps hold up part of the original animation.
tiled background: Staying true to the background on my homepage, I have my (clever) personal domain repeating across every cell in the terminal as a dim grid, providing a nice background to watch the squares bounce around in. The text is offset per row so it reads diagonally, and the squares render on top of it.

about

My bio and links, next to four photos from my gallery turned into colour ASCII art in the style of terminalcam: every cell gets a character from a 70-step brightness ramp and the colour of the pixel under it. ←/→ flips between them.

52 weeks, 52 photos: The buzz cut one plays all 52 weekly photos as a loop, with a week counter under it.
fits your window: The art resizes to fit your terminal, so a bigger window means a bigger picture.

projects

Every project on this site is in a list you move through with the arrow keys, with a preview of the highlighted one underneath. Enter opens a short write-up with links to the full page, and b goes back to the list.

experience

My work, leadership, education, and the languages and tools I use. If your window is too short to fit it all, it scrolls with the arrow keys and shows a scrollbar.

misc

The same data as my misc page: what I'm playing on Spotify (with a progress bar that ticks between updates), my queue or recently played, my top artists this month, and my top 4 and recent films.

The misc page over SSH: top artists this month, a Steely Dan song playing with its progress bar and queue on the left; my top 4 films, recent films with star ratings and profile links on the right
have i heard it?: Press / and type a song or artist to search my Last.fm history. Enter on a result shows how many times I've played it and when I first and last did.
have i seen it?: tab switches the box to my Letterboxd diary, with my rating, how many times I've watched it and a link to the entry. esc closes the search.

getting around

keyboard navigation: Press 1-4 to jump between pages, b or esc to go back, and q to quit. Every page lists the keys that work on it in a footer, and links open in your browser in most terminals.
small windows: If your window is smaller than 80×24, the page asks you to make it bigger, then redraws itself once it fits. The home screen keeps bouncing at any size.
per-user sessions: Every SSH connection spawns its own independent instance of the UI, which means that multiple users can connect at the same time. Every session will be unique, your squares are your session.
A 64 by 20 terminal showing the message: this terminal is 64×20, make the window at least 80×24 and this page redraws itself

construction

Go Wish Bubble Tea Lip Gloss Oracle Cloud

The app is written in Go using the Charm stack which is a set of GitHub libraries specifically built for terminal UIs over SSH. Wish handles the SSH server: it listens on port 22 and bootstraps a fresh terminal UI for each incoming connection. Bubble Tea is the TUI framework that drives the render loop: an Init → Update → View cycle running at 50ms ticks for smooth animation. Lip Gloss handles all the styling including colors, bold text, positioning in the terminal.

The animation loop works like a simple physics engine: each square has an (x, y) position and a velocity vector (vx, vy). With every tick, positions update and bounce off of terminal edges. On collision, the square's character morphs to the next one in the cycle.

Every page draws into a fixed grid of cells, which is then written out in runs of one colour, so layouts line up exactly at any size from 80×24 up. Doing the same for the home screen cut what it sends over the wire by about 10× without changing a single character on screen.

The misc page doesn't fetch anything per visitor. One fetcher on the server keeps the latest data from api.vedsite.com and only runs while someone is on that page, so a hundred visitors cost the API the same as one. If the API goes down, the last data stays up, marked stale. Searches wait 150 ms after you stop typing and ignore answers to older queries. The photos are prepared offline with ffmpeg (cropped, sharpened, contrast-stretched), built into the binary, and scaled to your terminal when you open the page. Each size is built once and shared by everyone.

architecture

your terminal → Cloudflare DNS → Oracle Cloud VM → Wish server → Bubble Tea UI

The Go binary runs natively on an Oracle Cloud free-tier VM, listening on port 22, so ssh portfolio.vedsite.com lands straight in the Wish server. Cloudflare handles DNS as an A record on DNS-only mode pointing at the VM, since SSH cannot be proxied on the free tier. It used to run on my Pi behind a relay on the VM, but then every visitor looked like they were connecting from the relay, so I moved the binary itself onto the VM.

Source? The code is on my GitHub. The main logic is still a single main.go file: the model, every page, the shared cache and the SSH server setup. The photo art sits next to it in art/.