{"id":25658899,"url":"https://github.com/nsecho/lateralus","last_synced_at":"2025-04-19T15:56:52.065Z","repository":{"id":52170114,"uuid":"302323997","full_name":"NSEcho/lateralus","owner":"NSEcho","description":"Lateralus is terminal based phishing campaign tool","archived":false,"fork":false,"pushed_at":"2023-02-25T11:50:37.000Z","size":145,"stargazers_count":26,"open_issues_count":3,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-29T09:51:12.330Z","etag":null,"topics":["go","golang","lateralus","modlishka","phishing-campaigns","smtp"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NSEcho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-08T11:51:53.000Z","updated_at":"2025-02-24T10:41:08.000Z","dependencies_parsed_at":"2024-06-20T10:19:30.132Z","dependency_job_id":"e9702f21-f5c4-470e-ab29-f29a066b1d63","html_url":"https://github.com/NSEcho/lateralus","commit_stats":null,"previous_names":["lateralusd/lateralus"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSEcho%2Flateralus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSEcho%2Flateralus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSEcho%2Flateralus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NSEcho%2Flateralus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NSEcho","download_url":"https://codeload.github.com/NSEcho/lateralus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249731679,"owners_count":21317343,"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","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","lateralus","modlishka","phishing-campaigns","smtp"],"created_at":"2025-02-24T00:29:46.139Z","updated_at":"2025-04-19T15:56:52.045Z","avatar_url":"https://github.com/NSEcho.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lateralus\n\n[![Latest Release](https://img.shields.io/github/release/lateralusd/lateralus.svg)](https://github.com/lateralusd/lateralus/releases)\n[![Go ReportCard](https://goreportcard.com/badge/lateralusd/lateralus)](https://goreportcard.com/report/lateralusd/lateralus)\n[![GoDoc](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/lateralusd/lateralus)\n\nTerminal based phishing campaign tool.\n\n## What is Lateralus and why?\n\nLateralus is tool built to help with phishing campaigns. It has a lot of customizable report and template injection points for your emails. In the future it will also provide integration with Modlishka result file.\n\n[![asciicast](https://asciinema.org/a/412559.svg)](https://asciinema.org/a/412559)\n\n## How does it work?\n* Run ```lateralus generate -n config.yaml```\n* Edit `config.yaml` file to match your needs\n* Pass the `config.yaml` to `lateralus run` as `lateralus run -c config.yaml`\n* Wait\n\n## Installation\n\nYou can install it with: `go get -u github.com/lateralusd/lateralus` or build it from sources by cloning the directory and running the `go build`.\n\n## Tracking server\nLateralus also supports injecting the email with tracking pixel with each mail having its own distinct uuid.\n\nFor your own tracking server, you can create the simple web server which will handle get request with `id` as url param or you can use [laserver](https://github.com/lateralusd/laserver). It also supports connecting the lateralus `json` report to see exactly who has opened mail.\n\n## Setting up\n\n### Creating template\n\nIn yaml config: `template: `\n\nThe first step is to create the email template which you will be sending to your targets. Possible fields inside template are\n\n* {{.Name}} - This will be substituted for target name from .csv file\n* {{.Email}} - This will be substituted for target email from .csv file\n* {{.URL}} - URL to include inside email\n* {{.AttackerName}} - It says it all for itself\n\nExample of template file can be found at `templates/sample.com`:\n```\nGreetings {{.Name}},\n\nMy resume is available at following url {{.URL}}\n\nBest regards,\n{{.AttackerName}}\n```\n\n### Creating targets\n\nIn yaml config: `targets:`\n\nTargets needs to be in .csv format in format _Name_,_Email_ like so:\n```\nJohn,john.doe@example.com\nAlan,alan.smith@example.com\n```\n\n### Choosing URL mode\n\nYou have two options for URLs:\n* Single - every user get's the same url link ( when the `generate: False` inside the config file)\n* Generate - every user get's different url, with the part \\\u003cCHANGE\\\u003e inside `link:` being present (when the `generate: True` inside the config file)\n\nYou also have an option to provide the length of the generated part, by default it will be 10 characters long. (Configurable via `length:` in config file).\n\n#### Example\n\nAfter we have configured our `.yaml` config file let's run it now.\n\n```bash\n$ cat config.yaml\nurl:\n  generate: True\n  link: \"https://www.google.com/?ident=\u003cCHANGE\u003e\"\n  length: 10\n  \nmail:\n  name: Attacker\n  from: Not Attacker\n  subject: Not phishing mail\n  custom: \"\"\n  \nattack:\n  targets: targets.csv\n  template: /path/to/your/template/file\n  signature: /path/to/your/signature\n  \nmailServer:\n  host: smtp.gmail.com\n  port: 587\n  username: \"someusername@gmail.com\"\n  password: \"somePassword\"\n  encryption: tls\n\ngeneral:\n  bulk: False\n  bulkDelay: 60\n  bulkSize: 3\n  delay: 5\n  separator: \",\"\n```\n\n__NOTE:__ If you don't provide template path, `templates/sample` will be used. If you want to include signature in your emails, provide the path in `signature` inside config file.\n\n\n## Example run\n\n**Template:**\n```\nGreetings {{.Name}},\n\nMy resume is available at following url {{.URL}}\n\nBest regards,\n{{.AttackerName}}\n```\n\n**Targets file**:\n```\ntest,test@gmail.com\ntest1,test@gmail.com\ntest2,test@gmail.com\n```\n\n### Running\n\n```bash\n$ lateralus run -c config.yaml\n[INFO] Starting campaign at 2021-05-07 11:40:16\n[INFO] Template not provided, using default template\n[INFO] Output not provided, will use default output (Subject_startTime)\n[INFO] Parsing config from \"config.yaml\"\n[INFO] Output filename will be \"Notphishingmail_2021-05-0711:40:16\"\n[INFO] Parsing targets from \"targets.csv\"\n[INFO] Starting to send the mails. Hope for the best\nSending mails: 2 / 3 [===============================================================================\u003e_______________________________________] 1 mail/s 66.67%\n```\n\nIf we check inbox of user test@gmail.com, we can see that email has been sent.\n\n![Mail](mailbox.png)\n\n## Config options\n\n## Why lateralus as a name\nI really love that album.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsecho%2Flateralus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnsecho%2Flateralus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnsecho%2Flateralus/lists"}