Last commit Commit activity Bugs Enhancements

Dollchan Extension Tools

[ ESNEXT USERSCRIPT ] — Firefox 77+, Chrome 85+, Opera 71+
[ ES5 USERSCRIPT ] — for old browsers
[ FIREFOX EXTENSION ]

[ English wiki ]
[ Russian wiki ]
[ Homepage ]
License: © 2023 Dollchan Extension Tools Team.See the LICENSE file for license rights and limitations (MIT).

Dollchan Extension is the userscript and extension that combines various options & features, making you hang out on imageboards in an easier and more convenient way. If you have visited sites like 4chan.org or 2ch.hk, then you probably already heard about it.

It provides such functions:

Sending posts without reloading page.
Thread updater with different types of alerts(for example, blinking favicon or desktop notification when new posts appear).
Hiding posts and threads by a wide choice of expressions and rules.
Saving threads entirely with the originals of pictures.
Preloading full pictures into memory buffer.
Expanding threads directly on the index page.
Adding interesting threads to your Favorites to track new posts or responses to your posts.
"Endless scrolling" of index pages with threads.
Easy navigation through >>links as a posts tree.
Embedding player to YouTube and Vimeo links.
Easy navigation through attached pictures / videos in posts.
Applying search services to pictures and stills from videos.
Reading metadata form webm files.
Adding pictures to the reply form with convenient preview thumbnails.
Posting pictures with random bytes added and custom names.
Embedding preview thumbnails to .jpg / .png / .gif links.
Adding your CSS rules.
Hotkeys for many functions.

... and many other features!

Dollchan has both cross-browser and cross-board working scope. A list of supported sites includes all imageboards based on Wakaba, Kusaba, Tinyboard, Vichan, TinyIB, LynxChan, FoolFuuka, their derivatives, or any other board engine that generates a html source parsable by the Dollchan, implying no critical changes were made by board maintainers.

Compilation:

Install Git and Node.js if not yet.
Install Gulp using Git:
npm rm -g gulp
npm install -g gulp-cli
Using Git, go to Dollchan repo and update dependencies:
npm install
Then you can make both ES5 and ESNext userscript versions from /src/modules by running:
gulp make
Or you can make ESNext version only:
gulp make:es6
Also you can make separate source modules from your ESNext version:
gulp make:modules

How to test an extension:

Chrome

Go to the extensions page by typing chrome://extensions/ in your browser's address bar,
disable your existing Dollchan extension if available.
Set the "Developer's mode" checkbox, press the "Load unpacked extension" button.
Select the path to /extension directory in your Dollchan repo.
If you don't have a Dollchan repo, download and unpack the repository archive from the last state.
Done.

Firefox

Go to the extensions page by typing about:addons in your browser's address bar,
disable your existing Dollchan extension if available.
Go to about:debugging#addons page, press the "Download temporary add-on…" button.
Open the /extension directory in your Dollchan repo and select the path to manifest.json file.
If you don't have a Dollchan repo, download and unpack the repository archive from the last state.
Done.

Firefox for Android

Install web-ext using Git:
npm install -g web-ext
Install Android Studio on your development computer.
Install Firefox for Android Nightly on your device.
Enable Android USB debugging on the device.
Attach your device to the development computer using a USB cable.
When prompted, allow USB debugging for the connection.
In the settings view for Firefox for Android Nightly, enable "Remote debugging via USB."
Run with Git:
web-ext run -t firefox-android --source-dir ./extension/v2 --adb-device XXX --firefox-apk org.mozilla.fenix
where XXX is the name of your device (it will be displayed if you enter XXX instead of the name, replace XXX with the given name and run the command again)