General enhancements

.gitignore

@@ -11,7 +11,7 @@
 
 # Output of the go coverage tool, specifically when used with LiteIDE
 *.out
-
+*.patch
 build/
 
 # path where comics are downloaded

.golangci.yml

@@ -0,0 +1,22 @@
+run:
+  timeout: 5m
+  tests: false
+  skip-dirs:
+    - comics
+
+linters:
+  enable:
+    - errcheck
+    - govet
+    - staticcheck
+    - gosimple
+    - ineffassign
+    - typecheck
+
+linters-settings:
+  errcheck:
+    check-type-assertions: true
+    check-blank: true
+
+issues:
+  exclude-use-default: false

.travis.yml

@@ -6,8 +6,10 @@ go:
 before_install:
   - sudo apt-get update
   - sudo apt install libgl1-mesa-dev xorg-dev
+  - go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.59.1
   - go install github.com/mattn/goveralls@latest
 
 script: 
+  - $(go env GOPATH)/bin/golangci-lint run
   - go test -v ./...
   - $GOPATH/bin/goveralls -service=travis-ci

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "gopls": {
+        "build.buildFlags": [
+            // "-tags=libjpeg"
+        ]
+    },
+}

AGENTS.md

@@ -0,0 +1,22 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+The project targets Go 1.23+ with a standard layout. `cmd/downloader` hosts the CLI entrypoint, while `cmd/gui` wraps the GUI built with Fyne; both depend on reusable packages under `pkg/`. Key subpackages include `pkg/core` for orchestration, `pkg/sites` for site-specific scrapers, and `pkg/util` for image and filesystem helpers. Supporting flag parsing and other internals live in `internal/`. Docs for contributors live in `docs/`, assets in `img/`, and release artifacts appear under `build/` when generated.
+
+## Build, Test, and Development Commands
+Run `go build -o ./bin/comics-downloader ./cmd/downloader` for a local CLI binary. The GUI can be built with `go build -o ./bin/comics-downloader-gui ./cmd/gui` once Fyne prerequisites are met. Cross-platform artifacts are automated via Make targets such as `make linux-x86-64-build` or the aggregate `make builds`. Use `fyne-cross windows -output comics-downloader-gui-windows.exe ./cmd/gui` when Docker-based cross-compilation is preferred. Static checks run via `make lint` (wraps `golangci-lint run` and matches CI), and `go test -v ./...` should pass before pushing; CI mirrors this command set and reports coverage with Coveralls.
+
+For sites with aggressive bot protections, you can rotate request headers using `--user-agents "UA1,UA2"` and forward cookies such as `cf_clearance` with `--session-cookie "cf_clearance=...; other=value"` when invoking the CLI.
+
+## Coding Style & Naming Conventions
+Format all Go files with `gofmt` (invoked via `go fmt ./...`) to preserve canonical tab-indented style and import ordering. Follow idiomatic Go naming: exported identifiers use CamelCase, unexported use camelCase, constants are ALL_CAPS only when enumerations require clarity. Keep packages small and cohesive; prefer descriptive filenames like `mangadex.go` aligning with the site handled. Log through the existing Logrus helpers to stay consistent with current output.
+
+## Testing Guidelines
+Place tests alongside implementation in `*_test.go` files, using table-driven cases where practical. Run targeted suites with `go test ./pkg/sites` during feature work, and use `go test -cover ./...` to ensure coverage does not regress—Coveralls tracks the master branch. When scraping new sources, add integration-style tests that stub HTTP calls where possible to keep the suite deterministic.
+
+## Commit & Pull Request Guidelines
+Commit subjects should be concise and imperative (`add`, `fix`, `update`), optionally prefixed with scopes like `fix:` as seen in history. Commit early and keep diffs focused; avoid mixing GUI and CLI changes in one commit. Pull requests must target `master`, include a brief summary of the change, reference related issues, and note how to reproduce or test the update (logs, commands, screenshots for GUI tweaks). Ensure tests pass locally before requesting review.
+
+## Security & Configuration Tips
+- Use `--user-agents` to supply a comma-separated list of desktop/mobile agents; the downloader rotates them per request.
+- When Cloudflare or other shields require clearance cookies, reuse your browser session via `--session-cookie` so authenticated requests succeed.

Makefile

@@ -1,39 +1,42 @@
+BUILD_TAGS ?=
+GO_BUILD_TAG_FLAGS := $(if $(strip $(BUILD_TAGS)),-tags "$(BUILD_TAGS)",)
+
 help: # this command
 	# [generating help from tasks header]
 	@egrep '^[A-Za-z0-9_-]+:' Makefile
 
 osx-build-arm: # Creates Mac OSX
-	@GOOS=darwin go build -o build/comics-downloader-osx-arm ./cmd/downloader
+	@GOOS=darwin go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-osx-arm ./cmd/downloader
 
 osx-build-x86-64: # Creates Mac OSX
-	@GOOS=darwin GOARCH=amd64 go build -o build/comics-downloader-osx-x86-64 ./cmd/downloader
+	@GOOS=darwin GOARCH=amd64 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-osx-x86-64 ./cmd/downloader
 
 windows-x86-64-build: # Creates Windows
-	@GOOS=windows GOARCH=amd64 go build -o build/comics-downloader-win-x86-64.exe ./cmd/downloader
+	@GOOS=windows GOARCH=amd64 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-win-x86-64.exe ./cmd/downloader
 
 windows-386-build: # Creates Windows
-	@GOOS=windows GOARCH=386 go build -o build/comics-downloader-win-386.exe ./cmd/downloader
+	@GOOS=windows GOARCH=386 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-win-386.exe ./cmd/downloader
 
 linux-x86-64-build: # Creates Linux
-	@GOOS=linux GOARCH=amd64 go build -o build/comics-downloader-linux-x86-64 ./cmd/downloader
+	@GOOS=linux GOARCH=amd64 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-linux-x86-64 ./cmd/downloader
 
 linux-386-build:
-	@GOOS=linux GOARCH=386 go build -o build/comics-downloader-linux-386 ./cmd/downloader
+	@GOOS=linux GOARCH=386 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-linux-386 ./cmd/downloader
 
 linux-arm-build: # Creates Linux ARM
-	@GOOS=linux GOARCH=arm go build -o build/comics-downloader-linux-arm ./cmd/downloader
+	@GOOS=linux GOARCH=arm go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-linux-arm ./cmd/downloader
 
 linux-arm64-build: # Creates Linux ARM64
-	@GOOS=linux GOARCH=arm64 go build -o build/comics-downloader-linux-arm64 ./cmd/downloader
+	@GOOS=linux GOARCH=arm64 go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-linux-arm64 ./cmd/downloader
 
 osx-gui-build: # Creates osx GUI
-	@GOOS=darwin go build -o build/comics-downloader-gui-osx ./cmd/gui
+	@GOOS=darwin go build $(GO_BUILD_TAG_FLAGS) -o build/comics-downloader-gui-osx ./cmd/gui
 
 windows-gui-build: # Creates Window GUI executable
-	@fyne-cross windows -output comics-downloader-gui-windows.exe ./cmd/gui
+	@fyne-cross windows -output comics-downloader-gui-windows.exe $(GO_BUILD_TAG_FLAGS) ./cmd/gui
 
 linux-gui-build: # Creates Linux Gui executable
-	@fyne-cross linux -output comics-downloader-gui ./cmd/gui
+	@fyne-cross linux -output comics-downloader-gui $(GO_BUILD_TAG_FLAGS) ./cmd/gui
 
 builds: # Creates executables for OSX/Windows/Linux
 	@make linux-386-build
@@ -50,3 +53,6 @@ builds: # Creates executables for OSX/Windows/Linux
 
 remove-builds: # Remove executables
 	@rm -rf build/
+
+lint: # Run static analysis
+	@golangci-lint run

README.md

@@ -14,7 +14,7 @@
 - https://readcomiconline.li/  ⚠️
 - https://www.mangareader.tv/  ⚠️
 - https://www.mangatown.com/   ⚠️
-- https://mangadex.org/        ⚠️
+- https://mangadex.org/        
 - https://mangakakalot.com/    ⚠️
 - https://manganato.com/       ⚠️
 
@@ -199,6 +199,16 @@ Default is **jpg**.
 ./comics-downloader -url=[your url] -images-only -images-format=jpg
 ```
 
+### Work Around Site Protection
+
+Some sources employ rotating fingerprints or require a logged-in session. You can rotate multiple User-Agent strings and forward session cookies collected from your browser:
+
+```bash
+./comics-downloader -url=[your url] \
+  --user-agents="Mozilla/5.0 ...,Mozilla/5.0 (Macintosh; ...)" \
+  --session-cookie="cf_clearance=...; other=value"
+```
+
 ### Avoid Default Folder Structure
 
 The default folder structure that will be created is: