Skip to content

Commit 2bcf4ee

Browse files
Add files via upload
1 parent 788d901 commit 2bcf4ee

File tree

6 files changed

+1384
-37
lines changed

6 files changed

+1384
-37
lines changed

README.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,10 @@ Some uses of a keylogger are:
1616
- Global event hook on all (incl. On-Screen) keyboards using cross-platform library [Keyboard](https://github.com/boppreh/keyboard). The program makes no attempt to hide itself.
1717
- Pure Python, no C modules to be compiled.
1818
- 2 logging modes:
19-
- Storing logs locally and once a day sending logs to your onion hidden service (via Tor, of course, stealthily installing it);
19+
- Storing logs locally and (optionally) sending logs to your onion hidden service via Tor (Tor auto-install optional; disabled by default).
2020
- Debug mode (printing to console).
21-
- Persistence:
22-
- Adding to Windows Startup.
21+
- Persistence (opt-in):
22+
- Adding to Windows Startup only when the 'persist' flag is provided.
2323
- Human-readable logs:
2424
- Logging keys as they actually are in your layout; cyrillic keyboard layout is fully implemented;
2525
- Logging window titles and current time where appropriate;
@@ -31,34 +31,36 @@ Some uses of a keylogger are:
3131
### Getting started
3232

3333
#### System requirements
34-
- MS Windows (tested on 10). TODO: test Linux (requires sudo) and macOS support;
35-
- [Python 3](https://www.python.org/downloads/) (tested on v. 3.7.4).
34+
- MS Windows 10/11. Linux/macOS are not supported.
35+
- [Python 3](https://www.python.org/downloads/) (tested on v. 3.13).
3636

3737
#### Usage
3838

3939
##### **Quick start**
4040
1. `git clone https://github.com/secureyourself7/python-keylogger`
4141
2. `cd python-keylogger`
42-
3. Customize parameters in Start.py: url_server_upload, hidden_service_check_connection.
42+
3. Customize parameters in start.py: url_server_upload, hidden_service_check_connection.
4343
###### **Run as a Python script**
44-
3. `pip install requirements.txt` (alternatively `python -m pip ...`)
45-
4. `python Start.py`
44+
3. `pip install -r requirements.txt` (alternatively `python -m pip ...`)
45+
4. `python start.py`
4646
###### **Run as an executable (7 MB)**
4747
3. `pip install pyinstaller`
48-
4. `pyinstaller --onefile --noconsole --icon=icon.ico Start.py`
49-
5. `dist\Start.exe`
48+
4. `pyinstaller --onefile --noconsole --icon=icon.ico start.py`
49+
5. `dist\start.exe`
5050
###### **To use RSA log encryption/decryption (optional)**
5151
1. Generate RSA key pair (optional): `python rsa_key_generator.py`.
52-
1. Change the public key filename / paste the key in Start.py.
52+
1. Change the public key filename / paste the key in start.py.
5353
1. To decrypt logs type `python log_decryptor.py`, and then follow the instructions given by the script.
5454

5555
##### System arguments
56-
`Start.py mode [encrypt]`
56+
`start.py mode [encrypt] [persist] [--allow-tor-install]`
5757
- **modes**:
5858
- **local:** store the logs in a local txt file. Filename is a MD5 hash of the current date (YYYY-Mon-DD).
5959
- **debug:** write to the console.
6060
- **[optional]**
61-
- **encrypt:** enable the encryption of logs with a public key provided in Start.py.
61+
- **encrypt:** enable the encryption of logs with a public key provided in start.py.
62+
- **persist:** add to Windows Startup (Windows only).
63+
- **--allow-tor-install:** allow Tor Browser auto-install (Windows only). Disabled by default.
6264

6365
### Video tutorials (similar but simpler projects)
6466
https://www.youtube.com/watch?v=uODkiVbuR-g
@@ -75,6 +77,4 @@ Cyrillic layout is implemented, meaning support for these languages: Russian, Ru
7577

7678
Please note that this repo is for educational purposes only. No contributors, major or minor, are responsible for any actions made by the software.
7779

78-
Don't really understand licenses or tl;dr? Check out the [MIT license summary](https://tldrlegal.com/license/mit-license).
79-
8080
Distributed under the MIT license. See [LICENSE](https://github.com/secureyourself7/python-keylogger/blob/master/LICENSE) for more information.

log_decryptor.py

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
# -*- coding: utf-8 -*-
33

44
import os # for handling paths
5-
import sys # for getting sys.argv and reading multiple line user input
65
import time
76
import tkinter as tk
87
from tkinter.filedialog import askopenfilename

0 commit comments

Comments
 (0)