Skip to content


Repository files navigation

Current version - 5.9.3

If you want to talk directly with me about stuff feel free to visit my technical support Discord server

Jan 2021 Update - Updated Oneechan to 5.9.3. New waifu (Makima)

Jan 2020 Update - Updated OneeChan to 5.9.2. Added more font options (fonts must be installed on your system), all available mascots have been ported over to a new host (, and a new user theme has been added (Stalenhag)

Jul 2019 Update 3 - The issue of if the previously selected mascot was the last mascot on the list and a mascot was removed, OneeChan fails to start with error "TypeError 'mascot' is undefined" in the browser console has been fixed

Jul 2019 Update 2 - Mascots changing after updates were due to removal or additions not added to the bottom of the list, changing the order of mascots and therefore changing your selection. This update should be the last time your mascots are changed. See #18 for full explanation

Jul 2019 Update - Put some mascots into new final image host,

Jun 2019 Update - Added a new mascot, will be working on putting all the mascots in a new host

Apr 2019 Update - Made it possible to move around the reply box

Mar 2019 Update - Switching image host to GitHub as the old host is gone

Nov 2018 Update - Updated for support for for the SFW boards


OneeChan is a userscript that functions on top of 4chan X and allows you to customize the site with various functions, themes and mascots. Mascots are not obligatory and can be changed or disabled altogether.

Originally developed by seaweedchan, this fork adds compatibility with various 4chan X versions and more custom options.

Install instructions

Installing 4chan X is required for Oneechan to work.

  • Firefox: Requires the Violentmonkey extension. Click the Install link above.

  • Chrome: Requires the Tampermonkey extension. Click the Install link above.

  • Pale Moon: Requires the Greasemonkey extension. Click the Install link above.

  • MS Edge: Requires the Tampermonkey extension. Click the Install link above.

  • MS Edge Chromium: Requires the Tampermonkey extension. Click the Install link above.

  • Safari: Requires the Tampermonkey extension. Click the Install link above.

An optional script I would recommend is a (You) counter - All-Time-You-Count

Adblock/pihole filters fix:

Add this to your filters list:

@@||^*$csp=default-src 'self' * data: 'unsafe-inline' 'unsafe-eval'
@@||^*$csp=default-src 'self' * data: 'unsafe-inline' 'unsafe-eval'

if you are encountering this error (can be seen with any theme):


Compatibility with 4chan X forks and others:

(Updated 2023-04-10)

  • ccd0 /// Compatible (Recommended)

ccd0's 4chan X is the recommended 4chan X version and the one OneeChan is primarily developed for. If you use another 4chan X version, please make sure you select your fork version under Compatibility in OneeChan options. Enabling Quick Reply, Persistent QR and Auto Hide QR in 4chan X is recommended for maximum compatibility.


  • If you have any problems, try first resetting your 4chan X and OneeChan settings and restarting your browser

  • Check if it's not a 4chan X issue first, OneeChan mostly deals with stylesheets not site functionality

  • Something doesn't work let me know in the Issues page

  • Please refer to the Wiki for instructions (this is currently empty)

  • If you are having issues with mascots saving or resetting, please manually select 'Select none' and save, fully refresh the page or exit, and reload it. Reselect your mascots manually, this should fix any issue with mascot settings not saving.

Development & Contribution

Settings I use (seen in screenshots)

4chan X


Just import them and it'll ask to reload the page.