https://github.com/otacoo/8chanss
A userscript to add functionality to 8chan.
https://github.com/otacoo/8chanss
imageboard userscript
Last synced: 2 months ago
JSON representation
A userscript to add functionality to 8chan.
- Host: GitHub
- URL: https://github.com/otacoo/8chanss
- Owner: otacoo
- License: mit
- Created: 2025-04-24T01:31:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-08T01:01:22.000Z (2 months ago)
- Last Synced: 2026-04-08T02:20:12.626Z (2 months ago)
- Topics: imageboard, userscript
- Language: JavaScript
- Homepage:
- Size: 1.43 MB
- Stars: 11
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 8chanSS :beginner:
8chan Style Script, a userscript to add functionality to 8chan, heavily influenced by 4chanSS, 4chanX and StyleChan.
## [](https://github.com/otacoo/8chanSS/raw/refs/heads/main/builds/8chanSS.user.js)
### Install
First install a userscript manager:
- **Firefox**: Requires the [Violentmonkey](https://addons.mozilla.org/en-US/firefox/addon/violentmonkey/) addon.
- **Chrome**: Requires the [Violentmonkey](https://chromewebstore.google.com/detail/violentmonkey/jinjaccalgkegednnccohejagnlnfdag/) extension.
Then press the big install button to install the script.
### Configure
- Check in the 8chan header for the 8chanSS menu button
- Alternatively, press `CTRL` + `F1` to open the menu
### What it does:
- Catalog links for the header
- Image hover for catalog and thread images, videos and audio (new)
- Image Hover for spoilers
- Autoscroll page to last read post + unread line
- Sidebar
- Quick Reply to sidebar
- Blur or remove spoilers
- Beep on getting a (You)
- Custom text for (You) notification in the tab
- Improved styling of the site
- Adds a checkbox to the Quick Reply to save (or not save) the name field on refresh
- Hide Posting Form and Announcements
- Show full filename of media posts
- Style (You) posts (green for your posts & red for replies to you)
- Image Hover that follows the cursor
- Bottom Header
- Up/Down Arrows
- Pin Thread Watcher
- Hide/unhide threads in the catalog
- Mark/unmark posts as yours
- Show all posts by ID
More incoming...
### Keyboard Shortcuts:
CTRL + F1 : Open 8chanSS settings menu
CTRL + Enter : Submit post
Tab : Target Quick Reply text area
R : Refresh Thread (5 sec. cooldown)
Esc : Clear and close the Quick Reply
CTRL + Q : Toggle Quick Reply on/off
SHIFT + T : Toggle Quote Threading
ALT + W : Watch thread
CTRL + UP/DOWN Arrow : Scroll between Your replies
CTRL + SHIFT + UP/DOWN Arrow : Scroll between replies to (You)
CTRL + S : Add spoiler tags
ALT + C : Add code tags
CTRL + B : Add **bold** tags
CTRL + U : Add underline tags
CTRL + I : Add *italics* tags
CTRL + D : Add Srz Bizniz tags
CTRL + M : Add moe tags
### How to add boards to your header:
### How to block custom themes:
**Note:** Userscripts CANNOT block network requests directly.\
If you use uBlock Origin you can more directly prevent the custom CSS from loading altogether with the following:
Add this to uBlock's *My Filters* page and press Save Changes, then restart your browser.
```
! Block Custom Theme CSS on https://8chan.moe|se
||8chan.*/*/custom.css$css
```
### ~~Notification API~~ (currently removed due to site CSP)
8chanSS makes available a small API to call toast notifications on the page.
The API allows any script to call a notification, set a color (black, green, orange, red, blue) and duration in ms (default 1200 ms).
## Contributing
Read [Contributing](https://github.com/otacoo/8chanSS/blob/main/CONTRIBUTING.md#development--contribution) first to set up, fork the repo, then do a pull request to here.
#### Feature Request
Open a [new issue](https://github.com/otacoo/8chanSS/issues) and request a feature.
#### Reporting Bugs
Read [Reporting Bugs](https://github.com/otacoo/8chanSS/blob/main/CONTRIBUTING.md#reporting-bugs-and-suggestions) first if you have an issue and want to report a bug.
#### Credits
- bapao1, for help and insight
- vfyxe, for FullchanX and discussion
- impregnator, for Hash Navigation code
- All the Anons who contributed with code, help, feature requests and bug reports