Ephemeral is a free RMM using Discord and Chrome Remote Desktop API. It allows you to receive updates and control your devices from anywhere in the world using Discord. It is a fun project.
- Python 3.8+
- Discord Bot Token
- Discord Webhooks
- Google Remote Desktop
- PowerShell
- discord.py
- psutil
- requests
- Device Enrollment: Easily enroll new devices to the network using the
/enroll-device
command. - Device Listing: View all enrolled devices and their details using the
/device-list
command. - Status Check: Remotely check the status of any enrolled device with the
/check-status
command. - Guided Enrollment: Step-by-step instructions for enrolling a new device via the
/howto-enroll
command.
-
Clone the Repository:
git clone https://github.com/calinux-py/Ephemeral.git cd ephemeral; cd ephemeral
-
Install Dependencies:
pip install -r requirements.txt
-
Configure Ephemeral:
- Update
config/config.ini
with your Discord bot token and webhooks. [LiveFeed]
is the Discord webhook where your devices will actively post device information in realtime.[AgentStatus]
is the Discord webhook where agents will post device information when inquired.- LiveFeed and AgentStatus can be the same Discord webhook.
[DiscordToken]
is where you enter your Discord Bot token.
- Update
-
Run on your main device:
python ephemeral-head.py
-
Run on devices to manage:
python ephemeral-agent.py
/device-list
: Lists all devices currently enrolled in the system./enroll-device
: Enrolls a new device into the system./check-status
: Checks the status of devices./howto-enroll
: Provides detailed instructions on how to enroll a new device.
i dont care