4chan Media Gallery 2.0 — a cross-imageboard media aggregator and gallery viewer.
Search one keyword. Get every matching image and video from every board, merged into one fast gallery.
The redesigned "deep space utility" homepage — live source-status panel, neon accents, and a single search box.
Note
v1.3.0. New this release: a fully redesigned homepage, top navigation, an in-browser Board Configurator, a settings panel, a relative-time scrollbar, and a dock-style lightbox thumbnail strip. K-pop-oriented by default, general-purpose by design.
📖 Table of contents
Imageboards scatter the same media across a dozen boards and archives. Finding everything on a topic means opening tab after tab, scrolling thread after thread, and re-running the same search by hand. 4CHMG2 collapses that into one query.
| Principle | What it means | |
|---|---|---|
| 🔎 | Search once, see everything | One keyword fans out across 4chan, 2ch.org, Mokachan, and Desuarchive in parallel. |
| 🖼️ | One unified gallery | All hits merge into a single grid, sorted newest-first by post timestamp. |
| ⚡ | Fast by default | A self-hosted proxy with aggressive thumbnail caching keeps scrolling smooth — no skeleton flashes. |
| 🎛️ | Yours to configure | Add, hide, or remove boards right in the browser — no source edits required. |
- 🛰️ Redesigned homepage — a "deep space utility" command-center aesthetic with a subtle grid background, neon magenta/cyan accents, and feature cards. A live source-status panel pings each upstream and shows it as OK or down at a glance.
- 🧭 Top navigation — Explore / Boards tabs, plus About and Settings, always within reach.
- 🎛️ In-browser Board Configurator (
/boards) — add your own boards to the selection row on the supported sites (4chan, Mokachan, 2ch) by entering a board id + label. Hide or delete boards too — all persisted per-browser, no code changes. - ⚙️ Settings panel — user preferences such as a default search term, persisted locally.
- ⏱️ Relative-time scrollbar — on search results, a custom right-edge scrollbar shows the relative post time ("3 days ago") of your current position. Drag to scrub through the timeline, or hover the right edge to reveal it.
- 🔍 Dock-style thumbnail magnify — the lightbox thumbnail strip magnifies toward the cursor with smooth proximity falloff.
- ℹ️ About modal — project info and version, now auto-tracked from
package.json.
Feature checklist
- Multi-board search — query 4chan, 2ch.org, Mokachan, and Desuarchive simultaneously
- Unified gallery grid — all results merged and sorted by timestamp
- Batch ZIP downloads — select gallery results and export them as a single archive
- Quick save — hover a result and press S to download it in place
- Full-featured lightbox — keyboard nav, zoom/pan, slideshow, flip, rotate, download, hotkeys
- OR search — separate keywords with | for multi-term matching
- Auto-refresh — load in fresh media without losing your place
- Touch-friendly — drag-to-pan, pinch-to-zoom, double-tap reset
- Fast self-hosted proxy — aggressive thumbnail caching for smooth, flash-free scrolling
- In-browser Board Configurator — add / hide / delete boards, persisted per-browser
- Relative-time scrollbar — scrub a result set by post time
- Dock-style lightbox thumbnails — cursor-following magnification
 Unified search gallery — every board's hits in one timeline-sorted grid. |
 Lightbox viewer — zoom, pan, slideshow, and a magnifying thumbnail dock. |
🎛️ In-browser Board Configurator
Add your own boards by id + label, hide ones you don't use, or delete them — all without editing source code.
| Source | Board(s) | Cloudflare | Format |
|---|---|---|---|
| 4chan | /mu/, /trash/, /gif/ | No | 4chan API |
| 2ch.org (Dvach) | /kpop/ | No | Dvach / Vichan |
| Mokachan | /kr/ | No | Meguca |
| Desuarchive | /mu/, /trash/ | No | Foolfuuka |
Tip
Users can add their own boards on the supported sites via the in-app Board Configurator — no source edits needed. Adding a new built-in default is still a single entry in src/lib/boards.ts.
A note on Cloudflare
Cloudflare-bypass support (FlareSolverr) is retained in code for future Cloudflare-fronted boards, but is not deployed in production — the only board that ever needed it, Easychan, is defunct. It is dormant, not a headline feature.
| Key | Action |
|---|---|
| ← / → | Navigate between media |
| Space | Toggle slideshow |
| F | Toggle fullscreen |
| H | Flip image horizontally |
| R | Rotate |
| S | Download current media |
| T | Toggle thumbnail strip |
| M | Mute / unmute video |
| Esc | Close lightbox |
Run the app directly without pm2 — ideal for development or quick testing:
git clone https://github.com/kpg-anon/4chmg2.git
cd 4chmg2
cp .env.example .env
nano .env # set your port, etc.
npm install
npm run build
npm startUse pm2 for process management with automatic restarts and zero-downtime reloads:
git clone https://github.com/kpg-anon/4chmg2.git
cd 4chmg2
cp .env.example .env
nano .env # set your domain, port, etc.
npm install
npx gulp reset # install, build, and start under pm2For a full production setup with nginx, SSL (certbot), and pm2 autostart:
sudo ./install.shSee docs/INSTALLATION.md for the complete walkthrough.
After making changes to the code:
npx gulp # build + reload (everyday command)| Command | Description |
|---|---|
npx gulp |
Build and reload the server |
npx gulp build |
Build only |
npx gulp restart |
Reload pm2 only |
npx gulp reset |
Full setup from scratch (install + build + start) |
npx gulp logs |
View application logs |
npx gulp status |
Check pm2 process status |
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Runtime | React 19 |
| Language | TypeScript |
| Styling | Tailwind CSS v4 |
| Process manager | pm2 |
| Build runner | gulp |
| Reverse proxy | nginx + certbot |
Cloudflare-bypass (FlareSolverr) support is retained in code for future Cloudflare-fronted boards, but is dormant and not deployed in production.
4CHMG2 is designed to be self-hosted. Instance-specific configuration (domain, ports, etc.) lives in .env, which is gitignored. For full VPS deployment details, see docs/INSTALLATION.md.
- Additional imageboard sources
- Media deduplication via perceptual hash
- Gallery sharing via URL
- Expanded settings (grid density, accent color)