Changed outlined in 0.3.21 release

Author: Al-Azif

.gitattributes

@@ -1,10 +1,9 @@
 updates/*
-!updates/ps4-updatefeature.html
 !updates/ps4-updatelist.xml
 payloads/*
 !payloads/PUT PAYLOADS HERE
 exploits/*
-!exploits/index.html
+dns.conf
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

.gitignore

@@ -5,34 +5,51 @@ PS4 Exploit Host
 This is an easy way for anyone to host their own exploit for the PS4 on their LAN. features include:
 - Hosts your choice of exploit (Specter, IDC, and XVortex included in [releases](https://github.com/Al-Azif/ps4-exploit-host/releases))
 - Sends your choice of payload after a successful exploit
-- Blocks PSN domains from resolving (Stops accidental updates)
-- Serves the 4.05 update to your PS4
+- Blocks PSN domains from resolving (Stops accidental updates and block telemetry)
+- Can serve the 4.05 update to your PS4
+- Works on just about every platform
 
-If you do not want to host the package youself set your DNS to `108.61.128.158`. This has all of the features listed above except the payload sender. The exploit can be accessed from the `User's Manual` page in your settings.
+If you do not want to host the package yourself you can use my remote DNS. See the `Using remote DNS` section below.
 
 ## Requirements
-- [Python 3](https://www.python.org/downloads/) (**Only if not using a binary release**)
-- Root Privileges (Non-Windows)
+- If you are not using a binary release you will need [Python 3](https://www.python.org/downloads/)
+- Root privileges on non-Windows machines
 
 ## How to download
 - Download the zip on the [releases](https://github.com/Al-Azif/ps4-exploit-host/releases) page
-- Download with Git, be sure to grab the submodules
+- Download with Git, be sure to grab the submodules. This does not include any exploits or payloads.
 
     `git clone --recursive https://github.com/Al-Azif/ps4-exploit-host.git`
 
-## How to run
+## Using remote DNS (Run Nothing Locally)
+0. Make sure the PS4 is on firmware 4.05 or lower (`Settings > System > System Information`).
+    - If your firmware version is >4.05 you are out of luck there is no public exploit available and you cannot downgrade.
+1. On your PS4 go to `Settings > Network > Setup Network` to setup a network. When you get to DNS Settings select `Manual` and set the Primary and Secondary DNS to `108.61.128.158`
+    - If your firmware version is <4.05 you will get a network update available. This is for 4.05.
+2. On the PS4, go to `Settings > User's Guide` and select it. The exploit selection should appear.
+    - You can also open browser and the default homepage will be the exploit selection.
+3. If you use Specter or IDC you will need to use another program to send a payload.
+
+## How to run (Run Locally)
 1. Download the files (As shown in the "How to download" section above)
-2. Double click the executable (`ps4-exploit-host.exe`, `start.py`, etc)
+2. Double click the executable (`ps4-exploit-host.exe`, `start.py`, etc). If it starts with no errors, note the IP given
     - Alteratively run it from the command line (`ps4-exploit-host.exe`, `./ps4-exploit-host`, `python start.py`, etc)
-    - If it starts with no errors, note the IP given
-4. On your PS4 `Settings > Network > Setup Network` when you get to DNS Settings select `Manual` set the IP address noted above as the Primary and Secondary DNS
-5. Make sure the PS4 is on firmware version 4.05 (`Settings > System > System Information`). If it is not use the jump to the "How to use the Updater" section before continuing
-6. On the PS4, go to `Settings > User's Guide` and select it. The exploit should run and there should be output on the script window.
-7. The script will prompt you to choose a payload to send. You may send the integrated payload or any payloads located in the `payload` folder.
-8. When done use `Ctrl+C` to cleanly close the application
-
-## How to use the updater
-0. Follow the "How to run" section for your OS until it says to come here
+    - If you are not root when running on a non-Windows machine you need to use `sudo`
+3. On your PS4 `Settings > Network > Setup Network` to setup a network. When you get to DNS Settings select `Manual` and set the Primary and Secondary DNS to the IP address you noted above.
+4. Make sure the PS4 is on firmware version 4.05 (`Settings > System > System Information`). If it is not use the jump to the "How to use the Updater" section before continuing
+    - If your firmware version is >4.05 you are out of luck there is no public exploit available and you cannot downgrade.
+5. On the PS4, go to `Settings > User's Guide` and select it. The exploit should run and there should be output on the script window.
+6. The script will prompt you to choose a payload to send. You may send the integrated payload or any payloads located in the `payload` folder.
+7. When done use `Ctrl+C` to cleanly close the application
+
+## Running on Raspberry Pi
+While the "How to run" section applies to the Pi as well there are some more complex options people may want to use for the Pi like running without any network whatsoever.
+
+- To run as a standalone device that you plug directly into your PS4 though ethernet go [here](https://gist.github.com/Al-Azif/fe2ae67a2fb06cc136580b1e923c7aac) (Supports any Pi with a ethernet port)
+- To run as a WiFi access point for your PS4 go [here](https://gist.github.com/Al-Azif/765740019c45b9a49cbf739609cadda7) (Officially supports RPi 3 currently, may work on others with WiFi adapter)
+
+## How to use the built in updater
+0. Follow the "How to run" section until it says to come here
 1. Put the system update in the `updates` folder as `PS4UPDATE_SYSTEM.PUP`
     - Optionally put the recovery update in the `updates` folder as `PS4UPDATE_RECOVERY.PUP`
 
@@ -42,47 +59,46 @@ If you do not want to host the package youself set your DNS to `108.61.128.158`.
 
 2. MAKE SURE THE DNS IS SET CORRECTLY!
 3. **SEE #2 I'M SO SERIOUS!**
-4. There should be a different page on the `System Software Update > View Details` option on the PS4. It'll be obvious!
-    - The PS4 isn't using the right DNS if you get the standard Sony changelog page. **STOP IMMEDIATELY AND RESTART THE ENTIRE PROCESS**
+4. There should be a different page on the `System Software Update > View Details` option on the PS4. It will be obvious!
+    - The PS4 is not using the right DNS if you get the standard Sony changelog page. **STOP IMMEDIATELY AND RESTART THE ENTIRE PROCESS**
 5. Run a system update on your PS4 system.
 6. Return to the "How to run" section
 
 ## Other Flags
-- Use the `--debug` flag to turn on the DNS & HTTP server output. This will make it hard to use the script normally as it'll push the payload menu off the screen
+- Use the `--debug` flag to turn on the DNS & HTTP server output. This will make it hard to use the script normally as it will push the payload menu off the screen
 - Use the `--interface` flag to specify which interface to bind to.
 
         ex. sudo python3 start.py --interface 192.168.2.12
 - Use the `--dns_only` flag to only run the DNS server (Disables HTTP server, the payload sender is also disabled as this depends on the HTTP server).
 - Use the `--http_only` flag to only run the HTTP server (Disables DNS server).
-- Use the `--daemon` flag to automatically send the integrated payload (No payload menu will be shown)
 - Use the `--autosend` flag to automatically send the like-named payload from the payloads directory (No payload menu will be shown)
 
         ex. sudo python3 start.py --autosend debug_settings.bin
 
+- Create a `dns.conf` file in the same directory as the main application to append rules to the DNS server.
+
+        ex. `A example.com 0.0.0.0` will block example.com. You can use `{{SELF}}` to specify the computer running the DNS server.
+
 ## Troubleshooting
 
 #### Script Related
 Before seeking help run though the following list:
-- Use the most recent release. Feel free to believe that the Python 2 release works better... I **won't** support it anymore.
-    - "The Python 3 release cause a kernel panic, but the Python 2 release works." **The exploit sent is the same, you just got unlucky, try again...**
-- Follow the directions exactly, don't try to get fancy then come for help
-- **If the server starts (It gives you an IP and hasn't errored out) and you can't connect from your PS4 with 99.99% certainty your firewall/anit-virus is blocking it. This accounts for nearly all of the issues users have. I'm getting real tired of me saying it's the firewall and after an hour remote troubleshooting (Which is not fun) it ends up being the firewall like I said in the first place**
-- In your command prompt run `python --version` or `python3 --version` to make sure you have Python 3 installed correctly
-- Disable other networking apps that may interfere with the script (Skype, Discord, Torrent Clients, XAMPP, Firewalls, etc)
+- Use the most recent release.
+- Follow the directions exactly, do not try to get fancy then come for help.
+- If the server starts (It gives you an IP and has not errored out) and you cannot connect from your PS4, with 99.99% certainty your firewall/anit-virus is blocking it.
+- Disable other networking apps that may interfere with the script if you get port errors (Skype, Discord, Torrent Clients, XAMPP, Firewalls, etc).
 - It is normal to get some errors (PSN & NAT) while running the network test. This proves the PSN domains are blocked correctly.
 
-
 #### Exploit/Payload Related
 These are NOT related to this script in any way, but rather the exploits/payloads themselves:
-- Make sure your PS4's firmware is on 4.05 exactly. There is no downgrading. If you are above 4.05 you're out of luck for now.
-- Sending multiple payloads doesn't always work (Exploit may not be set up for it).
-- The PS4 can get a kernel panic and just shutoff. Physically unplug the power for a second, then power it back on.
+- Make sure your PS4's firmware is on 4.05 exactly. There is no downgrading. If you are above 4.05 you are out of luck for now.
+- The PS4 can get a kernel panic and just shutoff. Physically unplug the power for a second (Or hold the power button forever), then power it back on.
 - "Out of Memory" errors while loading the exploit page are normal, restart your PS4 if you get a lot of them in a row.
-- The integrated FTP Payload takes a minute to start the FTP server. Be patient and try again in a few seconds.
-- Other FTP payloads must be compiled or hex edited with your PS4's/Computer's IP.
+- The FTP servers can take a minute to start. Be patient and try again in a 30 seconds.
+- Some FTP payloads (None of the included ones) must be compiled or hex edited with your PS4's/Computer's IP.
 - FTP payloads do not have full access under Specter's exploit.
-- You must leave the exploit page open for FTP to work.
-- IDC's exploit page doesn't completely load even when it works.
+- You must leave the exploit page open for FTP to work as it runs in the webkit process.
+- IDC's exploit page does not completely load even when it works.
 
 ## Contributing
 You can check the [issue tracker](https://github.com/Al-Azif/ps4-exploit-host/issues) for my to do list and/or bugs. Feel free to send a [pull request](https://github.com/Al-Azif/ps4-exploit-host/pulls) for whatever.
@@ -97,4 +113,4 @@ You should just be able to place the exploit files in the `exploit` directory. T
 I have no self control... it also lets people see the actual development. From barely working chicken scratch to actual code.
 
 ## Credits
-- Specter, IDC, qwertyoruiopz, Flatz, CTurt, Mistawes, XVortex, LightningMods, CelesteBlue123, Anonymous, crypt0s, etc
+- Specter, IDC, qwertyoruiopz, Flatz, CTurt, Mistawes, XVortex, LightningMods, CelesteBlue123, Anonymous, neofreno, crypt0s, etc

README.md

@@ -0,0 +1,105 @@
+<!DOCTYPE HTML>
+<html>
+<head>
+<meta charset="UTF-8">
+<title>About Exploits | PS4 Exploit Host by Al Azif</title>
+<style>
+html {
+    height: 100%;
+}
+body {
+    background-image: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR4nGP6zwAAAgcBApocMXEAAAAASUVORK5CYII=');
+    background-position: right bottom;
+    background-repeat: no-repeat;
+    background-attachment: fixed;
+    min-height: 100%;
+}
+#wrapper {
+    width: 100%;
+}
+#contentHeader {
+    padding: 20px 40px;
+    background: #003263;
+    border-top: 1px solid #6392b1;
+}
+#content {
+    width: 100%;
+}
+#contentBody {
+    padding: 40px 50px 20px;
+    color: #333;
+}
+h1 {
+    font-size: 150%;
+    color: #fff;
+}
+h2 {
+    font-size: 130%;
+    font-weight: normal;
+    border-bottom: 1px solid #003488;
+    margin-bottom: 1em;
+}
+h3 {
+    font-size: 120%;
+    margin-top: 2em;
+    padding-left: 5px;
+    border-left: 10px solid #9EC9E1;
+    margin-bottom: 1em;
+}
+.about {
+    font-size: large;
+    color: #fff;
+    text-decoration: none;
+    position: absolute;
+    right: 20px;
+    top: 80px;
+}
+ul.default {
+    list-style: disc outside;
+    margin-bottom: 1em;
+}
+ul.default li {
+    margin-left: 1.5em;
+    padding-left: 0;
+}
+</style>
+</head>
+<body>
+<div id="wrapper">
+<div id="contentWrapper">
+<div id="contentHeader">
+<div><h1>PlayStation 4 Exploit Host</h1><a href="/index.html" class="about">Back</a></div>
+</div>
+<div id="content">
+<div id="contentBody">
+<h2>About</h2>
+<h3>Specter:</h3>
+<ul class="default">
+<li>The original, listens for payloads on port 9020.</li>
+</ul>
+<h3>IDC:</h3>
+<ul class="default">
+<li>The same as Specter except it also breaks the webkit jail. Does not always look like it loads 100%.</li>
+</ul>
+<h3>XVortex HEN:</h3>
+<ul class="default">
+<li>Enables browser, blocks network updates, enables homebrew, and adds debug settings.</li>
+</ul>
+<h3>XVortex FTP:</h3>
+<ul class="default">
+<li>Starts an FTP server on port 1337. Runs in webkit process so if you close the page it stops running.</li>
+</ul>
+<h3>XVortex Dumper:</h3>
+<ul class="default">
+<li>Utility for dumping your games to a USB device.</li>
+</ul>
+<h3>Stooged Backup:</h3>
+<ul class="default">
+<li>Utility for dumping addcont.db, app.db, and gamesaves to a USB device.</li>
+</ul>
+</div>
+</div>
+</div>
+</div>
+</body>
+</html>

exploits/index.html

@@ -0,0 +1,24 @@
+<!doctype html>
+<html>
+<head>
+<meta charset="utf-8">
+<title>Error %(code)d | PS4 Exploit Host by Al Azif</title>
+<style>
+.fullscreenDiv {
+    text-align: center;
+}
+.error {
+    font-size: xx-large;
+}
+.message {
+    font-size: x-large;
+}
+</style>
+</head>
+<body>
+<div class="fullscreenDiv">
+<div class="error">Error %(code)d</div>
+<div class="message">%(explain)s</div>
+</div>
+</body>
+</html>