Frequently Asked Questions
There is an effort underway to make 4chan X work on imageboards based on Tinyboard, its successor software vichan, and the derivatives of vichan such as NPFchan and lainchan. This may be extended to other imageboard software in the future. Only a subset of 4chan X's features are available so far, but that subset is increasing. On some of the more active imageboards, 4chan X is now enabled by default.
To enable 4chan X on another imageboard for yourself, add the site to the user @match rules. You must be using the userscript version of 4chan X, not the Chrome extension. In the instructions below, replace "https://examplechan.com/" with the site you want to add:
- for Violentmonkey: Open the Violentmonkey settings page and find 4chan X. Click the edit button (looks like
</>). Go to the "Settings" tab and enterhttps://examplechan.com/*in the "@match rules" field. Click save. - for Tampermonkey: Open the Tampermonkey settings page, go to the "Installed userscripts" tab, and find 4chan X. Click the edit button (pencil on paper). Go to the "Settings" tab and click the "Add" button below "User matches". Enter
https://examplechan.com/*. - for Greasemonkey 4: In the Greasemonkey menu, select "4chan X", then "User script options". Add
https://examplechan.com/*under "User matches". - for Greasemonkey 3: Go to the "User Scripts" tab of about:addons, find 4chan X, and click "Options". On the "User Settings" tab, click the "Add" button next to "Matched Pages". Enter
https://examplechan.com/*. - If you are not auto-updating 4chan X, you can also edit the script, adding
// @match https://examplechan.com/*(recommended) or// @include https://examplechan.com/*(some browsers / script engines may not support@match) after the existing// @includelines.
To know if your site is using Tinyboard or vichan, look at the bottom of the page, where it should be noted. A large list of imageboards, including the software they use, is available at:
https://github.com/ccd0/imageboards.json/
This depends on how you have 4chan X installed. In the instructions below, replace "https://examplechan.com/" with the site you want to disable 4chan X on:
- for Violentmonkey: Open the Violentmonkey settings page and find 4chan X. Click the edit button (looks like
</>). Go to the "Settings" tab and enterhttps://examplechan.com/*in the "@exclude rules" field. Click save. - for Tampermonkey: Open the Tampermonkey settings page, go to the "Installed userscripts" tab, and find 4chan X. Click the edit button (pencil on paper). Go to the "Settings" tab, find the relevant entry under "Original includes", select it, and click "Add as User excludes".
- for Greasemonkey 4: In the Greasemonkey menu, select "4chan X", then "User script options". Add
https://examplechan.com/*under "User excludes". - for Greasemonkey 3: Go to the "User Scripts" tab of about:addons, find 4chan X, and click "Options". On the "Script Settings" tab, find the relevant entry under "Included Pages". Select it and click "Add as user exclude".
- for the Chrome extension: Go to
chrome://extensions/, find 4chan X, and click the "Details" button. Under "Permissions", select the sites you want 4chan X to be allowed to run on. - If you are using the userscript and not auto-updating 4chan X, you can also edit the script, deleting the relevant
// @includelines.
See the Captcha FAQ page.
I uninstalled 4chan X and now Quick Reply, inline expansion, quote previewing, and other features don't work. How do I fix it?
4chan X disables the native extension, so if you uninstall 4chan X, and you want to use the functionality of the native extension, 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.
I'm seeing multiple images when I expand an image and/or getting an error message saying "Failed to disable the native extension". How do I fix it?
Some browsers (Chrome and its clones including modern Firefox) make it difficult for a userscript to reliably disable 4chan's native extension if you periodically clear your cookies. Try adding the following filter in uBlock Origin:
||s.4cdn.org/js/extension.min.*.js$important
or if you use NoScript, try blocking scripts from *.4cdn.org.
Why is 4chan X telling me every image/video I try to post is corrupt?
Or: Why are thumbnails in the Quick Reply not showing up?
Or: Why am I getting errors when trying to edit files?
Or: Why isn't 4chan X working as a Violentmonkey script on Firefox?
Your ad blocker may be blocking blob: URIs on 4chan. You will need to add an exception to your filter lists to get all features of 4chan X to work properly. However, you should still be able to post the files regardless of the warning.
In uBlock Origin:
@@||4chan.org^*$csp=default-src 'self' * data: 'unsafe-inline' 'unsafe-eval'
In Adblock Plus:
@@|blob:$image,media,domain=4chan.org
For more info/help, see https://github.com/ccd0/4chan-x/issues/1417.
17 Sep 2018: Currently ad blockers using EasyList are causing this problem due to blocking all third-party AJAX requests on 4chan. Until it is resolved, you can add this to your filter list ("My Filters" tab in uBlock Origin):
@@||4cdn.org$xmlhttprequest,domain=4chan.org
This happens when 4chan X can't load the catalog JSON (a.4cdn.org/BOARD/catalog.json) for the board. Possible reasons:
- A connection error with your network happened. Try reloading the page.
- A temporary problem on 4chan's end. You may be able to get 4chan X to work by disabling the
JSON Indexoption. - Another extension, such as NoScript or your ad blocker, blocked 4chan X from loading the catalog JSON. See below for details.
- The web filter component of your antivirus is malfunctioning.
8 May 2017: If you are having connection errors when posting certain text, it is because of an extra captcha Cloudflare wants you to solve before allowing your post to go through to 4chan. It is not yet integrated correctly with 4chan yet (CORS headers are missing). To make your post go through, you will need to use the post form at the top of the page (click the "[Original Form]" link).
Either 4chan X was not able to post, or it did not receive a response from 4chan after posting. Possible reasons:
- A connection error with
sys.4chan.orgor with your network happened. You should update the thread to check if your post got through before retrying, as sometimes 4chan will accept the post but fail to send a confirmation message. - Another extension, such as NoScript or your ad blocker, blocked 4chan X from posting. See below for details. The relevant URL is
https://sys.4chan.org/BOARD/post. - The web filter component of your antivirus is malfunctioning.
- The file you're trying to post has been deleted or otherwise ceased to exist.
In some cases, turning off the Show Upload Progress option may help with connection errors. If you are in Russia and have been having connection errors recently, try this.
If you don't know the URL that's being blocked, try bringing up the developer tools (usually with F12), navigating to the console, and looking for an error or errors starting with 4chan X failed to load:. In Chromium-based browsers, you can also look for Failed to load resource: net::ERR_BLOCKED_BY_CLIENT, but not all such errors will be related to 4chan X.
If you are using NoScript, allow the domain of the URL that was blocked.
If you are using an ad blocker, you may need to add an exception rule for the URL that was blocked.
If you don't know the extension causing the problem, temporarily disable all other extensions, and turn them on one by one until you find the extension responsible.
Desktop Notifications is enabled in your 4chan X settings, but you have yet to allow it in your browser's settings. You must grant permission individually on http://boards.4chan.org and https://boards.4chan.org for 4chan X to show notifications there.
If you allow desktop notifications, 4chan X will show notifications
- When someone replies to you
- When the Quick Reply encounters a posting error in another tab/window
If you don't want desktop notifications, select Disable in the popup or turn off Desktop Notifications in your settings.
This is generally caused by your computer's time zone being set wrong.
Due to a recent history of ads on 4chan causing unwanted behavior such as redirecting to other sites, 4chan X blocks unnecessary Javascript. The efficacy of 4chan X's blocking varies from browser to browser, and the use of an ad blocker is still recommended.
If you want to unblock just the top banner ads which 4chan has always had, add or uncomment these lines in the Javascript Whitelist field at the bottom of the Advanced tab in your settings:
http://s.zkcdn.net/ados.js
https://s.zkcdn.net/ados.js
http://engine.4chan-ads.org
https://engine.4chan-ads.org
In your ad blocker, you can unblock the top banner ads by adding these exception rules to your filter list:
@@||s.zkcdn.net/ados.js$script,domain=boards.4chan.org
@@||engine.4chan-ads.org/ados$script,domain=boards.4chan.org
@@||s.zkcdn.net/Advertisers$image,domain=boards.4chan.org
@@||static.4chan-ads.org/Advertisers$image,domain=boards.4chan.org
boards.4chan.org#@#.topad
boards.4chan.org#@#[width="468"]
boards.4chan.org#@#[width="728"]
To unhide the board banners, add this to your filter list:
boards.4chan.org#@#.middlead
Uncheck Fixed Header
Uncheck Custom Board Navigation
Disable Updater and Stats in Header
You should update. As of v1.1.13, the watcher is now hidden until the [Watcher] shortcut is clicked. This means it won't be following you around the page, and you can bring it up only when you want. As of v1.1.16, you can also enable the Persistent Thread Watcher option if you want the old behavior.
.watch-thread-link {
background-image: url('data:image/gif;base64,R0lGODlhEAAQAJEAAAAAAP///9vb2////yH5BAEAAAMALAAAAAAQABAAAAIvnI+pq+D9DBAUoFkPFnbs7lFZKIJOJJ3MyraoB14jFpOcVMpzrnF3OKlZYsMWowAAOw==') !important;
opacity: 1 !important;
}
.watch-thread-link.watched {
background-image: url('//static.4chan.org/image/favicon-ws.ico') !important;
}
Everyone is encouraged to review the source code of 4chan X to make sure it's not doing anything unwanted, either by malice or incompetence. If you find anything amiss, please report it.
4chan X doesn't spy on you or sell information to third parties. For detailed information, see the Privacy page.