---
title: Install witchcraft on Linux | Snap Store
description: Get the latest version of witchcraft for Linux - A versatile netrunner
  toolkit for cybersecurity.
url: https://snapcraft.io/witchcraft-cybersecurity
---

# witchcraft (witchcraft-cybersecurity)

[Casssandra Lovelace (cassandralovelace)](https://snapcraft.io/publisher/cassandralovelace "View all snaps from Casssandra Lovelace (cassandralovelace)")

* [Casssandra Lovelace (cassandralovelace)](https://snapcraft.io/publisher/cassandralovelace "View all snaps from Casssandra Lovelace (cassandralovelace)")
* [Development](https://snapcraft.io/search?categories=development)
* [Security](https://snapcraft.io/search?categories=security)

latest/stable 0.34.10

Install latest/stable of witchcraft

---

**Install using the command line**

```
sudo snap install witchcraft-cybersecurity
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

---

### Package name

* witchcraft-cybersecurity

---

### License

* LGPL-3.0

---

### Last updated

* 14 January 2025 - latest/stable
* 15 August 2025 - latest/edge

---

### Websites

* [cosmic-zip.github.io](https://cosmic-zip.github.io "https://cosmic-zip.github.io")

---

### Source code

* [github.com/cosmic-zip/witchcraft](https://github.com/cosmic-zip/witchcraft "https://github.com/cosmic-zip/witchcraft")

---

### Report a bug

* [github.com/cosmic-zip/witchcraft/issues](https://github.com/cosmic-zip/witchcraft/issues "https://github.com/cosmic-zip/witchcraft/issues")

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/witchcraft-cybersecurity#report-snap-modal)

---

* [Description](https://snapcraft.io/witchcraft-cybersecurity#tab-description)
* [Security](https://snapcraft.io/witchcraft-cybersecurity#tab-security)

#### A versatile netrunner toolkit for cybersecurity.

**NAME**
**witchcraft** - A versatile netrunner toolkit for cybersecurity.

**SYNOPSIS**
`witchcraft [MODULE_NAME] [OPTION]... [FILE]... [IP]...`

**DESCRIPTION**
WITCHCRAFT 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.

**EXAMPLES**

* `witchcraft map.local`
  Map all open local connections.
* `witchcraft search.meta --keyword user_name`
  Search for the `user_name` keyword across over 1000 sites.
* `witchcraft map.default --target example.com`
  Perform a default port scan on the specified target.

**INSTALLATION**
The project initially includes a set of default files created using advanced data analysis techniques. Final versions are merged into the main project.

* **GitHub Installation:**
  Visit [witchcraft GitHub repository](<https://github.com/cosmic-zip/witchcraft>).
  Go to releases, download the latest version, unzip the file, and locate `installer.sh` and `uninstall.sh`.

  ```bash
  sudo bash installer.sh
  ```
* **Snap Package Installation:**
  ```bash
  snap install witchcraft-cybersecurity
  ```
* **Build from Source:**
  ```bash
  git clone <https://github.com/cosmic-zip/witchcraft>
  cd witchcraft
  sudo bash build-devel.sh
  ```

  Locate the `dist` folder, unzip the file, and use `installer.sh` and `uninstall.sh`.

  The script prompts for root access, creates a `release` folder, and places built executables inside. It also provides options for downloading archives for OSINT and wordlists required for IP lookup operations.

**Spellbook Package Includes:**

* Unique Wordlists: *moth* (16GB) and *ladybug* (1GB)
* Default Credentials Database
* IP Geolocation and Reputation/Score
* Social Media Pages for Evil Twin Attacks
* General Wordlists for Directories and Subdomains
* MAC Address Vendor Database
* Usernames Wordlist
* XSS Wordlist
* And more!

**Optional Wordlists and Malware Signatures**
These files (700MB) can be downloaded using:
```bash
git clone <https://github.com/cosmic-zip/witchcraft-wordlists> /var/spellbook/
```

**EVILPAGES**
Clone pages into `/var/spellbook/evilpages` using the SingleFile extension or similar tools. Example:
```bash
witchcraft server.eviltwin --address 127.0.0.1:9000 --path foo/bar/index.html
```
[SingleFile Extension](<https://addons.mozilla.org/en-US/firefox/addon/single-file/>)

**RC FILE**
To log interactions, create `.witchrc` in your home folder and add:
```plaintext
path\_log\_file=~/my\_frog.jsonl
```
Replace `~/` with a specific path if desired.

**PLUGINS**
Witchcraft supports extensions via static files, Rust code, and `db.json`. This file allows integration of terminal-based operations. Example:

**Custom Command in Terminal:**
```bash
mycommand --flag value --key value --some foo
```

**Entry in `db.json`:**
```json
{
"name": "mycommand",
"description": "My command does something cool",
"command": "mycommand --flag @@flag --key @@some\_name\_for\_the\_key"
}
```

**Final Command in Witchcraft:**
```bash
mycommand --flag foo --some\_name\_for\_the\_key bar
```

You can assign any name to a flag. Note that flags are not positional.
Repeating a flag will not create a list of values. If a flag is repeated, only the first occurrence will be accepted. This design covers 98% of CLI interactions. Edge cases are not supported.

**LICENSE AND TERMS**
This project is licensed under the **GNU General Public License v3.0**.
WITCHCRAFT includes **IP2Proxy® LITE** and **cinsscore®** databases.

---

## Install witchcraft on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/witchcraft-cybersecurity/arch)

[### CentOS](https://snapcraft.io/install/witchcraft-cybersecurity/centos)

[### Debian](https://snapcraft.io/install/witchcraft-cybersecurity/debian)

[### elementary OS](https://snapcraft.io/install/witchcraft-cybersecurity/elementary)

[### Fedora](https://snapcraft.io/install/witchcraft-cybersecurity/fedora)

[### KDE Neon](https://snapcraft.io/install/witchcraft-cybersecurity/kde-neon)

[### Kubuntu](https://snapcraft.io/install/witchcraft-cybersecurity/kubuntu)

[### Manjaro](https://snapcraft.io/install/witchcraft-cybersecurity/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/witchcraft-cybersecurity/pop)

[### openSUSE](https://snapcraft.io/install/witchcraft-cybersecurity/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/witchcraft-cybersecurity/rhel)

[### Ubuntu](https://snapcraft.io/install/witchcraft-cybersecurity/ubuntu)

[### Raspberry Pi](https://snapcraft.io/install/witchcraft-cybersecurity/raspbian)
