Repository navigation
Releases
Typestash 0.2.0 · themes, a real compare, and a command bar
Typestash 0.2.0 · themes, a real compare, and a command bar
Typestash is now public. This release turns the first cut into something you can live in: twelve themes, a compare view built for actually choosing between fonts, a command bar that does everything, and a lot of polish.
✨ What's new
⇆ Compare, rebuilt
- Side by side: a colour-coded column per font with a big Aa, your sample, a paragraph, the full character set and metric bars (x-height, cap height, ascender, descender, average width, glyphs, styles) scaled against each other. Sections line up across columns.
- Rows for quick scanning and Overlay, which stacks one word from every font on a shared baseline so width and x-height differences jump out.
- One weight slider drives every font: variable fonts glide, static families snap to their nearest style.
- Reorder with ← →, add from anywhere, or start from Serif vs sans vs mono, 3 random fonts or your favourites.
🎨 12 themes
- Light: Paper, GitHub Light, Solarized Light, Catppuccin Latte, Gruvbox Light, Rosé Pine Dawn.
- Dark: Ink, Dracula, Nord, Catppuccin Mocha, Gruvbox Dark, Tokyo Night.
- Match system switches between your favourite light and dark theme with the OS. Every theme passes WCAG AA contrast for text.
⌘ Command bar
⌘Kon macOS,Super+Kon Linux,Ctrl+Kon Windows.- Jump to any font or collection, switch theme, change view, sort and filters, rescan, set preview text, open the project links. On a font's page it can also download, favourite, compare or export a specimen.
- The library filter and the command bar work together: whatever you typed carries over.
🔤 Preview presets and scripts
- Save your own sample texts as one-click presets, and edit them in Settings.
- A Scripts menu built from your library: preview Cyrillic, Greek, Arabic, Devanagari, Hebrew, Thai and more, and see only the fonts that can render them.
⚙️ And more
- Settings page: appearance, preview defaults, presets, keyboard shortcuts, server info.
- Collapsible sidebar (
[), Surprise me in the header, a nerdy terminal-style footer with live library stats, and a cleaner header with a drop-zone Add fonts button. - Specimen PNGs now carry a Typestash brand row with the repo link.
- New ts▌ icon.
- Fixes: long file paths on family pages, footer position on short pages, phone layouts, sticky offsets.
🚀 Install or upgrade
docker pull ghcr.io/jatinkrmalik/typestash:0.2.0Or with Compose, docker compose pull && docker compose up -d. Your fonts folder and /data carry over; the index rebuilds itself once to pick up new font metrics.
| Image | ghcr.io/jatinkrmalik/typestash |
|---|---|
| Tags | 0.2.0 · 0.2 · latest (plus edge from main) |
| Platforms | linux/amd64 · linux/arm64 |
🙏 Thanks
Built on fontTools. The demo uses families from Google Fonts under the SIL Open Font License. If Typestash is useful, buy me a coffee or sponsor it on GitHub.
Full changelog: v0.1.0...v0.2.0
Typestash 0.1.0 · first release
Typestash 0.1.0 · first release
Every font you own, in one drawer you can open from any browser.
Fonts pile up everywhere: client zips, old laptops, that one typeface you bought for a wedding invite. Typestash points at a folder on your server, reads what's actually inside every font file, and turns it into a gallery you can search, test, organise and download from. Your fonts stay plain files: Samba, rsync and backups keep working exactly as before.
✨ Highlights
See every font, set in itself
- A live gallery where each card is drawn in its own font, with your own sample text and size
- Hover a card to sweep through its weights: variable fonts glide, static families flip through styles
- Grid or list view, sort by name, newest, most styles, or shuffle
Find the right one fast
- Real metadata read with fontTools: family, style, weight, width, designer, foundry, version, license
- Filter by sans, serif, mono, display, script, variable fonts, families with italics
- Filter by language support: Latin, Cyrillic, Greek, Arabic, Hebrew, Devanagari, Bengali, Tamil, Thai, CJK, Hangul, Kana
- Categories are detected from the letterforms themselves, and you can override any of them
Ctrl/⌘ Kcommand bar to jump to any font, collection or action
Try before you use it
- Type tester with variable-axis sliders (and an animate button), named instances, OpenType feature toggles, size, leading, tracking, alignment and colour themes
- Glyph map with an inspector: click to look closer, double-click to copy
- Waterfall from 12 to 96 px, pairing suggestions for heading and body, and compare up to 8 fonts side by side
Keep it tidy
- Favourites, collections (download a whole collection as a zip) and searchable notes
- Drag fonts or
.ziparchives anywhere on the page: validated, de-duplicated by content, filed asUploads/<Family>/ - A Duplicates & issues page for identical files and fonts that won't open. Nothing is ever deleted.
Take it with you
- Download a single style, a whole family as a zip, or a PNG specimen sheet
- TTF, OTF, WOFF, WOFF2 and TTC/OTC collections
🚀 Install
mkdir -p typestash/fonts typestash/data && cd typestash
docker run -d --name typestash -p 8080:8080 \
-v "$PWD/fonts:/fonts" -v "$PWD/data:/data" \
-e PUID=$(id -u) -e PGID=$(id -g) \
--restart unless-stopped \
ghcr.io/jatinkrmalik/typestash:0.1.0Then open http://localhost:8080 and drop some fonts on the page. Prefer Compose or Unraid? See the README.
| Image | ghcr.io/jatinkrmalik/typestash |
|---|---|
| Tags | 0.1.0 · 0.1 · latest (plus edge from main) |
| Platforms | linux/amd64 · linux/arm64 |
| Inside | one Python file + plain HTML, CSS and JS, no build step |
🏠 Made for self-hosting
- PUID / PGID so everything it writes is owned by you
- Optional login with
TYPESTASH_PASSWORD, or leave it to Authelia, Authentik, oauth2-proxy and friends - Read-only mode with
TYPESTASH_UPLOADS=false - Works behind Caddy, Traefik or nginx, at a domain or a sub-path
- Health check built in, state in a single SQLite file under
/data - Unraid template included
📝 Good to know
- This is a first release: expect rough edges and please open an issue when you hit one.
- Automatic categories are right most of the time; a few display and script faces will need a one-click override.
- Typestash is a library, not a license. Only share fonts you're allowed to share.
🙏 Thanks
Built on fontTools. Demo and screenshots use families from Google Fonts under the SIL Open Font License.
Full source: v0.1.0 · MIT licensed


