{"id":13832824,"url":"https://github.com/gourcetools/spamster","last_synced_at":"2025-07-09T19:33:29.163Z","repository":{"id":70779189,"uuid":"586816671","full_name":"gourcetools/spamster","owner":"gourcetools","description":"🤖 Spam tools for NOSTR protocol  🤖 Spamster is a bash toolbox made for nostr spamming. Spamster is for testing relays and spam filters.","archived":false,"fork":false,"pushed_at":"2023-05-17T20:48:57.000Z","size":419,"stargazers_count":30,"open_issues_count":12,"forks_count":2,"subscribers_count":7,"default_branch":"main","last_synced_at":"2024-04-14T16:06:51.601Z","etag":null,"topics":["bash","bot","keygen","nip05","noscl","nostr","nostr-bot","nostr-protocol","nostr-spam","nostr-stress-test","nostr-tools","nostril","shell","spam","tor"],"latest_commit_sha":null,"homepage":"https://nostr.com","language":"Shell","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/gourcetools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":null},"created_at":"2023-01-09T09:53:10.000Z","updated_at":"2024-03-12T23:15:27.000Z","dependencies_parsed_at":null,"dependency_job_id":"491b44d2-075f-4d33-9d66-ce642495267a","html_url":"https://github.com/gourcetools/spamster","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gourcetools/spamster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gourcetools%2Fspamster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gourcetools%2Fspamster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gourcetools%2Fspamster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gourcetools%2Fspamster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gourcetools","download_url":"https://codeload.github.com/gourcetools/spamster/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gourcetools%2Fspamster/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264502490,"owners_count":23618617,"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":["bash","bot","keygen","nip05","noscl","nostr","nostr-bot","nostr-protocol","nostr-spam","nostr-stress-test","nostr-tools","nostril","shell","spam","tor"],"created_at":"2024-08-04T11:00:31.605Z","updated_at":"2025-07-09T19:33:28.823Z","avatar_url":"https://github.com/gourcetools.png","language":"Shell","funding_links":[],"categories":["Tools","Shell"],"sub_categories":["Client reviews and/or comparisons"],"readme":"# do not use to do illegal shit\n\n# \u003cb\u003eSPAMSTER\u003c/b\u003e\u003cbr\u003e\n![Shell Script](https://img.shields.io/badge/shell_script-%23121011.svg?style=for-the-badge\u0026logo=gnu-bash\u0026logoColor=white)\n#\n\u003cimg src=\"https://img.shields.io/badge/Tested%20under-Ubuntu%2022.04.1%20LTS-orange\"\u003e\u003cbr\u003e\n\u003cimg src=\"https://img.shields.io/badge/Tested%20under-W10%20Pro%20WSL%20Ubuntu%2022.04.1%20LTS-blue\"\u003e\n\u003cbr\u003e\u003cbr\u003e\n\u003cimg src=\"https://img.shields.io/badge/License-MIT-orange.svg\"\u003e\u003cbr\u003e\n\n\n# Done:\n- [x] 🧅 Use tor for spamming \n- [x] 📡 Download relays list\n- [x] 🏓 Ping relays list \n- [x] 📈 Benchmark relays\n- [x] 🔑 Create accounts for each name in config/name-list.txt \n- [x] 📁 Create a `nostr.json` with all names and pubkeys. | `NIP-05`\n- [x] 📨 Send the `nostr.json` to `youraccount.github.io/.well-known/nostr.json`\n- [x] ℹ️ Update all accounts informations with `name@domain.tld` | `KIND: 0`\n- [x] ℹ️ Update all accounts informations with username,fixed image of a cat and fixed bio. | `KIND: 0`\n- [x] 🫂 Make all accounts follow each others | `KIND: 3`\n- [x] 📢 Spam public feed in parallel | `KIND: 1`\n- [x] 🧅 Spam public feed using tor in parallel (one exit IP per instance) | `KIND: 1 `\n- [x] ⬆️  Save configuration \n- [x] ⬇️  Load configuration\n- [x] 🗑 Reset\n\n# Todo:\n\n- [ ] Use tor to get relays list\n- [ ] Use tor to ping relays list\n- [ ] Use tor to benchmark relays list\n- [ ] Use tor to broadcast profile info  | `KIND: 0`\n- [ ] Use tor to broadcast follow list  | `KIND: 3`\n- [ ] Spam in DMs\n- [ ] Spam in channels\n- [ ] Spam `custom KIND`\n- [ ] Spam public channels creation \n- [ ] Spam recommand relay \n- [ ] Multi-Spam\n- [ ] React and reply\n- [ ] Reply\n- [ ] Create random names lists with first and last name\n- [ ] Create random bio for each name with OPENAI\n- [ ] React and reply with OPENAI\n- [ ] Change benchmark for something more agressive.\n- [ ] Engagement farm with OPENAI\n\n\n\n\n# Problems:\n\n- Tor dont stop on close. So you have to stop all tors manually.\n- As far as i understand, this whole repo could be almost one script with functions, but because i'm really bad at this: its' not.\n\n\n# \u003cb\u003e🍩 What is Spamster?\u003c/b\u003e\u003cbr\u003e\n\u003cbr\u003e\n\u003cb\u003eSpamster is a bash toolbox made for nostr spamming.\u003c/b\u003e\u003cbr\u003e\nSpamster is for testing relays and spam filters.\u003cbr\u003e\n\u003cbr\u003e\n\n# \u003cb\u003e⚙️ Requirements:\u003c/b\u003e\u003cbr\u003e\n\n- `nostr-tool` : https://github.com/0xtrr/nostr-tool\n- `nostril` : https://github.com/jb55/nostril\n- `clust` : https://github.com/vinliao/clust\n- `nostcat` : https://github.com/blakejakopovic/nostcat\n\nas well as: \n`sed` `jq` `truncante` `awk` `git` `curl`\n\n\n\u003cbr\u003e\n\n# \u003cb\u003e✔️ How to use Spamster?\u003c/b\u003e\u003cbr\u003e\n\n- `git clone https://github.com/gourcetools/spamster`\n- `cd ./spamster`\n- `cd ./config`\n- Edit `message-list.txt` with your messages - one per line.\n- Edit `names-list.txt` and do the same. \n- For relay if you want to set a custom relay edit `relays-list.txt` \n- `cd ..`\n- `./SPAMSTER.sh` to open the menu. \n\n# For a quick try:\u003cbr\u003e\n- Download relay list (D) (skip this if you set a custom relay before)\n- Generate keys (K)\n- Start spamming\n\n\n\n\n \u003cimg src=\"https://user-images.githubusercontent.com/120996278/217899237-62d0bf25-8417-44c8-9730-7f452d2d7a0b.png\" alt=\"Combined\" width=\"500px\"\u003e  \u003cbr\u003e\n \u003cimg src=\"https://user-images.githubusercontent.com/120996278/217901199-305644a8-7c8f-4358-9388-614668983900.png\" alt=\"Combined\" height=\"70px\"\u003e\n \u003cimg src=\"https://user-images.githubusercontent.com/120996278/217901110-887bfb88-a1ad-4ab7-8e3c-23424afb1eb3.png\" alt=\"Combined\" height=\"70px\"\u003e \u003cbr\u003e\n \u003cimg src=\"https://user-images.githubusercontent.com/120996278/217404959-b4d81910-6f8b-404c-a0e2-f5519bdcc391.png\" alt=\"Combined\" width=\"500px\"\u003e \u003cbr\u003e \n\n\n\n\n# 🙋‍♂️ Need help? \u003cbr\u003e \n### \u003cb\u003eTelegram:\u003c/b\u003e https://t.me/bitpaint \u003cbr\u003e\n### \u003cb\u003eTwitter:\u003c/b\u003e https://twitter.com/bitpaintclub \u003cbr\u003e\n### \u003cb\u003eNostr:\u003c/b\u003e \u003cbr\u003e\n#### hex: \n``` \n0000005cc4586681ad8e7f4b75436fb7904b0e34ff072bb3406ddb90226d7eab \n``` \n#### npub: \n``` \nnpub1qqqqqhxytpngrtvw0a9h2sm0k7gykr35lurjhv6qdhdeqgnd064swghgx4 \n``` \n#### nip05: \n``` \ngourcetools@gourcetools.github.io \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgourcetools%2Fspamster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgourcetools%2Fspamster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgourcetools%2Fspamster/lists"}