luton1507 / mouse

Mouse Framework is an iOS and macOS post-exploitation framework that gives you a command line session with extra functionality between you and a target machine using only a simple Mouse Payload. Mouse gives you the power and convenience of uploading and downloading files, tab completion, taking pictures, location tracking, shell command execution, escalating privileges, password retrieval, and much more.

Home Page:http://entynetproject.simplesite.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Mouse Framework

mouse

mouse


About Mouse Framework

Mouse Framework is an iOS and macOS post-exploitation framework that gives you 
a command line session with extra functionality between you and a target machine 
using only a simple Mouse Payload. Mouse gives you the power and convenience of 
uploading and downloading files, tab completion, taking pictures, location tracking, 
shell command execution, escalating privileges, password retrieval, and much more.

Getting started

Mouse installation

cd mouse

chmod +x install.sh

./install.sh

Mouse uninstallation

cd mouse

chmod +x uninstall.sh

./uninstall.sh


Mouse Framework execution

To execute Mouse Framework you 
should execute the following command.

mouse


Why Mouse Framework

  • A lot of different payloads.
There are a lot of different payloads in Mouse Framework 
such as Bourne-Again Shell and Rubber Duck payloads.
  • Accessing device shell.
Mouse Framework can be used to remotely 
access iOS/macOS device shell.
  • A lot of different functions.
There are a lot of different functions in Mouse 
CLI such as displaying alerts, recording mic sound 
and taking pictures on remote iOS/macOS device.

Mouse Payloads (macOS/iOS)

payloads

Mouse Payloads are intended to 
get remote target machine session.

Bourne-Again Shell payload

Selecting Bourne-Again Shell payload from the payload 
menu will give us a 1 liner that establishes a remote 
Mouse session upon execution on the target machine.

Platform: iOS/macOS

Teensy macOS payload (USB injection)

Teensy is a development USB board that can be programmed 
with the Arduino IDE. It emulates usb keyboard strokes extremely 
fast and can inject the Mouse payload just in a few seconds!

Platform: macOS

Rubber Duck payload (USB injection)

USB Rubber Duck is a development USB board that can inject 
uploaded to duck SD card inject.bin payload in a few seconds!

Platform: macOS

Application macOS payload

Selecting Application macOS from the payload menu will give you
standart Mouse payload that converted to the macOS application.

Platform: macOS

MultiHandler CLI

multihandler

The MultiHandler option lets us handler multiple sessions. 
You can choose to interact with different devices while 
listening for new connections in the background.

MultiHandler commands

close          : Close active session.
exit           : Close all sessions and exit.
help           : Show all available commands.
interact       : Interact with a session. 
sessions       : List active sessions.

Mouse Substrate

Mouse Substrate is a package that can be installed 
on the target iOS device after receiving remote control 
to run substrate commands and services.

Substrate commands

dhome          : Simulate a double home button press.
home           : Simulate a home button press.
locat          : Toggle location services.
mute           : Update and view mute status.

Mouse CLI

help

After a session is established, we can execute commands on that device through 
the Mouse CLI. We can show all available commands by typing "help". Mouse CLI 
allows you to control a remote device. Remote device can be controlled by Mouse
CLI commands. You can explore list of available Mouse CLI commands bellow.

Local commands

exec

clear          : Clear terminal window.
help           : Show all available commands.
exec           : Execute local shell commands.
exit           : Close current session and exit.

Settings commands

setvol

macOS

getpaste       : Get pasteboard contents.
getvol         : Get speaker output volume.
idletime       : Get the amount of user activity time.
setbright      : Set screen brightness.
setvol         : Set output volume.

iOS

battery        : Get battery level.
getvol         : Get volume level.
msub           : Mouse Substrate.
setvol         : Set output volume.
sysinfo        : Show system information.

Trolling commands

alert

macOS

alert          : Make alert show up on device.
chwall         : Change desktop wallpaper.
close          : Close application.
imessage       : Send message through the messages app.
itunes         : Control iTunes player.
keyboard       : Control keyboard.
open           : Open application.
say            : Convert text to speach.

iOS

alert          : Make alert show up on device.
dial           : Dial a phone number.
ipod           : Control music player.
kill           : Terminate or signal a process.
killall        : Kill process by name.
lastapp        : Open last opened application.
open           : Open application.
openurl        : Open URL on device.
say            : Convert text to speach.
vibrate        : Vibrate device.

Stealing commands

screenshot

macOS

download       : Download remote file.
getfacebook    : Retrieve facebook session cookies.
mic            : Record mic sound.
picture        : Take picture through iSight.
prompt         : Prompt user to type password.
screenshot     : Take screenshot.

iOS

download       : Download remote file.
getcontacts    : Download addressbook.
getnotes       : Download notes.
getpasscode    : Retreive the device passcode.
getsms         : Download SMS data.
locate         : Get device location coordinates.
mic            : Record mic sound.
picture        : Take picture through the camera.

Boot commands

macOS

reboot         : Reboot device.
sleep          : Put device into sleep mode.
suspend        : Suspend current session.

iOS

reboot         : Reboot device.
respring       : Restart SpringBoard.
safemode       : Put device into SafeMode.

Other commands

shell

macOS

icons          : List system alert icons.
pid            : Get Mouse process ID.
shell          : Open target device shell.
su             : Login as root.
upload         : Upload local file.

iOS

bundleids      : List bundle identifiers.
islocked       : Check if the device is locked.
pid            : Get Mouse process ID.
shell          : Open target device shell.
upload         : Upload local file.

Mouse Framework disclaimer

Usage of the Mouse Framework for attacking targets without prior mutual consent is illegal. 
It is the end user's responsibility to obey all applicable local, state, federal, and international laws. 
Developers assume no liability and are not responsible for any misuse or damage caused by this program.

Mouse Framework license

    ---------------------------------------------------
                      Mouse Framework                            
    ---------------------------------------------------
        Copyright (C) <2019-2020>  <Entynetproject>      

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.                

About

Mouse Framework is an iOS and macOS post-exploitation framework that gives you a command line session with extra functionality between you and a target machine using only a simple Mouse Payload. Mouse gives you the power and convenience of uploading and downloading files, tab completion, taking pictures, location tracking, shell command execution, escalating privileges, password retrieval, and much more.

http://entynetproject.simplesite.com/

License:GNU General Public License v3.0


Languages

Language:Python 50.5%Language:Objective-C 30.1%Language:C 10.2%Language:Shell 4.0%Language:Objective-C++ 3.0%Language:Logos 2.2%