4chan X has had more contributors added, including myself. So, the original script will be maintained with the changes made here, and development will continue, focused on the original 4chan X userscript and repository.
I will keep this fork synchronized with the upstream 4chan X, and may add additional functionality on top that would not be suitable for the base 4chan X userscript, on an as-needed basis.
4chan XL (formerly 4chan X) is a script that adds various features to anonymous imageboards. It was originally developed for 4chan but has no affiliation with it.
It was previously developed by aeosynth, Mayhem, ihavenoface, Zixaphir, Seaweed, Spittie, and ccd0, with contributions from many others.
If you're looking for a maintained fork of OneeChan (a style script used in addition to 4chan XL), try https://github.com/KevinParnell/OneeChan.
4chan XL adds a number of small quality of life features to improve your imageboard browsing experience.
Features include:
- Thread Watcher: Easily track threads from across boards, and see how many unread replies there are
- Filter out non-image replies: Want to just see image replies (hint hint)? Get ride of text-only posts in one stroke of your keyboard.
- Automated Captcha Solver: Don't have a 4chan Gold pass? This allows you to (usually) circumvent captchas
- JSON Mode: Infinite scrolling, catalog mode, gallery mode, filter and search more easily with a new JSON mode
- Helpful Keybindings: Expand all images, hide non-image posts, expand threads, and more with simple keybindings
- Thread Monitoring: Automatically shows new replies, and divides read posts from unread posts with a red line
- Archived Threads: Get redirected to the archived version of a thread automatically instead of getting an error message
- Quick Reply: All in one way to reply, create threads, and dump content
Uninstalling: 4chan XL disables the native extension, so if you uninstall 4chan XL, you'll need to re-enable it. To do this, click the [Settings] link in the top right corner, uncheck "Disable the native extension" in the panel that appears, and click the "Save Settings" button. If you don't see a "Save Settings" button, it may be being hidden by your ad blocker.
Private browsing: By default, 4chan XL remembers your last read post in a thread and which posts were made by you, even if you are in private browsing / incognito mode. If you want to turn this off, uncheck the Remember Last Read Post and Remember Your Posts options in the settings panel. You can clear all 4chan browsing history saved by 4chan XL by resetting your settings.
Use of the "Link Title" feature to fetch titles of Youtube links is subject to Youtube's Terms of Service and Privacy Policy. For more details on what information is sent to Youtube and other sites, and how to turn it off if you don't want the feature, see 4chan XL's privacy documentation.
Install Violentmonkey, Tampermonkey, or Greasemonkey (issues since v4: #2526, #2576), then click here to install 4chan XL.
Ports of Greasemonkey are available for SeaMonkey and Pale Moon.
Userscript: Install Violentmonkey or Tampermonkey, then click here to install 4chan XL.
Install the Userscripts extension. Enable it by pressing ⌘,, navigating to the extensions pane and checking Userscripts checkbox. Now open the Userscripts editor by clicking on the </> button in the taskbar. Then click on the + button and select the New Javascript option. Replace the default text with the contents of the 4chan XL script. Finally save it by pressing ⌘s.
Several minimal browsers have support for userscripts and can run 4chan XL. Due to the lack of the cross-site GM_* API, and lack of support for userscripts in iframes, not all features will work. You may experience crashes when repeatedly solving the default image-based captchas. You can avoid this problem by enabling Use Recaptcha v1 in your settings.
-
dwb: Install the userscripts extension, then save the script to the
$XDG_CONFIG_HOME/dwb/greasemonkeyor$HOME/.config/dwb/greasemonkeydirectory (creating it if necessary):dwbem -N -i userscripts wget -P ${XDG_CONFIG_HOME:-$HOME/.config}/dwb/greasemonkey https://4chan-xl.kickin.rocks/builds/4chan-XL.user.js -
Midori: Enable
User addonsin your preferences, under the Extensions tab. In the Privacy tab, checkEnable HTML5 local storage support. Optionally, if you want 4chan XL to be able to open new tabs when you start or reply to a thread, you will need to checkAllow scripts to open popupsunder the Behavior tab. Then click the link to the script to install it. -
Luakit: Navigate to the script, then type the command
:usito install it. -
uzbl: Install the script from https://github.com/singpolyma/singpolyma/blob/master/uzbl/data/scripts/userscript.sh, enable it in your config file, and then save 4chan XL to
$XDG_DATA_HOME/uzbl/userscripts(or$HOME/.local/share/uzbl/userscripts). The commands below assume you have run uzbl at least once to create its config file.wget -P "${XDG_DATA_HOME:-$HOME/.local/share}/uzbl/scripts" https://raw.githubusercontent.com/singpolyma/singpolyma/master/uzbl/data/scripts/userscript.sh chmod +x "${XDG_DATA_HOME:-$HOME/.local/share}/uzbl/scripts/userscript.sh" echo '@on_event LOAD_COMMIT spawn @scripts_dir/userscript.sh document-start' >> "${XDG_CONFIG_HOME:-$HOME/.config}/uzbl/config" echo '@on_event LOAD_FINISH spawn @scripts_dir/userscript.sh document-end' >> "${XDG_CONFIG_HOME:-$HOME/.config}/uzbl/config" wget -P "${XDG_DATA_HOME:-$HOME/.local/share}/uzbl/userscripts" https://4chan-xl.kickin.rocks/builds/4chan-XL.user.js -
qutebrowser: Save the script to the
$XDG_DATA_HOME/qutebrowser/greasemonkeyor$HOME/.local/share/qutebrowser/greasemonkeydirectory:wget -P ${XDG_DATA_HOME:-$HOME/.local/share}/qutebrowser/greasemonkey https://4chan-xl.kickin.rocks/builds/4chan-XL.user.js
Install Tampermonkey, then click here to install 4chan XL.
4chan XL can be used in some browsers that do not support userscripts using a local proxy. Not all features will work.
New features and non-urgent bugfixes are released on the beta channel for further testing before they are moved the stable version. Please report any issues you find, and be sure to mention which version you're using. You should back up your settings regularly to prevent them from being lost due to bugs.
To install the beta version and get updates whenever there's a new beta version:
- Install userscript (use with Greasemonkey / Violentmonkey / Tampermonkey / JS Blocker / etc.)
To install the current beta version but get updates from the stable channel (for example, if just you want a particular recent feature):
If you encounter a bug, try the steps here, then report it to the issue tracker. If the bug seems to be caused by a script update, you can install a old version from the changelog.