Go Captcha

Behavior Captcha

English | 中文

Go Captcha is a behavior CAPTCHA, which implements click mode, slider mode, drag-drop mode and rotation mode.

⭐️ If it helps you, please give a star.

GoCaptcha：https://github.com/wenlng/go-captcha
GoCaptcha Document：http://gocaptcha.wencodes.com
Go Assets File：https://github.com/wenlng/go-captcha-assets
Example Project：https://github.com/wenlng/go-captcha-example
Online Demo：http://gocaptcha.wencodes.com/demo
Javascript Library：https://github.com/wenlng/go-captcha-jslib
Vue Package：https://github.com/wenlng/go-captcha-vue
React Package：https://github.com/wenlng/go-captcha-react
Angular Package：https://github.com/wenlng/go-captcha-angular
Svelte Package：https://github.com/wenlng/go-captcha-svelte
Solid Package：https://github.com/wenlng/go-captcha-solid
...

Install Module

$ go get -u github.com/wenlng/go-captcha/v2@latest

Import Module

package main

import "github.com/wenlng/go-captcha/v2"

func main(){
   // ...
}

🖖 Click Mode

Quick Use

package main

import (
	"encoding/json"
	"fmt"
	"image"
	"log"
	"io/ioutil"

	"github.com/golang/freetype"
	"github.com/golang/freetype/truetype"
	"github.com/wenlng/go-captcha/v2/base/option"
	"github.com/wenlng/go-captcha/v2/click"
	"github.com/wenlng/go-captcha/v2/base/codec"
)

var textCapt click.Captcha

func init() {
	builder := click.NewBuilder(
		click.WithRangeLen(option.RangeVal{Min: 4, Max: 6}),
		click.WithRangeVerifyLen(option.RangeVal{Min: 2, Max: 4}),
	)

	// You can use preset material resources：https://github.com/wenlng/go-captcha-assets
	fontN, err := loadFont("../resources/fzshengsksjw_cu.ttf")
	if err != nil {
		log.Fatalln(err)
	}

	bgImage, err := loadPng("../resources/bg.png")
	if err != nil {
		log.Fatalln(err)
	}

	builder.SetResources(
		click.WithChars([]string{
			"1A",
			"5E",
			"3d",
			"0p",
			"78",
			"DL",
			"CB",
			"9M",
			// ...
		}),
		click.WithFonts([]*truetype.Font{
			fontN,
		}),
		click.WithBackgrounds([]image.Image{
			bgImage,
		}),
	)

	textCapt= builder.Make()
}

func loadPng(p string) (image.Image, error) {
	imgBytes, err := ioutil.ReadFile(p)
	if err != nil {
		return nil, err
	}
	return codec.DecodeByteToPng(imgBytes)
}

func loadFont(p string) (*truetype.Font, error) {
	fontBytes, err := ioutil.ReadFile(p)
	if err != nil {
		panic(err)
	}
	return freetype.ParseFont(fontBytes)
}


func main() {
	captData, err := textCapt.Generate()
	if err != nil {
		log.Fatalln(err)
	}

	dotData := captData.GetData()
	if dotData == nil {
		log.Fatalln(">>>>> generate err")
	}

	dots, _ := json.Marshal(dotData)
	fmt.Println(">>>>> ", string(dots))

	var mBase64, tBase64 string
	mBase64, err = captData.GetMasterImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}
	tBase64, err = captData.GetThumbImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}
	
	fmt.Println(">>>>> ", mBase64)
	fmt.Println(">>>>> ", tBase64)
	
	//err = captData.GetMasterImage().SaveToFile("../resources/master.jpg", option.QualityNone)
	//if err != nil {
	//	fmt.Println(err)
	//}
	//err = captData.GetThumbImage().SaveToFile("../resources/thumb.png")
	//if err != nil {
	//	fmt.Println(err)
	//}
}

Make Instance

builder.Make()
builder.MakeWithShape()

Configuration Options

click.NewBuilder(click.WithXxx(), ...) OR builder.SetOptions()(click.WithXxx(), ...)

click.WithImageSize(option.Size)
click.WithRangeLen(option.RangeVal)
click.WithRangeAnglePos([]option.RangeVal)
click.WithRangeSize(option.RangeVal)
click.WithRangeColors([]string)
click.WithDisplayShadow(bool)
click.WithShadowColor(string)
click.WithShadowPoint(option.Point)
click.WithImageAlpha(float32)
click.WithUseShapeOriginalColor(bool)
click.WithThumbImageSize(option.Size)
click.WithRangeVerifyLen(option.RangeVal)
click.WithDisabledRangeVerifyLen(bool)
click.WithRangeThumbSize(option.RangeVal)
click.WithRangeThumbColors([]string)
click.WithRangeThumbBgColors([]string)
click.WithIsThumbNonDeformAbility(bool)
click.WithThumbBgDistort(int)
click.WithThumbBgCirclesNum(int)
click.WithThumbBgSlimLineNum(int)

Set Resources

builder.SetResources(click.WithXxx(), ...)

click.WithChars([]string)
click.WithShapes(map[string]image.Image)
click.WithFonts([]*truetype.Font)
click.WithBackgrounds([]image.Image)
click.WithThumbBackgrounds([]image.Image)

Captcha Data

GetData() map[int]*Dot
GetMasterImage() imagedata.JPEGImageData
GetThumbImage() imagedata.PNGImageData

🖖 Slider Or Drag-Drop Mode

Quick Use

package main

import (
	"encoding/json"
	"fmt"
	"image"
	"log"
	"io/ioutil"

	"github.com/wenlng/go-captcha/v2/base/option"
	"github.com/wenlng/go-captcha/v2/slide"
	"github.com/wenlng/go-captcha/v2/base/codec"
)

var slideTileCapt slide.Captcha

func init() {
	builder := slide.NewBuilder()

	// You can use preset material resources：https://github.com/wenlng/go-captcha-assets
	bgImage, err := loadPng("../resources/bg.png")
	if err != nil {
		log.Fatalln(err)
	}

	bgImage1, err := loadPng("../resources/bg1.png")
	if err != nil {
		log.Fatalln(err)
	}

	graphs := getSlideTileGraphArr()

	builder.SetResources(
		slide.WithGraphImages(graphs),
		slide.WithBackgrounds([]image.Image{
			bgImage,
			bgImage1,
		}),
	)

	slideTileCapt = builder.Make()
}

func getSlideTileGraphArr() []*slide.GraphImage {
	tileImage1, err := loadPng("../resources/tile-1.png")
	if err != nil {
		log.Fatalln(err)
	}

	tileShadowImage1, err := loadPng("../resources/tile-shadow-1.png")
	if err != nil {
		log.Fatalln(err)
	}
	tileMaskImage1, err := loadPng("../resources/tile-mask-1.png")
	if err != nil {
		log.Fatalln(err)
	}

	return []*slide.GraphImage{
		{
			OverlayImage: tileImage1,
			ShadowImage:  tileShadowImage1,
			MaskImage:    tileMaskImage1,
		},
	}
}

func main() {
	captData, err := slideTileCapt.Generate()
	if err != nil {
		log.Fatalln(err)
	}

	blockData := captData.GetData()
	if blockData == nil {
		log.Fatalln(">>>>> generate err")
	}

	block, _ := json.Marshal(blockData)
	fmt.Println(">>>>>", string(block))

	var mBase64, tBase64 string
	mBase64, err = captData.GetMasterImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}
	tBase64, err = captData.GetTileImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(">>>>> ", mBase64)
	fmt.Println(">>>>> ", tBase64)
	
	//err = captData.GetMasterImage().SaveToFile("../resources/master.jpg", option.QualityNone)
	//if err != nil {
	//	fmt.Println(err)
	//}
	//err = captData.GetTileImage().SaveToFile("../resources/thumb.png")
	//if err != nil {
	//	fmt.Println(err)
	//}
}

func loadPng(p string) (image.Image, error) {
	imgBytes, err := ioutil.ReadFile(p)
	if err != nil {
		return nil, err
	}
	return codec.DecodeByteToPng(imgBytes)
}

Make Instance

builder.Make()
builder.MakeWithRegion()

Configuration Options

slide.NewBuilder(slide.WithXxx(), ...) OR builder.SetOptions(slide.WithXxx(), ...)

slide.WithImageSize(*option.Size)
slide.WithImageAlpha(float32)
slide.WithRangeGraphSize(val option.RangeVal)
slide.WithRangeGraphAnglePos([]option.RangeVal)
slide.WithGenGraphNumber(val int)
slide.WithEnableGraphVerticalRandom(val bool)
slide.WithRangeDeadZoneDirections(val []DeadZoneDirectionType)

Set Resources

builder.SetResources(slide.WithXxx(), ...)

slide.WithBackgrounds([]image.Image)
slide.WithGraphImages(images []*GraphImage)

Captcha Data

GetData() *Block
GetMasterImage() imagedata.JPEGImageData
GetTileImage() imagedata.PNGImageData

🖖 Rotation Mode

Quick Use

package main

import (
	"encoding/json"
	"fmt"
	"image"
	"log"
	"io/ioutil"

	"github.com/wenlng/go-captcha/v2/rotate"
	"github.com/wenlng/go-captcha/v2/base/codec"
)

var rotateCapt rotate.Captcha

func init() {
	builder := rotate.NewBuilder()

	// You can use preset material resources：https://github.com/wenlng/go-captcha-assets
	bgImage, err := loadPng("../resources/bg.png")
	if err != nil {
		log.Fatalln(err)
	}

	bgImage1, err := loadPng("../resources/bg1.png")
	if err != nil {
		log.Fatalln(err)
	}

	builder.SetResources(
		rotate.WithImages([]image.Image{
			bgImage,
			bgImage1,
		}),
	)

	rotateCapt = builder.Make()
}

func main() {
	captData, err := rotateCapt.Generate()
	if err != nil {
		log.Fatalln(err)
	}

	blockData := captData.GetData()
	if blockData == nil {
		log.Fatalln(">>>>> generate err")
	}

	block, _ := json.Marshal(blockData)
	fmt.Println(">>>>>", string(block))

	var mBase64, tBase64 string
	mBase64, err = captData.GetMasterImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}
	tBase64, err = captData.GetThumbImage().ToBase64()
	if err != nil {
		fmt.Println(err)
	}

	fmt.Println(">>>>> ", mBase64)
	fmt.Println(">>>>> ", tBase64)
	
	//err = captData.GetMasterImage().SaveToFile("../resources/master.png")
	//if err != nil {
	//	fmt.Println(err)
	//}
	//err = captData.GetThumbImage().SaveToFile("../resources/thumb.png")
	//if err != nil {
	//	fmt.Println(err)
	//}
}

func loadPng(p string) (image.Image, error) {
	imgBytes, err := ioutil.ReadFile(p)
	if err != nil {
		return nil, err
	}
	return codec.DecodeByteToPng(imgBytes)
}

Make Instance

builder.Make()

Configuration Options

rotate.NewBuilder(rotate.WithXxx(), ...) OR builder.SetOptions(rotate.WithXxx(), ...)

rotate.WithImageSquareSize(val int)
rotate.WithRangeAnglePos(vals []option.RangeVal)
rotate.WithRangeThumbImageSquareSize(val []int)
rotate.WithThumbImageAlpha(val float32)

Set Resources

builder.SetResources(rotate.WithXxx(), ...)

rotate.WithBackgrounds([]image.Image)

Captcha Data

GetData() *Block
GetMasterImage() imagedata.PNGImageData
GetThumbImage() imagedata.PNGImageData

Captcha Image Data

Object Method Of JPEGImageData

Get() image.Image
ToBytes() ([]byte, error)
ToBytesWithQuality(imageQuality int) ([]byte, error)
ToBase64() (string, error)
ToBase64Data() (string, error)
ToBase64WithQuality(imageQuality int) (string, error)
ToBase64DataWithQuality(imageQuality int) (string, error)
SaveToFile(filepath string, quality int) error

Object Method Of PNGImageData

Get() image.Image
ToBytes() ([]byte, error)
ToBase64() (string, error)
ToBase64Data() (string, error)
SaveToFile(filepath string) error

Install Package

JavaScript
Vue
React
Angular
Svelte
Solid
MinProgram
UniApp
Flutter App
Android App
IOS App
...

LICENSE

Go Captcha source code is licensed under the Apache Licence, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0.html

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Go Captcha

Install Module

Import Module

🖖 Click Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

🖖 Slider Or Drag-Drop Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

🖖 Rotation Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

Captcha Image Data

Object Method Of JPEGImageData

Object Method Of PNGImageData

Install Package

LICENSE

Files

README.md

Latest commit

History

README.md

File metadata and controls

Go Captcha

Install Module

Import Module

🖖 Click Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

🖖 Slider Or Drag-Drop Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

🖖 Rotation Mode

Quick Use

Make Instance

Configuration Options

Set Resources

Captcha Data

Captcha Image Data

Object Method Of JPEGImageData

Object Method Of PNGImageData

Install Package

LICENSE