Skip to content

cercos/4chan-neXT

Repository files navigation

4chan-neXT

4chan-neXT is an actively maintained 4chan X fork with compatibility fixes, UI improvements, and fork-specific features.

Install

You will need a userscript manager:

Latest Version

1.1.9 (2026-06-17)

  • Completed the remaining three phases of the TypeScript migration (strict null checks, noImplicitThis, and noImplicitAny) via assisted codemods, so the entire src/ tree now type-checks clean under full strict mode. Only optional tightening of leftover loose types remains.
  • Fixed search not highlighting words that were split by line-break points in the text (e.g. inside long URLs).
  • Fixed hilight neXT badges not showing due to issue with rollup.js.

Migration from 4chan X / 4chan XT

4chan-neXT uses its own userscript namespace.

To migrate settings:

  1. Export settings from your current script.
  2. Install 4chan-neXT.
  3. Import your settings into 4chan-neXT.

Compatible Styling Scripts

Fork Additions

Quick Reply and posting

  • Per-thread QR Drafts restore with attachment persistence and a recoverable discard bin
  • Upload progress and dump-list file-first removal
  • Image auto-processing and audio stripping for boards that disallow audio
  • Stacked TCaptcha editing
  • Auto-close Tags
  • Post-style comment preview with docked, QR-attached, and floating modes

Thread Watcher and monitoring

  • Quick Reply docking and attach-location controls
  • QR/window resize handling and remembered floating QR reopen behavior
  • OP thumbnails and hover thumbnail previews
  • Mark-all-read and per-thread mark-read icons

Styling and themes

  • Built-in site themes with SFW/NSFW styling variants
  • Styling-script section handoff and home-page mirroring (currently StyleChan)
  • Theme-aware highlight colors and text color modes
  • Custom CSS editor pairing/indent helpers
  • A local styling guide

Scrollbar markers

  • Own-post, quotes-you, ghost-post, and unread-line markers
  • Per-marker colors, opacity, and match-highlight controls
  • Beside-scrollbar and IDE-style over-scrollbar layouts

Filters

  • Responsive Simple Filters with auto-save
  • Color swatches plus custom CSS classes
  • Index/catalog search over preview replies with an op: prefix and per-field regex (comment:/cat|dog/i) that highlights matches in the results
  • Hidden-thread grouping, and showing hidden threads with unread replies to you
  • highlight: class lists and catalog tile highlight glow

Gallery and media

  • Grid gallery thumbnails with configurable columns and thumbnail dock position
  • ZIP-based download-all-media support
  • Thumbnail replacement and metadata visibility controls

Linkification

  • YouTube -> yewtu.be link rewriting
  • X/Twitter -> xcancel link rewriting

Settings and UI

  • Highlight neXT markers for fork-specific settings
  • Vertical or horizontal Settings navigation
  • CSS Custom Highlight API search highlighting and a search-friendly layout
  • Local user/styling docs

Build from Source

npm install
npm run build

Useful build flags:

  • -min: minified output.
  • -platform=userscript or -platform=crx: build only one target.
  • -no-format: skip output formatting steps.
  • -test: include tests in build.
  • npm run build:crxp: build and pack CRX using a key from ../4chan-next.keys/*.pem (override with CRX_KEY_FILE).

Links

About

Modern 4chan enhancement toolkit: cleaner UI, smarter media, and better thread workflows.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors