{"id":25456423,"url":"https://github.com/cosmic-zip/witchcraft","last_synced_at":"2025-11-02T10:30:25.583Z","repository":{"id":243579116,"uuid":"284146517","full_name":"cosmic-zip/witchcraft","owner":"cosmic-zip","description":"WITCH_CRAFT is a task automation tool for cybersecurity. It handles forensic research, OSINT, scanning, backups, data copying, and penetration testing for apps and APIs, serving as a flexible platform for diverse security tasks.","archived":false,"fork":false,"pushed_at":"2024-11-18T17:00:19.000Z","size":871640,"stargazers_count":13,"open_issues_count":2,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-18T17:13:19.993Z","etag":null,"topics":["bluetooth","cybersecurity","hacking","hacking-tool","linux","pentesting","pentetsing","reverse-engineering","rust","web-hacking","wireless","wireless-hacking","witch-craft"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cosmic-zip.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-31T23:12:51.000Z","updated_at":"2024-11-18T15:47:44.000Z","dependencies_parsed_at":"2024-11-18T17:24:22.063Z","dependency_job_id":null,"html_url":"https://github.com/cosmic-zip/witchcraft","commit_stats":null,"previous_names":["prism-zip/witch_craft","cosmic-zip/witch_craft","th3maid/zynix-fusion","cosmic-zip/witchcraft"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosmic-zip%2Fwitchcraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosmic-zip%2Fwitchcraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosmic-zip%2Fwitchcraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cosmic-zip%2Fwitchcraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cosmic-zip","download_url":"https://codeload.github.com/cosmic-zip/witchcraft/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239394694,"owners_count":19631117,"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":["bluetooth","cybersecurity","hacking","hacking-tool","linux","pentesting","pentetsing","reverse-engineering","rust","web-hacking","wireless","wireless-hacking","witch-craft"],"created_at":"2025-02-18T01:38:27.796Z","updated_at":"2025-11-02T10:30:25.546Z","avatar_url":"https://github.com/cosmic-zip.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"![banner](docs/documentation/media_kit/splited.png)\n\n![banner](docs/documentation/images/lineBar.png)\n\n[![witchcraft-cybersecurity](https://snapcraft.io/witchcraft-cybersecurity/badge.svg)](https://snapcraft.io/witchcraft-cybersecurity)\n![witchcraft](https://img.shields.io/github/actions/workflow/status/cosmic-zip/witchcraft/witchcraft.yml)\n![GitHub issues](https://img.shields.io/github/issues/cosmic-zip/witchcraft)\n![GitHub License](https://img.shields.io/github/license/cosmic-zip/witchcraft)\n![GitHub top language](https://img.shields.io/github/languages/top/cosmic-zip/witchcraft)\n\n\u003cp align=\"center\"\u003e\n  🎉 Your OPSEC companion. Run witchcraft help or witchcraft manual (for the complete manual) 🎉\n\u003c/p\u003e\n\n---\n\n# NAME\n\n**witchcraft** - A versatile toolkit for cybersecurity.\n\n# SYNOPSIS\n\n`witchcraft [MODULE_NAME] [OPTION]... [FILE]... [IP]...`\n\n# DESCRIPTION\n\nWITCHCRAFT is a powerful cybersecurity toolkit providing tools for forensic analysis, OSINT, scanning, backups, data copying, and penetration testing for applications and APIs. Its flexibility makes it suitable for a wide range of security tasks.\n\n# EXAMPLES\n\n- `witchcraft map.local`\n  Map all open local connections.\n\n- `witchcraft search.meta --keyword user_name`\n  Search for the `user_name` keyword across over 1000 sites.\n\n- `witchcraft map.default --target example.com`\n  Perform a default port scan on the specified target.\n\n# INSTALLATION\n\nThe project initially includes a set of default files created using advanced data analysis techniques. Final versions are merged into the main project.\n\n- **GitHub Installation:**\n  Visit [witchcraft GitHub repository](https://github.com/cosmic-zip/witchcraft).\n  Go to releases, download the latest version, unzip the file, and locate `installer.sh` and `uninstall.sh`.\n\n    ```bash\n    sudo bash installer.sh\n    ```\n\n- **Snap Package Installation:**\n\n    ```bash\n    snap install witchcraft-cybersecurity\n    ```\n\n- **Build from Source:**\n\n    ```bash\n    git clone https://github.com/cosmic-zip/witchcraft\n    cd witchcraft\n    sudo bash build-devel.sh\n    ```\n\n    Locate the `dist` folder, unzip the file, and use `installer.sh` and `uninstall.sh`.\n\n    The script prompts for root access, creates a `release` folder, and places built executable inside. It also provides options for downloading archives for OSINT and wordlists required for IP lookup operations.\n\n## Spellbook Package Includes:\n\n- Unique Wordlists: _moth_ (16GB) and _ladybug_ (1GB)\n- Default Credentials Database\n- IP Geolocation and Reputation/Score\n- Social Media Pages for Evil Twin Attacks\n- General Wordlists for Directories and Subdomains\n- MAC Address Vendor Database\n- Usernames Wordlist\n- XSS Wordlist\n- And more!\n\n### Optional Wordlists and Malware Signatures\n\nThese files (700MB) can be downloaded using:\n\n```bash\ngit clone https://github.com/cosmic-zip/witchcraft-wordlists /var/spellbook/\n```\n\n# EVILPAGES\n\nClone pages into `/var/spellbook/evilpages` using the SingleFile extension or similar tools. Example:\n\n```bash\nwitchcraft server.eviltwin --address 127.0.0.1:9000 --path foo/bar/index.html\n```\n\n[SingleFile Extension](https://addons.mozilla.org/en-US/firefox/addon/single-file/)\n\n# RC FILE\n\nTo log interactions, create `.witchrc` in your home folder and add:\n\n```plaintext\npath_log_file=~/my_frog.jsonl\n```\n\nReplace `~/` with a specific path if desired.\n\n# FLAGS SCLF\n\nStandard Command-Line Flags (SCLF) include:\n\n- `account` : Arguments for account info or token.\n- `address` : IPv4/IPv6 or domain name.\n- `ip` : IPv4/IPv6 address.\n- `device` : Virtual/physical device (e.g., HDD, SSD).\n- `dns/domain` : Domain name.\n- `database_name` : Name of the database.\n- `data` : Input data (e.g., \"some data here!\").\n- `file` : File location.\n- `folder` : Path to a folder.\n- `host` : Hostname or IP address.\n- `image` : Image file location.\n- `interface` : Network device.\n- `keyspace_name` : Cassandra keyspace name.\n- `message` : Message string.\n- `output` : Output file path.\n- `overwrite` : Overwrite existing files.\n- `password` : Plaintext password.\n- `path` : File path.\n- `port` : Port number.\n- `protocol` : Communication protocol.\n- `recursive` : Enable recursive mode.\n- `secret` : File (data) to be hidden.\n- `share` : Shared resource (e.g., folder, file, printer).\n- `snapshot_name` : Name of the snapshot.\n- `table_name` : Database table name.\n- `target` : IPv4/IPv6 or domain name.\n- `timeout` : Timeout duration.\n- `url` : Full URL path with http/https.\n- `username` : Username setup.\n- `wait` : Delay duration in seconds.\n- `verbose` : Enable verbose mode.\n- `wordlist` : Path to a wordlist.\n\n# PLUGINS\n\nWitchcraft supports extensions via static files, Rust code, and `db.json`. This file allows integration of terminal-based operations. Example:\n\n**Custom Command in Terminal:**\n\n```bash\nmycommand --flag value --key value --some foo\n```\n\n**Entry in `db.json`:**\n\n```json\n{\n    \"name\": \"mycommand\",\n    \"description\": \"My command does something cool\",\n    \"command\": \"mycommand --flag @@flag --key @@some_name_for_the_key\"\n}\n```\n\n**Final Command in Witchcraft:**\n\n```bash\nmycommand --flag foo --some_name_for_the_key bar\n```\n\nYou can assign any name to a flag. Note that flags are not positional.\nRepeating a flag will not create a list of values. If a flag is repeated,\nonly the first occurrence will be accepted. This design covers 98% of CLI\ninteractions. Edge cases are not supported.\n\n# LICENSE AND TERMS\n\nThis project is licensed under the **GNU General Public License v3.0**.\nWITCHCRAFT includes **IP2Proxy® LITE** and **cinsscore®** databases.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmic-zip%2Fwitchcraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcosmic-zip%2Fwitchcraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcosmic-zip%2Fwitchcraft/lists"}