imageboard-explorer

A TUI-style webapp for browsing imageboard content in a simplified view. Built with FastAPI + Jinja and the 4chan read-only API.

Overview

• Terminal-like UI for browsing boards, catalogs, threads, and posts.
• Keyboard-first navigation with rofi-style board search.
• Simplified rendering of posts, quotes, and media.

Tech Stack

• Backend: FastAPI, httpx, Pydantic
• Frontend: Vanilla JavaScript, Jinja2 templates
• API: 4chan read-only API with If-Modified-Since caching

Features

• Board selection with search overlay (rofi-inspired).
• Thread catalog and post lists in a fixed-height window with centered view / selection.
• WASD navigation for quotes and external URLs.
• Country flags on boards that support them.

Screenshots

Click a thumbnail to view more screenshots

Installation

RELEASE VERSION COMING SOON - FINAL BUG FIX IN PROGRESS

Requirements:

uv package manager

Setup and Run:

git clone https://github.com/htmlgxn/imageboard-explorer.git
cd imageboard-explorer
uv run imageboard-explorer

Open http://127.0.0.1/ in your web browser

Controls

View how navigate each page in order.

Notes

• This project respects 4chan API rules and uses If-Modified-Since with in-memory caching.
• The app is not affiliated with or endorsed by 4chan.

License

Unlicense