{"id":26093082,"url":"https://github.com/matro7sh/yelaa","last_synced_at":"2026-01-12T02:57:44.588Z","repository":{"id":39650889,"uuid":"328524645","full_name":"matro7sh/Yelaa","owner":"matro7sh","description":"Obtain a clean-cut architecture at the launch of a mission and run some tests ( subdomain search, fuzzing, make screenshots on a given perimeter )","archived":false,"fork":false,"pushed_at":"2023-07-18T09:13:41.000Z","size":12245,"stargazers_count":25,"open_issues_count":7,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T07:52:31.915Z","etag":null,"topics":["go","golang","nuclei","pentest-scripts","pentest-tool","security"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matro7sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-01-11T02:12:36.000Z","updated_at":"2024-06-10T21:24:51.000Z","dependencies_parsed_at":"2023-11-22T01:17:25.115Z","dependency_job_id":null,"html_url":"https://github.com/matro7sh/Yelaa","commit_stats":null,"previous_names":["matro7sh/yelaa","cmepw/yelaa"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/matro7sh/Yelaa","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matro7sh%2FYelaa","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matro7sh%2FYelaa/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matro7sh%2FYelaa/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matro7sh%2FYelaa/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matro7sh","download_url":"https://codeload.github.com/matro7sh/Yelaa/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matro7sh%2FYelaa/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278351241,"owners_count":25972718,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","golang","nuclei","pentest-scripts","pentest-tool","security"],"created_at":"2025-03-09T11:22:18.028Z","updated_at":"2025-10-04T18:07:59.965Z","avatar_url":"https://github.com/matro7sh.png","language":"Go","readme":"# Yelaa\n\nObtain a clean-cut architecture at the launch of a mission and make some tests\n\n# Requirements\n\nYou need to have the chrome binary in your path:\n```\ngoogle-chrome\n```\n\nGo version: `1.20`\n\n# How to install\n\nManually :\n```bash\ngit clone https://github.com/CMEPW/Yelaa.git\ncd Yelaa\nmake compile\n```\n\nOr if you have set your GO path and all the requirements installed :\n```bash\ngo install github.com/CMEPW/Yelaa@latest\n```\n\nIn a Docker-container:\n```bash\n# Build docker container\nmake docker\n\n# Or\ndocker build -t yelaa \\\n\t\t--build-arg USER_ID=$(id -g) \\\n\t\t--build-arg GROUP_ID=$(id -u) \\\n\t\t.\n\n# create a file with your target\necho \"Some web addresses...\" \u003e targets.txt\n\n# run the container like so\ndocker run \\\n    --security-opt seccomp=unconfined \\\n    -v $PWD:/home/yelaa_user \\\n    yelaa \\\n    checkAndScreen -t /home/yelaa_user/targets.txt\n```\n\nIn Kali:\n```bash\n\nwget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb\n\nsudo  apt install ./google-chrome-stable_current_amd64.deb\n\nwget https://github.com/CMEPW/Yelaa/releases/download/v1.7.1/Yelaa_1.7.1_Linux_x86_64.tar.gz\n\ntar -xvf Yelaa_1.7.1_Linux_x86_64.tar.gz\n./Yelaa -h\n```\n\n# How to use\n\u003e-s is optional\nYou can run `Yelaa create -c \u003cclient\u003e -s \u003cPathToSharedFolder\u003e`\n\n## How to run scan\n\n`Yelaa scan -t \u003cPathToTargetFile\u003e`\n\n## Use http / socks proxy\n\n```bash\n# using a http proxy\nYelaa scan -p http://localhost:8080 -target ./targets.txt`\n\n# or, socks5 proxy\nYelaa scan -p socks5://localhost:9050 -target ./targets.txt`\n```\n\n\u003eFlag `-k` is available to skip tls configuration\n\n\u003ePlease prefer using socks5 as much as possible, as socks4 can fail depending on your go version\n\n## How to run osint on a domain\n\n`Yelaa osint -t ./targets.txt -p http://localhost:8080 --path /tmp`\n\nor\n\n`./Yelaa osint -d \u003cdomain\u003e`\n\nThis command use the default browser to open the dork page\nTo run osint command on several domains run `Yelaa osint -t targets.txt`\n\n## How to run httpx then gowitness\n\n`Yelaa checkAndScreen -t domains.txt`\n\n## Low fruits : Infrastructure Penetration Testing\n\n```bash\n# run scan on ports 80, 443, 8080 \u0026 8443\nnmap -T4 -Pn -p 80,443,8080,8443 --open -oA EvilCorp-24 192.168.1.0/24\n\n# fetch tcp open ports \u0026 put them in web-targets.txt\ncat *.gnmap | grep -i \"open/tcp\" | cut -d \" \" -f2 | sort -u \u003e web-targets.txt\n\n# run check-and-screen to quickly map infra\n./Yelaa checkAndScreen -t ./web-targets.txt\n```\n\n## Help\n\n```\nYelaa -h\n __   __         _\n \\ \\ / /   ___  | |   __ _    __ _\n  \\ V /   / _ \\ | |  / _` |  / _` |\n   | |   |  __/ | | | (_| | | (_| |\n   |_|    \\___| |_|  \\__,_|  \\__,_|\nObtain a clean-cut architecture at the launch of a mission and make some tests\n\nUsage:\n  create -c [client name] [flags]\n  create [command]\n\nAvailable Commands:\n  checkAndScreen Run httpx and gowitness\n  completion     Generate the autocompletion script for the specified shell\n  help           Help about any command\n  osint          Run subfinder, dnsx and httpx to find ips and subdomains of a specific domain\n  scan           It will run Nuclei templates, dirsearch and more.\n\nFlags:\n  -c, --client string         Client name\n      --dry-run               Run in dry-run mode\n  -e, --excludedType string   excluded type\n  -h, --help                  help for create\n  -k, --insecure              Allow insecure certificate\n      --nuclei                Enable nuclei with the command\n      --path string           Output path (default \"/home/$USER/.yelaa\")\n  -p, --proxy string          Add HTTP proxy\n      --rate-limit int32      Rate limitation for nuclei and gobuster (default 100)\n  -s, --shared string         path to shared folder\n\nUse \"create [command] --help\" for more information about a command.\nAll temporary file have been succesfully removed\n```\n\n\u003e This script will create a default structure using `create` command, as well as a cherytree database with payloads for external testing and useful commands for internal testing\n\n## run with Proxychains\n\n\u003e this is not the recommanded way to use a proxy! You can just specify a proxy with the `-p` option!\n\nIf you *must* run Yelaa through Proxychains, it is possible but will require a bit of tweaking.\nThe reason for that is that Yelaa is statically compiled, and `Proxychains` uses `LD_PRELOAD` tricks to set a proxy.\nYou will have to compile Yelaa dynamically, using `gcc-go` (you will have to [install it yourself](https://go.dev/doc/install/gccgo) before compiling):\n\n```bash\ngit clone https://github.com/CMEPW/Yelaa.git\n\ncd Yelaa\n\nmake dynamic\n```\n\n# Contributors\n\n| [\u003cimg src=\"https://github.com/darkweak.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003eDarkweak\u003c/sub\u003e](https://github.com/darkweak) | [\u003cimg src=\"https://github.com/jenaye.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003eMike Houziaux\u003c/sub\u003e](https://github.com/jenaye) | [\u003cimg src=\"https://github.com/jarrault.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003eJulien\u003c/sub\u003e](https://github.com/jarrault) | [\u003cimg src=\"https://github.com/TomChv.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003eTom Chauveau\u003c/sub\u003e](https://github.com/TomChv) | [\u003cimg src=\"https://github.com/bogdzn.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003ebogdan\u003c/sub\u003e](https://github.com/bogdzn)| [\u003cimg src=\"h[ttps://github.com/bogdzn](https://github.com/VidsSkids.png?size=85\" width=85\u003e\u003cbr\u003e\u003csub\u003eVidsSkids\u003c/sub\u003e]([https://github.com/bogdzn](https://github.com/VidsSkids))\n| :---: | :---: | :---: | :---: | :---: | :---: |\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatro7sh%2Fyelaa","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatro7sh%2Fyelaa","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatro7sh%2Fyelaa/lists"}