{"id":13907897,"url":"https://github.com/pinecone-wifi/pinecone","last_synced_at":"2025-07-18T06:31:39.044Z","repository":{"id":46887986,"uuid":"144000916","full_name":"pinecone-wifi/pinecone","owner":"pinecone-wifi","description":"A WLAN red team framework.","archived":false,"fork":false,"pushed_at":"2024-10-06T16:29:02.000Z","size":309,"stargazers_count":143,"open_issues_count":3,"forks_count":17,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-25T16:39:24.058Z","etag":null,"topics":["redteam","redteam-tools","wifi","wifi-hacking","wifi-security"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pinecone-wifi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2018-08-08T10:57:28.000Z","updated_at":"2024-11-25T14:26:53.000Z","dependencies_parsed_at":"2024-11-25T16:35:03.778Z","dependency_job_id":"c283411a-516b-4ee8-8445-befcc30cf164","html_url":"https://github.com/pinecone-wifi/pinecone","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pinecone-wifi/pinecone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-wifi%2Fpinecone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-wifi%2Fpinecone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-wifi%2Fpinecone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-wifi%2Fpinecone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pinecone-wifi","download_url":"https://codeload.github.com/pinecone-wifi/pinecone/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pinecone-wifi%2Fpinecone/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265710563,"owners_count":23815379,"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":["redteam","redteam-tools","wifi","wifi-hacking","wifi-security"],"created_at":"2024-08-06T23:02:16.885Z","updated_at":"2025-07-18T06:31:38.779Z","avatar_url":"https://github.com/pinecone-wifi.png","language":"Python","funding_links":[],"categories":["HarmonyOS","其他_安全与渗透"],"sub_categories":["Windows Manager","网络服务_其他"],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg width=500 src=\"logo_full.png?raw=true\"\u003e\n\u003c/p\u003e\n\nPinecone is a WLAN networks auditing tool, suitable for red team usage. It is extensible via modules, and it is designed to be run in Debian-based operating systems. Pinecone is specially oriented to be used with a Raspberry Pi, as a portable wireless auditing box.\n\nThis tool is designed for educational and research purposes only. Only use it with explicit permission.\n\n## Installation\nFor running Pinecone, you need a Debian-based operating system (it has been tested on Raspbian, Raspberry Pi Desktop and Kali Linux). Pinecone has the following requirements:\n* **Python 3.5+**. Your distribution probably comes with Python3 already installed, if not it can be installed using `apt-get install python3`.\n* **dnsmasq** (tested with version 2.76). Can be installed using `apt-get install dnsmasq`.\n* **hostapd-wpe** (tested with version 2.6). Can be installed using `apt-get install hostapd-wpe`. If your distribution repository does not have a hostapd-wpe package, you can either try to install it using a [Kali Linux repository pre-compiled package](https://http.kali.org/pool/main/h/hostapd-wpe), or [compile it from its source code](https://github.com/aircrack-ng/aircrack-ng/tree/master/patches/wpe/hostapd-wpe).\n\nAfter installing the necessary packages, you can install the Python packages requirements for Pinecone using `pip3 install -r requirements.txt` in the project root folder.\n\n## Usage\nFor starting Pinecone, execute `python3 pinecone.py` from within the project root folder:\n```\nroot@kali:~/pinecone# python pinecone.py \n[i] Database file: ~/pinecone/db/database.sqlite\npinecone \u003e \n```\n\nPinecone is controlled via a Metasploit-like command-line interface. You can type `help` to get the list of available commands, or `help 'command'` to get more information about a specific command:\n```\npinecone \u003e help\n\nDocumented commands (type help \u003ctopic\u003e):\n========================================\nalias  help     load  pyscript  set    shortcuts  use\nedit   history  py    quit      shell  unalias  \n\nUndocumented commands:\n======================\nback  run  stop\n\npinecone \u003e help use\nUsage: use module [-h]\n\nInteract with the specified module.\n\npositional arguments:\n  module      module ID\n\noptional arguments:\n  -h, --help  show this help message and exit\n```\n\nUse the command `use 'moduleID'` to activate a Pinecone module. You can use Tab auto-completion to see the list of current loaded modules:\n```\npinecone \u003e use \nattack/deauth     daemon/hostapd-wpe    report/db2json                  scripts/infrastructure/ap  \ndaemon/dnsmasq    discovery/recon       scripts/attack/wpa_handshake\npinecone \u003e use discovery/recon \npcn module(discovery/recon) \u003e \n```\n\nEvery module has options, that can be seen typing `help run` or `run --help` when a module is activated. Most modules have default values for their options (check them before running):\n```\npcn module(discovery/recon) \u003e help run\nusage: run [-h] [-i INTERFACE]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -i INTERFACE, --iface INTERFACE\n                        monitor mode capable WLAN interface (default: wlan0)\n```\n\nWhen a module is activated, you can use the `run [options...]` command to start its functionality. The modules provide feedback of their execution state:\n```\npcn script(attack/wpa_handshake) \u003e run -s TEST_SSID\n[i] Sending 64 deauth frames to all clients from AP 00:11:22:33:44:55 on channel 1...\n................................................................\nSent 64 packets.\n[i] Monitoring for 10 secs on channel 1 WPA handshakes between all clients and AP 00:11:22:33:44:55...\n```\n\nIf the module runs in background (for example, *scripts/infrastructure/ap*), you can stop it using the `stop` command when the module is running:\n```\npcn script(infrastructure/ap) \u003e run\nnet.ipv4.ip_forward = 1\n[i] Creating NAT rules in iptables for forwarding wlan0 -\u003e eth0...\n[i] Starting hostapd-wpe and dnsmasq...\nConfiguration file: ~/pinecone/tmp/hostapd-wpe.conf\nUsing interface wlan0 with hwaddr 00:11:22:33:44:55 and ssid \"PINECONEWIFI\"\nwlan0: interface state UNINITIALIZED-\u003eENABLED\nwlan0: AP-ENABLED \npcn script(infrastructure/ap) \u003e stop\n[i] Stopping hostapd-wpe and dnsmasq...\nnet.ipv4.ip_forward = 0\n[i] Flushing NAT table in iptables...\n```\n\nWhen you are done using a module, you can deactivate it by using the `back` command. You can also activate another module issuing the `use` command again.\n\nShell commands may be executed with the command `shell` or the `!` shortcut:\n```\npinecone \u003e !ls\nLICENSE  modules  module_template.py  pinecone  pinecone.py  README.md  requirements.txt  TODO.md\n```\n\nCurrently, Pinecone reconnaissance SQLite database is stored in the *db/* directory inside the project root folder. All the temporary files that Pinecone needs to use are stored in the *tmp/* directory also under the project root folder.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinecone-wifi%2Fpinecone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpinecone-wifi%2Fpinecone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpinecone-wifi%2Fpinecone/lists"}