PyIris is a modular remote access trojan toolkit written in python targeting Windows and Linux systems.
The PyIris project is a modular remote access trojan toolkit written completely in python. It allows users to dynamically build, generate and encode/encrypt remote access trojan payloads for remote control of other compromised hosts.
First, clone this repository (make sure you have git installed), CD into the root folder.
git clone https://github.com/angus-y/PyIris-backdoor
cd PyIris-backdoor
Next install the rest of the required modules with pip3. Only install modules from the setup/windows/requirements.txt
file
as this section is for running the Windows edition of PyIris.
pip3 install -r setup/windows/requirements.txt
Upon running PyIris.py
in the root folder for the first time you should be greeted with the option to generate a key, this indicates everything has been installed
correctly.
First, clone this repository (make sure you have git installed), CD into the root folder.
git clone https://github.com/angus-y/PyIris-backdoor
cd PyIris-backdoor
Next install an external dependency, xlib, required by pyperclip through apt-get.
sudo apt-get install xclip
Then install pyalsaaudio through apt-get, if you're installing on ubuntu please read the below note
sudo apt-get install python3-alsaaudio
After that install canberra-gtk-module for cv2 to use to display webcam live streams
sudo apt-get install libcanberra-gtk-module
Pyautogui refuses to be imported in linux if tkinter is not installed so we must install it. However, we are not actually using tkinter for any of the scouts
sudo apt-get install python3-tk python3-dev
Finally, install the rest of the required modules with pip3. Only install modules from the setup/linux/requirements.txt
file as
this section is for running the Linux edition of PyIris.
pip3 install -r setup/linux/requirements.txt
Upon running it the first time you should be greeted with the option to generate a key, this indicates everything has been installed correctly.
Change into the PyIris-backdoor folder first, then run
git pull
On windows to install any newly added third party modules or update then run
cd setup/windows
pip3 install -r requirements.txt
On linux to install any newly added third party modules or update then run
cd setup/linux
pip3 install -r requirements.txt
py -3 PyIris.py
If prompted to generate a key, either press enter or enter a key that you want to use.
python3 PyIris.py
If prompted to generate a key, either press enter or enter a key that you want to use.
The help
command is your friend! Simply run help
to get a list of all commands you can use on a specific interface. For more
detail about a specific command, run help <name of command>
to get more in depth help about it. Alternatively you can use the
?
command which is an alias for the help command. I am planning to write a wiki soon detailing all the commands and information
you need to use PyIris
PyIris utilizes Pyinstaller to compile its payloads. It is therefore not possible to cross-compile binaries. That means if you generate and compile a scout in Linux the binary only runs in Linux, it works the same for Windows. If you want to cross-compile Windows scouts for Linux I suggest you use wine and run PyIris from there otherwise your options are very limited.
This is most probably due to a redundant library you have installed called enum34 which has already been deprecated. Uninstall the library with the command
pip uninstall -y enum34
If you get this error while compiling with pyinstalled the compiled executable will not run. See here for more information
I have already included a PyHook wheel file in the setup/windows folder however that wheel works only for 64 bit versions of Windows. You may have to manually install PyHook yourself. Go to this site and search for the PyHook wheel file that works for your Windows version and download it. Next, pip install using the name of that wheel file.
pip3 install <name of pyhook wheel file>
If you downloaded the correct pyhook wheel file it should install succesfully.
Since the listeners actually open ports on your machine you may have to allow the python 3 interpreter (python.exe) through your
firewall so that it can actually receive connections. Another reason the scouts are not connecting is that your key could have changed
the pre generated key prompted during a new PyIris install and run is used to authenticate and connect to the listeners. The scout could
have been generated with a different key than the one that the listener is expecting, the regen
command at the main home interface
would have changed the key, alternatively you may have directly edited the resources/PyIris.cred file that contains the key
Well this is due to several reasons. First, is the problem of open source code and mulitple distros. Linux has many distrubutions each linux distro may be different or have a different system structure than each other linux system. Creating components to cover all of them is incredibly difficult. Secondly, is support, simply put some linux systems just dont support some functions out of the box for python. Lastly is the fact that the terminal in linux is much more powerful than cmd in windows, therefore a lot more things can be accomplished from the terminal than from cmd so there is no need to add extra components, your trusty linux/execute_command_bash will do the job for you. For example rather than adding a linux/browser component you can use the xdg-open command to open URLs its supported out of the box
Yes it is I should probably be using HTTP buuuuut I am just lazy. Perhaps in a future update but that requires rewriting a lot of the listener-scout protocol which could take some time.
No lol
Create an issue, but before that please read the "ISSUE_TEMPLATE.md" file first
Licensed under Mozilla Public License Version 2.0 - See the "LICENSE.md" file for more details
I write stuff like this for fun and mainly to become a better at python. The purpose of this project is to challenge myself to solve problems in creative ways, teach myself to be better at coding and have some fun creating something cool in the process. I DO NOT CONDONE the usage of this project in any unethical or unlawful manner. Do not use this without the full consent of the subject. Besides this framework isnt even that good anyways.