4chan-x/index.html
2015-06-28 12:54:43 -07:00

92 lines
8.7 KiB
HTML

<!doctype html>
<html><head>
<meta charset="utf-8">
<title>4chan X</title>
<link rel="stylesheet" href="web.css">
<link rel="icon" href="src/General/img/icon.gif">
<link rel="chrome-webstore-item" href="https://chrome.google.com/webstore/detail/ohnjgmpcibpbafdlkimncjhflgedgpam">
</head><body>
<div id="header">
<h1 id="4chan-x">4chan X</h1>
<div id="links">
<a href="https://github.com/ccd0/4chan-x">Source Code</a>
<a href="https://github.com/ccd0/4chan-x/blob/master/CHANGELOG.md">Changelog</a>
<a href="https://github.com/ccd0/4chan-x/wiki/Frequently-Asked-Questions">FAQ</a>
<a href="https://github.com/ccd0/4chan-x/issues">Report Bugs</a>
</div>
</div>
<a class="screenshot" href="img/screenshot.png"><img src="img/screenshot.png" alt="Screenshot"></a>
<p>Adds various features to 4chan.
Previously developed by <a href="https://github.com/aeosynth/4chan-x">aeosynth</a>, <a href="https://github.com/MayhemYDG/4chan-x">Mayhem</a>, <a href="https://github.com/ihavenoface/4chan-x">ihavenoface</a>, <a href="https://github.com/zixaphir/appchan-x">Zixaphir</a>, <a href="https://github.com/seaweedchan/4chan-x">Seaweed</a>, and <a href="https://github.com/Spittie/4chan-x">Spittie</a>, with contributions from many others.</p>
<p>If you&#39;re looking for a maintained fork of OneeChan (a style script used in addition to 4chan X), try
<a href="https://github.com/Nebukazar/OneeChan">https://github.com/Nebukazar/OneeChan</a>.</p>
<h2 id="firefox-version-click-to-install-https-ccd0-github-io-4chan-x-builds-4chan-x-user-js-">Firefox version: <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.user.js">Click to Install</a></h2>
<p>Install <a href="https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/">Greasemonkey</a>, then click the link above to install 4chan X.</p>
<p>Pale Moon users should use <a href="https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/versions/#version-1.15.1-signed">Greasemonkey 1.15</a>. A port for Seamonkey is available <a href="https://openuserjs.org/about/Greasemonkey-Port-for-SeaMonkey">here</a>; you may need to disable desktop notifications due to a <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1130502">known bug</a>.</p>
<p><strong>WARNING</strong>:
If you&#39;re switching to this fork from someone else&#39;s fork of 4chan X, back up your old script before installing this one as the old one may be overwritten.</p>
<p><strong>Known issues</strong>:
Greasemonkey 3.0 has a <a href="https://github.com/greasemonkey/greasemonkey/issues/2094">bug</a> causing 4chan X to open multiple tabs when you open a new tab (for example, when starting a thread). If you&#39;re having this problem, <a href="https://addons.mozilla.org/en-US/firefox/addon/greasemonkey/">updating</a> to Greasemonkey 3.1 or later should fix it.</p>
<h2 id="chromium-version-click-to-install-https-ccd0-github-io-4chan-x-builds-4chan-x-crx-">Chromium version: <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.crx">Click to Install</a></h2>
<p>Download the file from the link above and add drag it to your <code>chrome://extensions</code> page.
This should also work for Opera 21+, Chrome dev/canary, and Chrome on platforms other than Windows.</p>
<p><strong>The above will not work in Chrome (stable or beta) on Windows; you must install from the <a href="https://chrome.google.com/webstore/detail/4chan-x/ohnjgmpcibpbafdlkimncjhflgedgpam">Chrome store</a> as described below.</strong></p>
<h2 id="chromium-version-chrome-store-click-to-install-https-chrome-google-com-webstore-detail-4chan-x-ohnjgmpcibpbafdlkimncjhflgedgpam-">Chromium version (Chrome store): <a href="https://chrome.google.com/webstore/detail/4chan-x/ohnjgmpcibpbafdlkimncjhflgedgpam">Click to Install</a></h2>
<p>The stable and beta releases of Chrome on Windows will disable extensions not installed from the Chrome store, so users will need to install 4chan X from the link above.
Only the latest stable version of 4chan X is available.</p>
<h2 id="other-browsers">Other browsers</h2>
<p>4chan X can be used in other browsers, but not all features will work, and you should expect some bugs. In addition, I don&#39;t regularly test in these browsers, so updates may occasionally break the script. If this happens, <a href="https://github.com/ccd0/4chan-x/issues">open an issue</a>, and use an old version from the <a href="https://github.com/ccd0/4chan-x/blob/master/CHANGELOG.md">changelog</a> until it&#39;s fixed. You can also try <a href="https://github.com/loadletter/4chan-x">loadletter&#39;s fork</a> if you&#39;re having trouble getting this one to work.</p>
<p>In several WebKit browsers, there is currently an issue where 4chan X will crash the browser when repeatedly solving the default image-based captchas. Until this is resolved, it is recommended you enable <code>Use Recaptcha v1</code> in your settings.</p>
<ul>
<li><p><strong>dwb</strong>: Install the userscripts extension, then save the <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.user.js">script</a> to the <code>$XDG_CONFIG_HOME/dwb/greasemonkey</code> or <code>$HOME/.config/dwb/greasemonkey</code> directory (creating it if necessary):</p>
<pre><code> dwbem -N -i userscripts
wget -P ${XDG_CONFIG_HOME:-$HOME/.config}/dwb/greasemonkey/ https://ccd0.github.io/4chan-x/builds/4chan-X.user.js
</code></pre></li>
<li><p><strong>Midori</strong>: Enable <code>User addons</code> in your preferences, under the Extensions tab. In the Privacy tab, check <code>Enable HTML5 local storage support</code>. Optionally, if you want 4chan X to be able to open new tabs when you start or reply to a thread, you will need to check <code>Allow scripts to open popups</code> under the Behavior tab. Then click the link to the <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.user.js">script</a> to install it.</p>
</li>
<li><p><strong>Luakit</strong>: Navigate to the <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.user.js">script</a>, then type the command <code>:usi</code> to install it.</p>
</li>
<li><p><strong>Safari</strong>: Install <a href="http://jsblocker.toggleable.com/">JS Blocker</a>, then click the link to the <a href="https://ccd0.github.io/4chan-x/builds/4chan-X.user.js">script</a> to install it. Be aware that I do not have a practical way of testing the script in Safari at the moment. If you encounter problems, it would be useful to try to reproduce the problem in another browser.</p>
</li>
</ul>
<h2 id="beta-version">Beta version</h2>
<p>New features and non-urgent bugfixes are released on the beta channel for further testing before they are moved the stable version. Please <a href="https://github.com/ccd0/4chan-x/issues">report</a> any issues you find, and be sure to mention which version you&#39;re using. You should back up your settings regularly to prevent them from being lost due to bugs.</p>
<ul>
<li><a href="https://ccd0.github.io/4chan-x/builds/4chan-X-beta.user.js">Firefox version</a></li>
<li><a href="https://ccd0.github.io/4chan-x/builds/4chan-X-beta.crx">Chromium version</a></li>
</ul>
<p>If you want to install the current beta version but get updates from the stable channel after that, install it from <a href="https://github.com/ccd0/4chan-x/raw/beta/builds/4chan-X.user.js">here</a> for Firefox or <a href="https://github.com/ccd0/4chan-x/raw/beta/builds/4chan-X.crx">here</a> for Chromium.</p>
<h2 id="security-note">Security note</h2>
<p>4chan X currently shares your settings and post history between the HTTP and HTTPS versions of 4chan. If you are concerned about protecting your privacy against a man-in-the-middle attack, you should disable 4chan X on the HTTP version of 4chan and/or install <a href="https://www.eff.org/https-everywhere">HTTPS Everywhere</a>.</p>
<h2 id="uninstalling">Uninstalling</h2>
<p>4chan X disables the native extension, so if you uninstall 4chan X, you&#39;ll need to re-enable it. To do this, click the <code>[Settings]</code> link in the top right corner and uncheck &quot;<code>Disable the native extension</code>&quot; in the panel that appears.</p>
<script>
function imagePreview() {
this.removeEventListener('mouseover', imagePreview, false);
var img = new Image();
img.src = this.href;
img.alt = 'preview';
var span = document.createElement('span');
span.className = 'hover';
span.appendChild(img);
this.parentNode.insertBefore(span, this.nextSibling);
}
function storeInstall(e) {
if (!e.shiftKey && !e.altKey && !e.ctrlKey && !e.metaKey && e.button === 0) {
chrome.webstore.install();
e.preventDefault();
}
}
for (var i = 0; i < document.links.length; i++) {
var link = document.links[i];
if (/\.png$/.test(link.pathname) && !link.querySelector('.hover')) {
link.addEventListener('mouseover', imagePreview, false);
} else if (window.chrome && link.host === 'chrome.google.com') {
link.addEventListener('click', storeInstall, false);
}
}
</script>
</body></html>