{"id":20292497,"url":"https://github.com/mauricelambert/spyware","last_synced_at":"2025-07-23T12:08:37.191Z","repository":{"id":52485390,"uuid":"348318192","full_name":"mauricelambert/SpyWare","owner":"mauricelambert","description":"This package implements a complete SpyWare.","archived":false,"fork":false,"pushed_at":"2024-11-18T17:18:02.000Z","size":1024,"stargazers_count":113,"open_issues_count":2,"forks_count":25,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-05-18T22:09:02.145Z","etag":null,"topics":["clipboard","connections","keylogger","metadata-extraction","pypi-packages","python3","recorder","screenshots","spyware","webcam-capture"],"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/mauricelambert.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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":"2021-03-16T11:16:33.000Z","updated_at":"2025-05-04T22:01:40.000Z","dependencies_parsed_at":"2024-12-24T07:11:00.011Z","dependency_job_id":"719b07b8-a083-4a55-9329-c7b59315b101","html_url":"https://github.com/mauricelambert/SpyWare","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"01706087b42846976f2da0c85bba5509ac862883"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mauricelambert/SpyWare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauricelambert%2FSpyWare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauricelambert%2FSpyWare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauricelambert%2FSpyWare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauricelambert%2FSpyWare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mauricelambert","download_url":"https://codeload.github.com/mauricelambert/SpyWare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mauricelambert%2FSpyWare/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266673581,"owners_count":23966376,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["clipboard","connections","keylogger","metadata-extraction","pypi-packages","python3","recorder","screenshots","spyware","webcam-capture"],"created_at":"2024-11-14T15:17:34.286Z","updated_at":"2025-07-23T12:08:37.161Z","avatar_url":"https://github.com/mauricelambert.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![SpyWare logo](https://mauricelambert.github.io/info/python/security/SpyWare_small.png \"SpyWare logo\")\r\n\r\n# SpyWare\r\n\r\n## Description\r\n\r\nThis package implements a complete spyware.\r\n\r\nFeatures:\r\n\r\n - KeyLogger\r\n - ClipboardLogger\r\n - Domains/IP logger\r\n - Webcam spy\r\n - Screen spy\r\n - Files logger\r\n - Recorder\r\n\r\n## Requirements\r\n\r\nThis package require:\r\n\r\n - python3\r\n - python3 Standard Library\r\n - pyautogui\r\n - opencv-python\r\n - pillow\r\n - pyperclip\r\n - pynput\r\n - pyaudio\r\n\r\n## Installation\r\n\r\n```bash\r\npip install SpyWare\r\n```\r\n\r\n## Usages\r\n\r\n### Command line\r\n\r\n```bash\r\nSpyWare                             # Run all modules\r\nSpyWare runonly -s                  # Run only screen module\r\nSpyWare runonly --screen --key      # Run only screen module and keylogger\r\nSpyWare runonly --key my.conf       # Run only module key with custom configuration file\r\nSpyWare --install                   # Install spyware in random destination, enable it and run all modules\r\nSpyWare --enable                    # Enable the SpyWare (start on reboot)\r\nSpyWare --env \"keySpy.conf=my.conf\" # Add an environment variable (this defined the name of the custom configuration file for the keylogger)\r\nSpyWare donotrun --domains --webcam # Run all modules except domains and webcam\r\n\r\n# Following arguments are executed on python exit\r\n# To stop the spyware you should raise a KeyboardInterrupt (Ctrl-C in the terminal)\r\n# Is not working on OS shutdown or process kill\r\nSpyWare --remove                    # Remove all files generated by the SpyWare and the SpyWare (the executable file only)\r\nSpyWare --tar                       # Add data generated by the SpyWare in a .tar archive\r\nSpyWare --tar \"gz\"                  # Add data generated by the SpyWare in a .tar.gz archive (compressed)\r\n```\r\n\r\n### Python executables\r\n\r\n```bash\r\npython3 WebcamLogger.pyz                  # Execute the webcam module\r\npython3 WebcamLogger.pyz my.conf          # Execute the webcam module with custom configuration file\r\n# OR\r\nchmod u+x AudioLogger.pyz                 # Add execution permission\r\n./AudioLogger.pyz my.conf                 # Execute the audio (recorder) module\r\n\r\npython3 SpyWare.pyz runonly --files       # Run only the files modules\r\n# OR\r\nchmod u+x SpyWare.pyz                     # Add execution permission\r\n./SpyWare.pyz donotrun --clipboard --key  # Run all modules except clipboard module and keylogger\r\n```\r\n\r\n### Python module\r\n\r\n```bash\r\npython3 -m SpyWare                             # Run all modules\r\npython3 -m SpyWare.AudioLogger                 # Run only one module\r\npython3 -m SpyWare.WebcamLogger my.conf        # Run only one module with custom configuration file\r\npython3 -m SpyWare.FilesLogger.FilesLogger     # Run only one module\r\npython3 -m SpyWare.KeyLogger.KeyLogger my.conf # Run only one module with custom configuration file\r\n```\r\n\r\n### Python script\r\n\r\n```python\r\nfrom SpyWare import spyware\r\nspyware()                    # Run all modules\r\n```\r\n\r\n```python\r\nfrom SpyWare import AudioLogger\r\nfrom SpyWare.KeyLogger import keySpy\r\nAudioLogger.audioSpy()       # Run audio (recorder) module\r\nkeySpy(filename=\"my.conf\")   # Run keylogger with custom configuration file\r\n```\r\n\r\nThere are three way to change the configuration filename:\r\n 1. Using the *filename* argument of the *configuration loader* function\r\n 2. Using environment variables (in python: `os.environ`). The name of the environment variable is the filename of the default configuration file.\r\n 3. Using command line arguments\r\n\r\nExamples available in HTML documentation of modules.\r\n\r\n```python\r\nfrom SpyWare.FilesLogger import Daemon, filesConfig\r\nfilesConfig(\"my.conf\")       # Load configuration\r\nDaemon().run_for_ever()      # Start the daemon thread of \"files\" module\r\n```\r\n\r\n```python\r\nfrom SpyWare.ClipboardLogger import Daemon, copyConfig\r\n\r\nfrom os import environ\r\nenviron[\"clipboardSpy.conf\"] = \"my.conf\" # Change the environment variable\r\n\r\ncopyConfig()                             # Load configuration\r\n\r\ndaemon = Daemon()\r\ndaemon.run_for_ever()                    # Start the daemon thread of clipboard module\r\n```\r\n\r\n```python\r\nfrom SpyWare.ScreenLogger import Daemon, screenConfig\r\n\r\nscreenConfig(argv=[\"_\", \"my.conf\"])      # Use custom argv to load configuration\r\n\r\ndaemon = Daemon()\r\ndaemon.run_for_ever()                    # Start the daemon thread of screen module\r\n```\r\n\r\n## Default configurations\r\n\r\n### Clipboard\r\n\r\n```ini\r\n[SAVE]\r\nfilename = clipboard.txt\r\n\r\n[TIME]\r\ncheck_internval = 11\r\n```\r\n\r\n### Recorder\r\n\r\n```ini\r\n[SAVE]\r\nfilename = record*.wav\r\ndirname = records\r\n\r\n[TIME]\r\ninterval = 3590\r\nrecord_time = 10\r\n```\r\n\r\n### Domains\r\n\r\n```ini\r\n[SAVE]\r\nfilename = domains.txt\r\n\r\n[TIME]\r\ninterval_dns = 60\r\ninterval_appdata = 86400\r\ninterval_reading_file = 0.5\r\ninterval_domain = 0.05\r\n```\r\n\r\n### Fileslogger\r\n\r\n```ini\r\n[SAVE]\r\nfilename = files.csv\r\n\r\n[TIME]\r\nfile_interval = 0.1\r\ndirectory_interval = 1\r\nscan_interval = 86400\r\n```\r\n\r\n### Keylogger\r\n\r\n```ini\r\n[SAVE]\r\nfilename = keySpy.txt\r\nevent_press = 0\r\nevent_release = 0\r\nhot_keys = 1\r\nevent_time = 1\r\n\r\n[TIME]\r\n```\r\n\r\n### Screenshot\r\n\r\n```ini\r\n[SAVE]\r\nfilename = screenshot*.png\r\ndirname = screenshots\r\n\r\n[TIME]\r\nscreenshot_interval = 3600\r\n```\r\n\r\n### Webcam\r\n\r\n```ini\r\n[SAVE]\r\nfilename = webcam*.png\r\ndirname = pictures\r\n\r\n[TIME]\r\npicture_interval = 3600\r\n```\r\n\r\n## Helps\r\n\r\n```text\r\n~# SpyWare --help\r\n\r\nSpyWare  Copyright (C) 2021, 2022  Maurice Lambert\r\nThis program comes with ABSOLUTELY NO WARRANTY.\r\nThis is free software, and you are welcome to redistribute it\r\nunder certain conditions.\r\n\r\nusage: SpyWare.pyz [-h] [--env [ENV ...]] [--install] [--enable] [--remove] [--tar [{bz2,xz,gz}]] {runonly,donotrun} ...\r\n\r\nThis file implements a complete spyware.\r\n\r\npositional arguments:\r\n  {runonly,donotrun}    Modules selection type.\r\n    runonly             Run only specified modules.\r\n    donotrun            Do not run specified modules.\r\n\r\noptional arguments:\r\n  -h, --help            show this help message and exit\r\n  --env [ENV ...], -e [ENV ...]\r\n                        Add environment variable, values should be formatted as \u003ckey\u003e=\u003cvalue\u003e\r\n  --install, -i         Install the spyware in APPDATA and enabled it (launch on startup)\r\n  --enable, -E          Enable the spyware (launch it on startup)\r\n  --remove, -r          Remove spyware trace (executable/script, links and data)\r\n  --tar [{bz2,xz,gz}], -t [{bz2,xz,gz}]\r\n                        Build a tar file with data, optional value should be 'gz', 'xz', 'bz2' to compress.\r\n```\r\n\r\n```text\r\n~# SpyWare --help\r\n\r\nSpyWare  Copyright (C) 2021, 2022  Maurice Lambert\r\nThis program comes with ABSOLUTELY NO WARRANTY.\r\nThis is free software, and you are welcome to redistribute it\r\nunder certain conditions.\r\n\r\nusage: SpyWare.pyz runonly [-h] [--audio [AUDIO]] [--clipboard [CLIPBOARD]] [--domains [DOMAINS]] [--files [FILES]] [--key [KEY]] [--screen [SCREEN]] [--webcam [WEBCAM]]\r\n\r\noptional arguments:\r\n  -h, --help            show this help message and exit\r\n\r\nmodules:\r\n  SpyWare modules to launch in this process.\r\n\r\n  --audio [AUDIO], -a [AUDIO]\r\n                        Run module audio with optional value as configuration file (default=audioSpy.conf).\r\n  --clipboard [CLIPBOARD], -c [CLIPBOARD]\r\n                        Run module clipboard with optional value as configuration file (default=clipboardSpy.conf).\r\n  --domains [DOMAINS], -d [DOMAINS]\r\n                        Run module domains with optional value as configuration file (default=domainsSpy.conf).\r\n  --files [FILES], -f [FILES]\r\n                        Run module files with optional value as configuration file (default=filesSpy.conf).\r\n  --key [KEY], -k [KEY]\r\n                        Run module key with optional value as configuration file (default=keySpy.conf).\r\n  --screen [SCREEN], -s [SCREEN]\r\n                        Run module screen with optional value as configuration file (default=screenSpy.conf).\r\n  --webcam [WEBCAM], -w [WEBCAM]\r\n                        Run module webcam with optional value as configuration file (default=webcamSpy.conf).\r\n```\r\n\r\n```text\r\n~# SpyWare --help\r\n\r\nSpyWare  Copyright (C) 2021, 2022  Maurice Lambert\r\nThis program comes with ABSOLUTELY NO WARRANTY.\r\nThis is free software, and you are welcome to redistribute it\r\nunder certain conditions.\r\n\r\nusage: SpyWare.pyz donotrun [-h] [--audio] [--clipboard] [--domains] [--files] [--key] [--screen] [--webcam]\r\n\r\noptional arguments:\r\n  -h, --help       show this help message and exit\r\n\r\nmodules:\r\n  SpyWare modules to not launch in this process.\r\n\r\n  --audio, -a      Do not run module audio.\r\n  --clipboard, -c  Do not run module clipboard.\r\n  --domains, -d    Do not run module domains.\r\n  --files, -f      Do not run module files.\r\n  --key, -k        Do not run module key.\r\n  --screen, -s     Do not run module screen.\r\n  --webcam, -w     Do not run module webcam.\r\n```\r\n\r\n## Links\r\n\r\n - [Github Page](https://github.com/mauricelambert/SpyWare)\r\n - [Windows Executable (one file)](https://github.com/mauricelambert/SpyWare/releases/download/v1.0.0/SpyWare.exe)\r\n - [Windows Executable](https://github.com/mauricelambert/SpyWare/releases/download/v1.0.0/SpyWare.zip)\r\n - [Documentation](https://mauricelambert.github.io/info/python/security/SpyWare/SpyWare.html)\r\n - [Documentation Clipboard](https://mauricelambert.github.io/info/python/security/SpyWare/ClipboardLogger.html)\r\n - [Documentation Screenshot](https://mauricelambert.github.io/info/python/security/SpyWare/ScreenLogger.html)\r\n - [Documentation Domains](https://mauricelambert.github.io/info/python/security/SpyWare/DomainsLogger.html)\r\n - [Documentation Recorder](https://mauricelambert.github.io/info/python/security/SpyWare/AudioLogger.html)\r\n - [Documentation Keylogger](https://mauricelambert.github.io/info/python/security/SpyWare/KeyLogger.html)\r\n - [Documentation Webcam](https://mauricelambert.github.io/info/python/security/SpyWare/WebcamLogger.html)\r\n - [Documentation Files](https://mauricelambert.github.io/info/python/security/SpyWare/FilesLogger.html)\r\n - [Download as python executable](https://mauricelambert.github.io/info/python/security/SpyWare.pyz)\r\n - [Download Clipboard as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/ClipboardLogger.pyz)\r\n - [Download Screenshot as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/ScreenLogger.pyz)\r\n - [Download Domains as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/DomainsLogger.pyz)\r\n - [Download Recorder as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/AudioLogger.pyz)\r\n - [Download Keylogger as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/KeyLogger.pyz)\r\n - [Download Webcam as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/WebcamLogger.pyz)\r\n - [Download Files as python executable](https://mauricelambert.github.io/info/python/security/SpyWare/FilesLogger.pyz)\r\n - [Pypi package](https://pypi.org/project/SpyWare/)\r\n\r\n## Licence\r\n\r\nLicensed under the [GPL, version 3](https://www.gnu.org/licenses/).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauricelambert%2Fspyware","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmauricelambert%2Fspyware","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmauricelambert%2Fspyware/lists"}