# Joshi Koukousei Captcha Service - The captcha solver made by and for japanese high school girls!

Edit, 01.13.2024:
The addons work only partially.
The development is on indefinite hiatus.
Keep the above in mind before you install the addon or ask any questions.


[![Mozilla Add-on](https://img.shields.io/amo/v/jkcs?label=Firefox%20Add-on)](https://addons.mozilla.org/en-US/firefox/addon/jkcs/)
[![Chrome Web Store](https://img.shields.io/chrome-web-store/v/fppcpkioamnkpclnpcnnncnioegplgbf)](https://chrome.google.com/webstore/detail/joshi-koukousei-captcha-s/fppcpkioamnkpclnpcnnncnioegplgbf)

Tired of solving captchas all day? Don't want carpal tunnel syndrome young? Have dyslexia? Then Joshi Koukousei's Captcha Service is here for you!

## Screenshots

| ![auto-solving](showcase2.gif) |
|:--:|
|**JKCS in action**|

| ![manual-solving](showcase1.gif) |
|:--:|
|**JKCS in action — Solve button showcase**|

How to Install
==============

## Chromium - CWS method (requires Google account)
Joshi Koukousei Captcha Service is available on the [Chrome Web Store!](https://chrome.google.com/webstore/detail/joshi-koukousei-captcha-s/fppcpkioamnkpclnpcnnncnioegplgbf)
## Chromium - Side-load method (no Google account required)
- [Download](https://git.coom.tech/attachments/a0f1e7f8-980d-40be-afa1-15481fb0c731) the extension zip and extract it somewhere
- Type `chrome://extensions` in your address bar
- Enable **Developer Mode**
- Click on **Load Unpacked**
- Select the `chrome` folder from the zip you extracted earlier.

## Firefox
Joshi Koukousei Captcha Service is available on the [Firefox AWO!](https://addons.mozilla.org/en-US/firefox/addon/jkcs/)

How to Build
==============

Be sure that git-lfs is installed or the extension will NOT work.

Install [NodeJS](https://nodejs.org/) if you haven't already, I personally use the latest version of Node (v18 at the time of writing) on Linux x64.

Install [PNPM](https://pnpm.io/)

Run ``pnpm install`` in this directory, then run ``pnpm run build_ff`` or ``pnpm run build_chrome`` depending on your browser of choice. build_ff will create an unsigned Firefox .xpi addon, while build_chrome will create an extension directory that can be side-loaded in Developer mode.

Acknowledgements
==============

This is a fork of https://github.com/AUTOMATIC1111/4chan-captcha-solver that focuses on optimized performance. During testing JKCS has proven to be objectively faster than AUTOMATIC1111's userscript version, achieving instantanous captcha solving on both Chromium and Firefox.

License
==============
MIT No Attribution

Copyright 2022 You

Permission is hereby granted, free of charge, to any person obtaining a copy of this
software and associated documentation files (the "Software"), to deal in the Software
without restriction, including without limitation the rights to use, copy, modify,
merge, publish, distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

--- SUBLICENSE ---

Copyright (C) 2022 /cumg/

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with this program; if not, write to the Free Software Foundation,
Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.